<aside> 💡 To get started with what3words within Locus, create a what3words API key and follow the instructions below. To get started with Locus, you can contact them here

</aside>

Locus uses the in-house built geocoding service to obtain the geographic coordinates of the customer location using the address and latitude-longitude information provided by the client during the order creation. To further enhance route planning, Locus has integrated what3words and now uses the 3-word address format provided by clients to geocode the addresses.

what3words can be enabled for any Locus client who uses a 3-word address as an address format. Once what3words is enabled, clients can use Locus's Create Order API to pass the 3-word address instead of a complete location address, thus reducing the overall order creation time.

<aside> ⚠️ To use what3words, you’ll first need to add a what3words field to your checkout page or CRM. To do so you can use one of our existing plugins or the what3words API. You can take a look at these options and find out more information here.

</aside>


1. Locus Create Order API

The what3words JSON field in the API is “what3words”

Screenshot 2023-01-23 at 11.24.53 am.png

On successful order creation, the 3-word address is converted to latitude and longitude and stored under the geocoding metadata. Refer to the below sample API response screenshot:

Screenshot 2023-01-23 at 11.27.25 am.png

The lat-long information derived from the 3-word address is used to generate the most optimized route for order delivery.


2. what3words visualization on the Locus Console

The Locus geocoder engine uses the 3-word address passed during the order creation to geocode the order location. The passed 3-word address is shown on the Locus dashboard under the "what3words" column header.

Screenshot 2023-01-23 at 11.28.26 am.png

Screenshot 2023-01-23 at 11.28.44 am.png