LocationIQ
LocationIQ is a developer-focused platform offering affordable, scalable APIs for geocoding, maps, and routing. Founded in 2015 and built on OpenStreetMap, it was created to address common challenges in the geolocation space—like high costs and rigid contracts. With a strong community-driven approach, LocationIQ now serves over 50,000 developers and handles 2+ billion requests daily from startups, non-profits, and enterprises.
With LocationIQ you can manage geocoding, reverse geocoding, address autocomplete, IP geolocation, distance matrix calculations, time zone lookups, and route optimization, enabling powerful location-based automation and enhanced mapping capabilities within your workflows.
Pre-Requisite: This document assumes that you already have a base knowledge of using the Make platform.Modules
- Search/Forward Geocoding - Search Location, Search Location with Postal Code, Search Structured Geocoding
- Reverse Geocoding - Get Reverse Geocoding
- Time zone - Get Time zone from Geocoding
- Other - Make an API Call, Get Balance
Connecting Location IQ to Make
To use Location IQ in Make, you’ll need both your Registered BPT App License Key and your Location IQ API Access Token.How do I request an API token for LocationIQ
- Do you have a LocationIQ account?
- Yes - Continue to Step 2
- No - use the Register link to sign up for a free account - Enter you email, name and Use Case. You will receive a verification email - follow the instructions > Select “All of them” > Click ‘Get Started’
- Log in to your Location IQ account.
- In the left-hand menu, click on Access Tokens.
- Click ‘Show Token’ > Click on the copy icon > Paste the value into notepad
How do I request a BPT App License Key.
After purchasing your app either as part of a bundle or separately, you should have received an email containing the BPT App License Key. If you have not received an email or if you are yet to purchase the app please use the BPT License Key link that will guide you through the process.
How to Create a connection for your Make module
Login to Make > Select ‘Scenarios’ > Select ‘Create a new scenario’
Search for “LocationIQ” > Select ‘Search Location’ (Note any module can be used, however we will use this one for testing data is returned)
Under Connection, click ‘Create a connection’
The Create a Connection dialog appears.
In the Connection name field, enter a name to identify the connection.
(Note this is Optional, however we recommend you provide a good descriptive name i.e. “Production: Location IQ Connection“).- Enter your Registered BPT App License Key.
For more information on how to acquire a BPT App License Key, refer to the
faq
page.- Enter your Access Token.
- Click Save
If you receive a pop up window with an error message like > {"message":"The request failed"} .
Close the window and wait for the connection to finish verification (Note this may take up to 60 seconds) > Double check you entered the correct key values and re-try- To Test > Select Module > Enter a search string i.e. “London” > Click ‘Save’ > Right click on the Module > Select ‘Run this module only’ > If working correctly the results box will appear and show data.
You have successfully established the connection and returned data. You can now edit your scenario and add more Location IQ modules.How to update a connection.
If your connection requires reauthorization at any point, follow the connection renewal steps here .
Build Location IQ Scenarios:
After connecting the app, you can perform the following actions:
Each module will have standard fields and Advanced fields that can only be viewed by toggling on the ‘Show advanced settings’. These are identified in the description for each field.Search/Forward Geocoding
Search Location
The Search API allows converting addresses, such as a street address, into geographic coordinates (latitude and longitude)
This module contains the following fields
| Field | Usage |
|---|---|
| Connection | Select the required connection from the drop down.If no connection exists Create Connection. |
| Search * | Free-form query string to search for. Commas are optional, but improves performance by reducing the complexity of the search. (Required) |
| Split Address Details to Elements | Include a breakdown of the address of this result into elements (Default = Empty) |
| Include State Code | Adds state or province code when available to the state code key inside the address object. Currently supported for addresses in the USA, Canada and Australia. Defaults to 0. Addational to view the state code this os displayted the the request header and not the output. (Default = Empty) |
| Restrict Boundary to max and min latitude and longitude | The preferred area to find search results. (Advanced Setting field) (Default = Empty)- Max Longitude: Maximun Longitude of area to create view box. - Must be a number between -180 and 180.- Max Latitude: Maximun Latitude of area to create view box. - Must be a number between -90 and 90- Min Longitude: Minimum Longitude of area to create view box. - Must be a number between -180 and 180.- Min Latitude: Minimum Latitude of area to create view box. - Must be a number between -90 and 90 |
| Limit | Maximum number of returned results (bundles). (Default - 10)- Must be a number between 1 and 50. |
| Country Code to Limit Search results | Limit search results to a specific country or a comma-separated list of countries. Should be the ISO 3166-1 alpha-2 code(s). |
| Normalize Address | Makes parsing of the address object easier by returning a predictable and defined list of elements. (Default = Empty) |
| Normalize City | For responses with no city value in the address section, the next available element in this order - city_district, locality, town, borough, municipality, village, hamlet, quarter, neighbourhood - from the address section will be normalized to city. (Default = Empty) |
| Return Postal Address formatted for country | Currently supported for addresses in Belgium, Brazil, France, Germany, Greece, India, Ireland, Italy, Portugal, South Africa, Spain and United Kingdom. (Default = Empty) |
| Output Format | Choose the format for returned data. (Advanced Setting field)- JSON (Default)- XML- XML v1.1 |
Search Location with Postal Code
Postal Address Lookup streamlines the task of locating details when only a postal code match is necessary. It’s particularly useful when you want to fetch location information without handling complete addresses.
This module contains the following fields
| Field | Usage |
|---|---|
| Connection | Select the required connection from the drop down.If no connection exists Create Connection. |
| Postal Code * | Use this to indicate the postal or ZIP code, aiding in pinpointing the exact area within a city or locality. (Required) |
| Split Address Details to Elements | Include a breakdown of the address of this result into elements. (Default = Empty) |
| Include State Code | Adds state or province code when available to the state code key inside the address object. Currently supported for addresses in the USA, Canada and Australia. Defaults to 0. (Default = Empty) |
| Restrict Boundary to max and min latitude and longitude | The preferred area to find search results. (Advanced Setting field) (Default = Empty)- Max Longitude: Maximun Longitude of area to create view box. - Must be a number between -180 and 180.- Max Latitude: Maximun Latitude of area to create view box. - Must be a number between -90 and 90- Min Longitude: Minimum Longitude of area to create view box. - Must be a number between -180 and 180.- Min Latitude: Minimum Latitude of area to create view box. - Must be a number between -90 and 90 |
| Limit | Maximum number of returned results (bundles). (Default - 10)- Must be a number between 1 and 50. |
| Country Code to Limit Search results | Limit search results to a specific country or a comma-separated list of countries. Should be the ISO 3166-1 alpha-2 code(s). |
| Normalize Address | Makes parsing of the address object easier by returning a predictable and defined list of elements. (Default = Empty) |
| Normalize City | For responses with no city value in the address section, the next available element in this order - city_district, locality, town, borough, municipality, village, hamlet, quarter, neighbourhood - from the address section will be normalized to city. (Default = Empty) |
| Return Postal Address formatted for country | Currently supported for addresses in Belgium, Brazil, France, Germany, Greece, India, Ireland, Italy, Portugal, South Africa, Spain and United Kingdom. (Default = Empty) |
| Output Format | Choose the format for returned data. (Advanced Setting field)- JSON (Default)- XML- XML v1.1 |
Search Structured Geocoding
Structured Query offers a more specific way to search for locations. Instead of using a single text string, you can provide distinct address components in a structured format. This includes specifying elements like street, neighbourhood, city, state, country, and postal code, each sent as separate API parameters.
This module contains the following fields
| Field | Usage |
|---|---|
| Connection | Select the required connection from the drop down.If no connection exists Create Connection. |
| Street * | Pass this parameter to specify the street address (building number, name and road). (Required) |
| City * | Include this parameter to provide the city information for geocoding. (Required) |
| County | Use this to indicate the county or administrative region of the address. |
| State | Pass this to specify the state or province of the address, helping to identify the region within the country. |
| Country | Include this to provide country of the address, crucial for precise geocoding on a global scale. |
| Postal Code | Use this to indicate the postal or ZIP code, aiding in pinpointing the exact area within a city or locality. |
| Split Address Details to Elements | Include a breakdown of the address of this result into elements. (Default = Empty) |
| Include State Code | Adds state or province code when available to the state_code key inside the address object. Currently supported for addresses in the USA, Canada and Australia. Defaults to 0. (Default = Empty) |
| Return Postal Address formatted for country | Enable to return the postal address formatted according to the country’s conventions. |
| Restrict Boundary to max and min latitude and longitude | Restrict search results to a defined geographic boundary using specified maximum and minimum latitude and longitude. (Advanced Setting field) (Default = Empty)- Max Longitude: Maximun Longitude of area to create view box. - Must be a number between -180 and 180.- Max Latitude: Maximun Latitude of area to create view box. - Must be a number between -90 and 90- Min Longitude: Minimum Longitude of area to create view box. - Must be a number between -180 and 180.- Min Latitude: Minimum Latitude of area to create view box. - Must be a number between -90 and 90 |
| Limit | Maximum number of returned results (bundles). (Default - 10)- Must be a number between 1 and 50. |
| Country Code to Limit Search Results | Limit search results to a specific country or a comma-separated list of countries. Should be the ISO 3166-1 alpha-2 code(s). |
| Normalize Address | Makes parsing of the address object easier by returning a predictable and defined list of elements. (Default = Empty) |
| Normalize City | For responses with no city value in the address section, the next available element in this order - city_district, locality, town, borough, municipality, village, hamlet, quarter, neighbourhood - from the address section will be normalized to city. (Default = Empty) |
| Return Postal Address formatted for country | Currently supported for addresses in Belgium, Brazil, France, Germany, Greece, India, Ireland, Italy, Portugal, South Africa, Spain and United Kingdom. (Default = Empty) |
| Output Format | Choose the format for returned data. (Advanced Setting field)- JSON (Default)- XML- XML v1.1 |
Reverse
Get Reverse Geocoding
Reverse geocoding is the process of converting a coordinate or location (latitude, longitude) to a readable address or place name.
This module contains the following fields
| Field | Usage |
|---|---|
| Connection | Select the required connection from the drop down.If no connection exists Create Connection. |
| Latitude * | Latitude of the location to generate an address for.- Must be a number between -90 and 90. |
| Longitude * | Longitude of the location to generate an address for.- Must be a number between -180 and 180. |
| Zoom | Level of detail required where 0 is country and 18 is house/building. Defaults to 18. In terms of address details the zoom levels are as follows:- Must be lower than or equal to 18. |
| Normalize Address | Makes parsing of the address object easier by returning a predictable and defined list of elements. (Default = Empty) |
| Normalize City | For responses with no city value in the address section, the next available element in this order - city_district, locality, town, borough, municipality, village, hamlet, quarter, neighbourhood - from the address section will be normalized to city. (Default = Empty) |
| Return Postal Address formatted for country | Currently supported for addresses in Belgium, Brazil, France, Germany, Greece, India, Ireland, Italy, Portugal, South Africa, Spain and United Kingdom. (Default = Empty) |
| Return Name of oceans from Co-ords | Allows you to specify whether or not the API should return the name of an ocean or sea if the coordinates provided fall within a body of water. (Default = Empty) |
| Output Format | Choose the format for returned data. (Advanced Setting field)- JSON (Default)- XML- XML v1.1 |
Timezone
Get Timezone from Geocoding
The Timezone API provides time offset data for locations on the surface of the earth.
This module contains the following fields
| Field | Usage |
|---|---|
| Connection | Select the required connection from the drop down.If no connection exists Create Connection. |
| Latitude * | Latitude of the location to generate an address for.- Must be a number between -90 and 90. |
| Longitude * | Longitude of the location to generate an address for.- Must be a number between -180 and 180. |
| Datetime of Location | - Time zone: Europe/London- For more information about supported date formats, see the online Help .Provide the date and time associated with the location. This field can be used for temporal context in dynamic or time-sensitive geolocation queries. |
Other
Get Balance
Check balance for Location IQ
Details
This module contains the following fields
| Field | Usage |
|---|---|
| Connection | Select the required connection from the drop down.If no connection exists Create Connection. |
Make An API Call
This module contains the following fields
Details
| Field | Usage |
|---|---|
| Connection | Select the required connection from the drop down.If no connection exists Create Connection. |
| URL | Enter a path relative to https://us1.locationiq.com/v1 For example:/searchRefer to the LocationIQ API documentation for a list of available endpoints.
https://docs.locationiq.com/docs/introduction |
| Method | Select the HTTP method you want to use:GET to retrieve information for an entry.POST to create a new entry.PUT to update/replace an existing entry.PATCH to make a partial entry update.DELETE to delete an entry. |
| Headers | Enter the desired request headers. You don’t have to add authorization headers; we already did that for you. |
| Query String | Enter the request query string. |
| Body | Enter the body content for your API call. |