🍏 apple-wap-locator

Query approximate geolocation of Wi-Fi BSSIDs using Apple’s WPS API.

This tool uses Apple’s Wi-Fi Positioning System (WPS) to locate BSSIDs (MAC addresses of Wi-Fi access points) and return their latitude and longitude.

📦 Installation

Globally:

npm install -g apple-wap-locator

Or as a local dependency:

npm install apple-wap-locator

🧭 Usage

CLI

Once installed globally, you can query a BSSID directly from the command line:

apple-wap-locator <BSSID>

Example:

apple-wap-locator 00:11:22:33:44:55

Example Output:

{
  "lat": -180,
  "lon": -180,
  "maps": "https://www.google.com/maps/place/-180,-180"
}

You can also use the argument -m or --multi to fetch location data for WAPs in close proximity to a given BSSID:

apple-wap-locator <BSSID> -m

Node.js API

You can also use this package as a module in your own code:

const { basicLocation, multiLocation } = require('apple-wap-locator');

(async () => {
  const basicInfo = await basicLocation("00:11:22:33:44:55");
  console.log(basicInfo);

  const verboseInfo = await multiLocation("00:11:22:33:44:55");
  console.log(verboseInfo);
})();

📚 API

basicLocation(bssid: string): Promise<{ bssid, location: { lat, lon } }>
Fetches location data for a single BSSID.

multiLocation(bssid: string): Promise<Array<{ bssid, location: { lat, lon } }>>
Fetches location data for WAPs in close proximity to a given BSSID.

🛑 Disclaimer

This tool makes use of undocumented Apple services intended for iOS/macOS devices. Use responsibly and with awareness of privacy and legal concerns.

📖 References

Wi-Fi Positioning Systems and Privacy (UMD)

🧑‍💻 Author

nova.dev

📜 License

Copyright 2025 nova.dev

Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED “AS IS” AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.