Using Wi-Fi anchors

Wi-Fi anchors allow you to set an access point as a custom reference for location requests.

Requirements

Your device must be able to scan for Wi-Fi networks.

In the nRF Cloud portal

To add a new Wi-Fi anchor:

1. Log in to the nRF Cloud portal.

2. In the left navigation bar, select Location Services.

   The Location Services page opens.

3. Scroll down to find the Anchors card.

4. Click Add Anchor.

   A pop-up opens.

5. Enter the following:

   • Name (optional, max 32 characters).
   • MAC address of the access point (required), in format xx:xx:xx:xx:xx:xx or xx-xx-xx-xx-xx-xx.
   • Latitude
   • Longitude

6. Click the Add Anchor button.

The new anchor appears in the Anchors table. You can now also view the anchor on the map card.

Using the APIs

To add a new anchor, call the CreateAnchor endpoint. Include the following information in the request:

• macAddress (Required): String of six hexadecimal pairs, separated by colons or dashes.
• lat (Required): Latitude.
• lon (Required): Longitude.
• name (Optional): Name for the anchor. Max 32 characters.

You can view the added anchor using the ListAnchors endpoint, or from the Location Services page in the nRF Cloud portal.