All tutorials
Using the what3words ArcGIS Locator across the ArcGIS platform
The what3words ArcGIS Locator brings the functionality of the what3words API to the ArcGIS platform. You can use the Locator throughout the ArcGIS product suite wherever a custom locator can be added. This includes ArcGIS Desktop – ArcCatalog and ArcMap as well as ArcGIS Pro.
On web, you can use the Locator within ArcGIS Online and any products able to connect to Online such as in app using Survey123. Or for GIS developers the ArcGIS APIs and SDKs in the Developer suite can harness the ArcGIS Locator as a REST API.
The Locator gives you the ability to convert to and from coordinates, or more commonly known within ArcGIS as forward/reverse address geocoding. Functionality varies by ArcGIS product so take a look at our tutorials to see how the locator works within ArcGIS.
The current version of the what3words Locator is v2.0. For users of what3words Locator v1.0 you will need to upgrade to V2.0 to continue to use the service.
In order to upgrade the Locator you will need to change the following:
URL: Change the URL prefix from https://arcgis.what3words.com/w3w/rest/services/ to https://arcgis.what3words.com/v2/arcgis/rest/services/
Username: This should now be your email address
Password: This should now be your API key
The Locator can be added as an ArcGIS web service via ArcCatalog.
View this TUTORIAL for the steps to add to ArcCatalog.
Once added, the Locator can be used within the rest of the ArcGIS desktop suite to:
- Search for 3 word addresses
- Discover the 3 word address for a location
- Batch geocode locations within ArcGIS Toolbox.
Requires ArcGIS 10.6 or newer.
Once the Locator is added as Content within ArcGIS Online it will be available across ArcGIS Online and any product that connects to ArcGIS Online such as ArcGIS Pro and Survey123.
View this TUTORIAL for the steps to add to ArcGIS Online.
Once added the Locator can be used to:
First, add the what3words Locator to your ArcGIS Online account.
Once added the Locator will be available In ArcGIS Pro to:
- Search for 3 word addresses using the Locate feature
- Discover a 3 word address by right-clicking on the map and selecting “What’s here?”
- Batch convert between 3 word address and coordinates and coordinates and 3 word addresses using the Toolbox.
The process for adding the Locator to Portal for ArcGIS Enterprise is very similar to ArcGIS Online. Once the Locator is added as Content within Portal for ArcGIS it will be available across Portal and any product that connects to Portal such as ArcGIS Pro and Survey123.
View this TUTORIAL for the steps to add to Portal for ArcGIS Enterprise.
Once added the Locator can be used to:
Survey123 enables the creation of a survey for use in apps out in the field. Adding the Locator to Survey123 allows for 3 word addresses to be collected or viewed when out in the field.
First, add the what3words Locator to your ArcGIS Online account.
Then you will be able to add to your survey using the GeoPoint feature.
Field Maps helps mobile workers perform data collection and editing, find assets and information, and report their real-time locations. Adding the Locator to Field Maps allows for 3 word addresses to be viewed and collected when out in the field.
First, add the what3words Locator to your ArcGIS Online account.
Then you will be able to use it on your survey using the Field Maps app.
The what3words ArcGIS Locator can be accessed as a REST API from the ArcGIS API for JavaScript.
A collection of resources for developers using the ArcGIS API for JavaScript to integrate the what3words ArcGIS Locator can be found HERE.
For more information on how to call a Locator
in ArcGIS see this ArcGIS developer guide.
The what3words ArcGIS Locator can be used within our widget built using Web AppBuilder for ArcGIS.
This widget will help you to perform reverse geocoding (convert a point to a what3words address) on your ArcGIS Online or Portal for ArcGIS.
First, make sure you have added correctly the what3words Locator to your ArcGIS Online or Portal for ArcGIS.
Then you will be able to use it within your web application by following this TUTORIAL.
The what3words ArcGIS Locator can be used within our widget built using ArcGIS Experience Builder.
This widget will help you to perform reverse geocoding (convert a point to a what3words address) on your ArcGIS Online or Portal for ArcGIS.
First, make sure you have added correctly the what3words Locator to your ArcGIS Online or Portal for ArcGIS.
Then you will be able to use it within your web application by following this TUTORIAL.
If you encounter errors or issues related to convert-to-coordinate requests while using the Free plan, please check the network panel for the following error message Error 402 payment required
and its response, indicating the need to upgrade to a higher plan:
{ "error": { "code": "QuotaExceeded", "message": "Quota Exceeded. Please upgrade your usage plan, or contact support@what3words.com" } }
For more information, visit our API plans page. If you need further assistance, contact support@what3words.com.