Single Search Geocoding API

Contents

Our Single Search service allows you to geocode an address that a user submits as a single string of text—similar to a query on a web search engine. It returns an array of locations that match the search text. It can also help provide more relevant search results, giving you the ability to search based on the current location (a longitude/latitude point).

Single Search is our most advanced API for geocoding. It allows you to search for addresses, coordinates, places, and points of interest throughout the world. We recommended it for all new implementations.

We also offer a suite of Geocoding APIs that separately supports forward, reverse, and batch geocoding. These APIs provide similar results as Search, but require a more structured input. They are intended for special cases where the customer requirements and user input are more narrowly defined.

With an API key, you can test out the Single Search service either:

On our testing site, which also displays the location on a map.
On this page as a URL request and response.

Getting Started

The single search service is available through the following URL:

https://singlesearch.alk.com/{region}/api/{endpoint}?authToken={your-api-key}

In order to get a valid URL to the single search service, replace {region} above with one of the supported regions: NA, WW, EU, AS, AF, SA, OC, MX, ME
You will need a valid API key to replace {your-api-key}
Replace {endpoint} with one of the endpoints below

Endpoints

`GET` /search

/search is the main geocoding URL and supports the parameters below.

Name	Description	Data Type	Required
`authToken`	Provided API Key		Yes
`query`	String indicating the text to search for	string	Yes
`maxResults`	Limits search results by the specified number. Must be a value between 1 and 100.	Int	No
`currentLonLat`	The current longitude and latitude, where longitude and latitude are either decimal or integer coordinates.	Complex	No
`excludeResultsFor` Replaces `excludedSearchTypes`, which has been deprecated	A comma-separated list of InterpTypes to exclude from the search. Available types: Country, State, County, City, ZIP, SPLC, Street, RouteNumber, RouteAlpha, POI, POIStreet, FullPostCode, POIType, CrossStreet, LatLon, and CustomPlace.	string	No
`includeOnly`	A comma-separated list of InterpTypes to include in the search response. Allowed filters: Country, State, County, City, POBox, Zip, SPLC, Street, RouteNumber, RouteAlpha, POI, POIStreet, FullPostCode, POIType, CrossStreet, LatLon, CustomPlace, and None. (Example: includeOnly=CustomPlace,Street. This will return only custom places and streets that match with the search string.) To include results from ZIP codes that only apply to post office boxes, the values `POBox` and `Zip` must be included in your request.	string	No
`poiCategories`	A comma-separated list of Points of Interest (POI) category names by which you want to filter all POI results. A GET call to /search/poiCategories can be used to retrieve the current list of categories available for filtering.	string	No
`countries`	A comma-separated list of country codes by which you want to filter all results. It defaults to ISO format.	string	No
`countryType`	The standard for country abbreviations: ISO, FIPS, GENC2, and GENC3.	string	No
`states`	A comma-separated list of state abbreviations by which you want to filter all results.	string	No
`include`	Set to `include=Meta` to include additional metadata in your results, such as road grid and link information as well as the confidence level of the search results. (See `QueryConfidence` in response parameters below.)	string	No
`useCustomPlaces`	If set to true, this option includes custom places in the search results where the location’s `PlaceId` or `PlaceName` starts with the query string. Note that custom places can only be searched by name and ID, not by address, city, state, or ZIP code. Custom place results will appear before any other search results. This setting is a convenience feature that integrates a call to the Places API’s `places/v1/place/search` endpoint into the single search call. However, it comes with a performance cost, as single search must wait for the places call to complete before returning results. For optimal performance, consider leaving this option off (false) and making a separate parallel call to the places endpoint. Default is false.	boolean	No
`separateHN`	Sets whether the house number should be returned as a separate field from the rest of the street address. Default is false.	boolean	No
`getAllHNRanges`	If set to true, all potential house number ranges will be returned for a particular street match. Default is false.	boolean	No
`includeTrimblePlaceIds` (North America and Europe only)	Set to true to return the `TrimblePlaceId`, `PlaceName` and `SiteName` for a location, if they exist. Default is false.	boolean	No
`lang`	The language to use in results. U.S. English is the default.	string	No
`includeCenter`	Used with partial postal code queries. When provided, the center coordinates of multiple postal code points will be calculated and returned. For example, a search for `&includeOnly=zip&query=840` will return a long list of ZIP codes starting with “840.” Adding `&includeCenter` instead returns a single point that is roughly central to all of those ZIP codes.	boolean	No
`strictMatch`	Limits the amount of difference that is allowed between the input query and the match results. This is generally better left to the default of `false`, but in some cases where automation is applied to results, it may limit false positives.	boolean	No
`radiusFromCurrentLonLat`	Limits search results to within a specified distance in miles from the current location, as identified by `currentLonLat`. A valid `currentLonLat` must be sent in the request for this parameter to take effect. In some cases, a short `radiusFromCurrentLonLat` may produce no matches.	float	No

These additional parameters below are only applicable when performing a reverse geocode search using latitude/longitude coordinates.

Name	Description	Data Type	Required
`matchNamedRoadsOnly`	When looking up coordinates, this forces reverse geocoding to match named roads only.	boolean	No
`maxCleanupMiles`	When looking up coordinates, this sets a maximum radius, in miles, in which to find the closest matching road.	double	No
`heading`	Used to determine which road link to snap to. For instance, when crossing a highway. Values are: 0 - North 90 - East 180 - South 270 - East	double	No

Test the API Now

To test the Search API:

Enter your API KEY in the box below. If you don’t have a key, you can request a free, limited-time trial key.
By default, this test is set to search in North America (NA). You can change the region by replacing NA with one of the other supported regions—Europe (EU), Asia (AS), Africa (AF), South America (SA), Oceania (OC), Mexico (MX), or Middle East (ME)—in the GET request URL. (If you are using a trial key in North America, your searches are limited to NA. Outside of North America, trial keys are provided with access to specific regions.)
Use the query parameter to add your location search to the GET request URL. There are several example queries below that demonstrate the correct format.
Add any other optional parameters you would like to enhance your search.
Click GO and the results of your search are shown under Test Response.

API KEY

GET

Test Response

Ways to Improve Search Speed and Results

The Search service aims to return at least 90 percent of responses in less than 200 milliseconds, with the majority of responses in 31 milliseconds or less. The response speed of any particular query can vary depending on your input and other factors. Please follow the tips below to ensure you get the fastest possible response times:

Search queries that contain ZIP or postal codes narrow the search and generally perform better than those without postal codes. Only 5-digit ZIP codes are supported in the U.S. (No ZIP+4 codes.)
Queries with a comma between street address, city, county, state, country, and postal code improve performance and may improve the accuracy of results.
Queries with accurate spellings and complete addresses generally perform better than those where the service has to fill in or correct details.
Queries with extraneous information like parking instructions or phone numbers generally take longer to process.
If you have structured data, using our field labels can speed up your search.
Transmission time may vary depending on your internet connection and location.

`GET` /search/types

/search/types returns the list of search’s known InterpTypes (See list above under includeOnly parameter). These are independent of the region.

`GET` /search/poiCategories

/search/poiCategories returns the list of search’s acceptable POI categories for filtering. These are dependent on the region.

`GET` /search/poiTypes

/search/poiTypes returns POI category names and their associated IDs, which are included in search responses as the POITypeID. These are dependent on the region.

`GET` /search/countries

/search/countries returns the list of search’s acceptable countries for filtering. These are dependent on the region.

`GET` /search/states

/search/states returns the list of search’s acceptable states for filtering. These are dependent on the region.

Example Queries

/search?query=1 independence way, princeton, nj, 08540&countries=US&states=NJ, NM
/search?query=53 Chancery Lane London, WC2A 1QS&countries=UK
/search?query=1 independence way, princeton, nj, 08540&currentLonLat=-74600291,40360869
/search?query=53 Chancery Lane London, WC2A 1QS&currentLonLat=-0113172,5151741
/search?query=1 independence way, princeton, nj, 08540&excludeResultsFor=POI,POItype
/search?query=1 independence way, princeton, nj, 08540&poiCategories=Airport, bank, CAT scales
/search?query=1 independence way, princeton, nj, 08540&countries=US
/search?query=1 independence way, princeton, nj, 08540&countries=US&countryType=ISO
/search?query=1 independence way, princeton, nj, 08540&states=NJ
/search?query=40.3559242765905,-74.451975067144&includeTrimblePlaceIds=true

Fielded Search

(For existing implementations only. Not recommended for new customers.)

You can also use keywords within a search string to help narrow your results. The keywords available are: housenumber (or hn), route (or rt), street, county, city, zip, splc, fullpostcode, fpc, poi, state, and country.

Example

/search?query=49 Easton Ave New Brunswick state:NJ

Adding the keyword “state” forces “NJ” to be interpreted as a state, and it ensures no other term in the string can be interpreted as a state.

By adding quotation marks, multiple search terms can be grouped together with a keyword.

Example

/search?query=49 street:"Easton Ave" New Brunswick state:NJ

This forces “Easton Ave” to be the only street match.

Single Search Response

The response will include a list of resulting locations. Below are descriptions of response parameters and error codes, as well as a sample request and response.

Response Parameters

Name	Description	Type
`Address`	The details about the location.	Complex
`Coords`	The details about the longitude/latitude, offset to side of street when possible. For Addresses without a house number or where side of street is ambiguous the Coords and StreetCoords will be the same.	Complex
`StreetCoords`	The details about the longitude/latitude along the centerline of the street.	Complex
`Region`	Indicates the region of the location.	Enum 0 - Unknown 1 - AF 2 - AS 3 - EU 4 - NA(default) 5 - OC 6 - SA 7 - ME 8 - Deprecated 9 - MX* *Mexico region available as NA Add-on or included in Worldwide license.
`POITypeID`	The type of POI based on data defines. Ex: TypeID_TruckService = 144 or TypeID_MajorAirport = 101	Int
`PersistentPOIID`	A persistent ID between different versions of map data.	Complex
`ResultType`	Indicates the type of match with the search string.	Int 0 = Country 1 = State 2 = County 3 = City 4 = Zip 5 = SPLC 6 = Street 7 = RouteNumber 8 = RouteAlpha 9 = POI 10 = POIStreet 11 = FullPostCode 12 = POIType 13 = CrossStreet 14 = LatLon 15 = CustomPlace 16 = None 17 = TrimblePlaces
`ShortString`	Complete address that matches with the query string.	string
`PlaceId`	Unique custom place or company id.	Alphanumeric
`Err`	Refer the section on error codes.	Int
`QueryConfidence`	The confidence level of the search results. Included in response only if request has `include=Meta`	Int
`TrimblePlaceId`	The identifier for a location in the Trimble Maps Places database, which includes tens of thousands of commercial locations across North America that serve the transportation industry. This ID can be used to call additional information about the Place using our Places API.	String
`PlaceName`	The name of the Place in the Trimble Maps database.	String
`SiteName`	The name of the Site in the Trimble Maps database.	String

Address

Name	Description	Type
`StreetAddress`	The house number and street name. Ex: 1 Independence Way	string
`LocalArea`	The name of a local area, if available. This may be a neighborhood, a district, or similar. Ex: Keyhaven	string
`City`	The name of the city. Ex: Princeton	string
`State`	The two letter state abbreviation. Ex: NJ	string
`Zip`	The postal code or ZIP. Ex: 08540	string
`County`	The county or jurisdiction. Ex: Mercer	string
`Country`	The code for the country.	string
`CountryFullName`	The full name of the country.	string
`SPLC`	The Standard Point Location code to use in place of street/city/state/zip.	string

Coords

Name	Description	Type
`Lat`	Latitude	string
`Lon`	Longitude	string

Error Codes

Error Code	Error
0	OK
1	NoGlobals
2	GeoGlobals
3	GridGlobals
4	POIGlobals
5	InvalidID
6	NotImplemented
7	NoQuery
8	NoQueryAfterFormatting
9	NoAllowedInterps
10	InvalidNumResultsRequested
11	NoDataLoaded
12	DataLoad
13	BadData
14	FileMissing
15	FolderIndexOOB
16	CityFileClientOOB
17	OOB
18	FileIO
19	Memory
20	NoPreviousSearch
21	ThreadStart
22	ThreadEnqueue
23	ObjectNotInitialized
24	POIData
25	Internal
26	QueryIsNotUTF8
27	InvalidQuery
28	InvalidInterpRankingSettings
29	InvalidParameters
30	SynonymVersionMismatch
31	SynonymAmbiguityMismatch
32	FrequenciesDisabled
33	TimeOut
34	InvalidInputCountry
35	InvalidInputState
36	StateIsNotPartOfCountry
37	IndexVersionMismatch
38	InvalidLatLonForRegion
39	Unknown

Sample Request

Here is an example for the query “1 Independence Way”.

The URL for the request is:
https://singlesearch.alk.com/na/api/search?authToken=<APIKEY>&query=1%20independence%20way

Sample Response

The full response for the above request is:

{
      "Err": 0,
    "Locations": [
        {
            "Address": {
                "StreetAddress": "1 Independence Way",
                "City": "Jersey City",
                "State": "NJ",
                "StateName": "New Jersey",
                "Zip": "07305",
                "County": "Hudson",
                "Country": "US",
                "CountryFullName": "United States",
                "SPLC": null
            },
            "Coords": {
                "Lat": "40.688199",
                "Lon": "-74.074366"
            },
            "Region": 4,
            "POITypeID": 0,
            "PersistentPOIID": -1,
            "SiteID": -1,
            "ResultType": 6,
            "ShortString": "1 Independence Way, Jersey City, NJ, US, Hudson 07305",
            "TimeZone": "EST"
        },
        {
            "Address": {
                "StreetAddress": "1 Independence Way",
                "City": "Cranston",
                "State": "RI",
                "StateName": "Rhode Island",
                "Zip": "02921",
                "County": "Providence",
                "Country": "US",
                "CountryFullName": "United States",
                "SPLC": null
            },
            "Coords": {
                "Lat": "41.78962",
                "Lon": "-71.500717"
            },
            "Region": 4,
            "POITypeID": 0,
            "PersistentPOIID": -1,
            "SiteID": -1,
            "ResultType": 6,
            "ShortString": "1 Independence Way, Cranston, RI, US, Providence 02921",
            "TimeZone": "EST"
        },
        {
            "Address": {
                "StreetAddress": "1 Independence Way",
                "City": "Princeton",
                "State": "NJ",
                "StateName": "New Jersey",
                "Zip": "08540",
                "County": "Mercer",
                "Country": "US",
                "CountryFullName": "United States",
                "SPLC": null
            },
            "Coords": {
                "Lat": "40.360723",
                "Lon": "-74.599963"
            },
            "Region": 4,
            "POITypeID": 0,
            "PersistentPOIID": -1,
            "SiteID": -1,
            "ResultType": 6,
            "ShortString": "1 Independence Way, Princeton, NJ, US, Mercer 08540",
            "TimeZone": "EST"
        },
        {
            "Address": {
                "StreetAddress": "1 Independence Way",
                "City": "Brenham",
                "State": "TX",
                "StateName": "Texas",
                "Zip": "77833",
                "County": "Washington",
                "Country": "US",
                "CountryFullName": "United States",
                "SPLC": null
            },
            "Coords": {
                "Lat": "30.249221",
                "Lon": "-96.363437"
            },
            "Region": 4,
            "POITypeID": 0,
            "PersistentPOIID": -1,
            "SiteID": -1,
            "ResultType": 6,
            "ShortString": "1 Independence Way, Brenham, TX, US, Washington 77833",
            "TimeZone": "CST"
        },
        {
            "Address": {
                "StreetAddress": "1 Independence Way",
                "City": "Doylestown",
                "State": "PA",
                "StateName": "Pennsylvania",
                "Zip": "18901",
                "County": "Bucks",
                "Country": "US",
                "CountryFullName": "United States",
                "SPLC": null
            },
            "Coords": {
                "Lat": "40.312962",
                "Lon": "-75.149676"
            },
            "Region": 4,
            "POITypeID": 0,
            "PersistentPOIID": -1,
            "SiteID": -1,
            "ResultType": 6,
            "ShortString": "1 Independence Way, Doylestown, PA, US, Bucks 18901",
            "TimeZone": "EST"
        },
        {
            "Address": {
                "StreetAddress": "1 Independence Way",
                "City": "Edgewater",
                "State": "NJ",
                "StateName": "New Jersey",
                "Zip": "07020",
                "County": "Bergen",
                "Country": "US",
                "CountryFullName": "United States",
                "SPLC": null
            },
            "Coords": {
                "Lat": "40.810277",
                "Lon": "-73.987319"
            },
            "Region": 4,
            "POITypeID": 0,
            "PersistentPOIID": -1,
            "SiteID": -1,
            "ResultType": 6,
            "ShortString": "1 Independence Way, Edgewater, NJ, US, Bergen 07020",
            "TimeZone": "EST"
        },
        {
            "Address": {
                "StreetAddress": "1 Independence Way",
                "City": "Falmouth",
                "State": "ME",
                "StateName": "Maine",
                "Zip": "04105",
                "County": "Cumberland",
                "Country": "US",
                "CountryFullName": "United States",
                "SPLC": null
            },
            "Coords": {
                "Lat": "43.761429",
                "Lon": "-70.325684"
            },
            "Region": 4,
            "POITypeID": 0,
            "PersistentPOIID": -1,
            "SiteID": -1,
            "ResultType": 6,
            "ShortString": "1 Independence Way, Falmouth, ME, US, Cumberland 04105",
            "TimeZone": "EST"
        }
    ]
}

Sample Request with Metadata

Here is an example for the query “1 Independence Way”.

The URL for the request is:
https://singlesearch.alk.com/na/api/search?authToken=<APIKEY>&query=1%20independence%20way&include=Meta

Sample Response with Metadata

{
    "Err": 0,
    "ErrString": "OK",
    "QueryConfidence": 3,
    "TimeInMilliseconds": 141,
    "GridDataVersion": "GRD_ALK.NA.2021.04.17.9.1.1",
    "CommitID": "pcmws-24.0.0.0-603-g8bd268659a1: 01/25/2022 20:35",
    "Locations": [
        {
            "Address": {
                "StreetAddress": "1 Independence Way",
                "City": "Jersey City",
                "State": "NJ",
                "StateName": "New Jersey",
                "Zip": "07305",
                "County": "Hudson",
                "Country": "US",
                "CountryFullName": "United States",
                "SPLC": null
            },
            "Coords": {
                "Lat": "40.688199",
                "Lon": "-74.074366"
            },
            "StreetCoords": {
                "Lat": "40.688243",
                "Lon": "-74.074401"
            },
            "Region": 4,
            "POITypeID": 0,
            "PersistentPOIID": -1,
            "SiteID": -1,
            "ResultType": 6,
            "ShortString": "1 Independence Way, Jersey City, NJ, US, Hudson 07305",
            "GridID": 10008076,
            "LinkID": 217,
            "Percent": 4313,
            "TimeZone": "EST"
        },
        {
            "Address": {
                "StreetAddress": "1 Independence Way",
                "City": "Cranston",
                "State": "RI",
                "StateName": "Rhode Island",
                "Zip": "02921",
                "County": "Providence",
                "Country": "US",
                "CountryFullName": "United States",
                "SPLC": null
            },
            "Coords": {
                "Lat": "41.78962",
                "Lon": "-71.500717"
            },
            "StreetCoords": {
                "Lat": "41.789651",
                "Lon": "-71.50067"
            },
            "Region": 4,
            "POITypeID": 0,
            "PersistentPOIID": -1,
            "SiteID": -1,
            "ResultType": 6,
            "ShortString": "1 Independence Way, Cranston, RI, US, Providence 02921",
            "GridID": 6393356,
            "LinkID": 420,
            "Percent": 2126,
            "TimeZone": "EST"
        },
        {
            "Address": {
                "StreetAddress": "1 Independence Way",
                "City": "Princeton",
                "State": "NJ",
                "StateName": "New Jersey",
                "Zip": "08540",
                "County": "Mercer",
                "Country": "US",
                "CountryFullName": "United States",
                "SPLC": null
            },
            "Coords": {
                "Lat": "40.360723",
                "Lon": "-74.599963"
            },
            "StreetCoords": {
                "Lat": "40.360684",
                "Lon": "-74.600003"
            },
            "Region": 4,
            "POITypeID": 0,
            "PersistentPOIID": -1,
            "SiteID": -1,
            "ResultType": 6,
            "ShortString": "1 Independence Way, Princeton, NJ, US, Mercer 08540",
            "GridID": 15414796,
            "LinkID": 926,
            "Percent": 5215,
            "TimeZone": "EST"
        },
        {
            "Address": {
                "StreetAddress": "1 Independence Way",
                "City": "Brenham",
                "State": "TX",
                "StateName": "Texas",
                "Zip": "77833",
                "County": "Washington",
                "Country": "US",
                "CountryFullName": "United States",
                "SPLC": null
            },
            "Coords": {
                "Lat": "30.249221",
                "Lon": "-96.363437"
            },
            "StreetCoords": {
                "Lat": "30.249173",
                "Lon": "-96.363447"
            },
            "Region": 4,
            "POITypeID": 0,
            "PersistentPOIID": -1,
            "SiteID": -1,
            "ResultType": 6,
            "ShortString": "1 Independence Way, Brenham, TX, US, Washington 77833",
            "GridID": 16623332,
            "LinkID": 257,
            "Percent": 2033,
            "TimeZone": "CST"
        },
        {
            "Address": {
                "StreetAddress": "1 Independence Way",
                "City": "Doylestown",
                "State": "PA",
                "StateName": "Pennsylvania",
                "Zip": "18901",
                "County": "Bucks",
                "Country": "US",
                "CountryFullName": "United States",
                "SPLC": null
            },
            "Coords": {
                "Lat": "40.312962",
                "Lon": "-75.149676"
            },
            "StreetCoords": {
                "Lat": "40.313006",
                "Lon": "-75.14971"
            },
            "Region": 4,
            "POITypeID": 0,
            "PersistentPOIID": -1,
            "SiteID": -1,
            "ResultType": 6,
            "ShortString": "1 Independence Way, Doylestown, PA, US, Bucks 18901",
            "GridID": 1259020,
            "LinkID": 461,
            "Percent": 2705,
            "TimeZone": "EST"
        },
        {
            "Address": {
                "StreetAddress": "1 Independence Way",
                "City": "Edgewater",
                "State": "NJ",
                "StateName": "New Jersey",
                "Zip": "07020",
                "County": "Bergen",
                "Country": "US",
                "CountryFullName": "United States",
                "SPLC": null
            },
            "Coords": {
                "Lat": "40.810277",
                "Lon": "-73.987319"
            },
            "StreetCoords": {
                "Lat": "40.810305",
                "Lon": "-73.987367"
            },
            "Region": 4,
            "POITypeID": 0,
            "PersistentPOIID": -1,
            "SiteID": -1,
            "ResultType": 6,
            "ShortString": "1 Independence Way, Edgewater, NJ, US, Bergen 07020",
            "GridID": 8250892,
            "LinkID": 414,
            "Percent": 6588,
            "TimeZone": "EST"
        },
        {
            "Address": {
                "StreetAddress": "1 Independence Way",
                "City": "Falmouth",
                "State": "ME",
                "StateName": "Maine",
                "Zip": "04105",
                "County": "Cumberland",
                "Country": "US",
                "CountryFullName": "United States",
                "SPLC": null
            },
            "Coords": {
                "Lat": "43.761429",
                "Lon": "-70.325684"
            },
            "StreetCoords": {
                "Lat": "43.76137",
                "Lon": "-70.325677"
            },
            "Region": 4,
            "POITypeID": 0,
            "PersistentPOIID": -1,
            "SiteID": -1,
            "ResultType": 6,
            "ShortString": "1 Independence Way, Falmouth, ME, US, Cumberland 04105",
            "GridID": 11520524,
            "LinkID": 131,
            "Percent": 838,
            "TimeZone": "EST"
        }
    ]
}

Sample Request with includeTrimblePlaceIds=true

Here is an example query using coordinates for a Costco distribution center in New Jersey.

The URL for the request is:

https://singlesearch.alk.com/na/api/search?authToken=<APIKEY>&query=40.3559242765905,-74.451975067144&includeTrimblePlaceIds=true

Sample Response with includeTrimblePlaceIds=true

{
  "Err": 0,
  "Locations": [
    {
      "Address": {
        "StreetAddress": "",
        "City": "Monroe Township",
        "State": "NJ",
        "StateName": "New Jersey",
        "Zip": "08831",
        "County": "Middlesex",
        "Country": "US",
        "CountryFullName": "United States",
        "SPLC": null
      },
      "Coords": {
        "Lat": "40.355924",
        "Lon": "-74.451975"
      },
      "Region": 4,
      "POITypeID": 0,
      "PersistentPOIID": -1,
      "SiteID": -1,
      "ResultType": 14,
      "ShortString": "Monroe Township, NJ, US, Middlesex 08831"
    },
    {
      "POITypeID": 0,
      "PersistentPOIID": -1,
      "SiteID": -1,
      "ResultType": 17,
      "ShortString": "0xztR_iLMWM0eZWyV3GACigA, Costco #175",
      "TrimblePlaceId": "0xztR_iLMWM0eZWyV3GACigA",
      "PlaceName": "Costco #175",
      "SiteName": "Costco #175"
    },
    {
      "POITypeID": 0,
      "PersistentPOIID": -1,
      "SiteID": -1,
      "ResultType": 17,
      "ShortString": "0x4Y4CTmYr6kauPugLT9k4zg, Costco #265",
      "TrimblePlaceId": "0x4Y4CTmYr6kauPugLT9k4zg",
      "PlaceName": "Costco #265",
      "SiteName": "Costco #175"
    }
  ]
}

Sample Request with LocalArea

Available in the U.K., Ireland, and Brazil only

In countries outside of North America, addresses may include a local administrative area—a neighborhood, district, village, or similar—in addition to the city. In the U.K., Ireland, and Brazil, single search can now take into account a local area in order to return fewer and better location matches. It also returns the local area, if available, in the LocalArea field.

Here is an example in the South of England.

The URL for the request is:

https://singlesearch.alk.com/eu/api/search?authToken=<APIKEY>&query=1+Harewood+Green,+Keyhaven,+Lymington,+Hampshire

Sample Response with LocalArea

{
  "Err": 0,
  "Locations": [
    {
      "Address": {
        "StreetAddress": "1 Harewood Green",
        "LocalArea": "Keyhaven",
        "City": "Lymington",
        "State": "ENG",
        "StateName": "England",
        "Zip": "SO41 0TZ",
        "County": "Hampshire",
        "Country": "GB",
        "CountryFullName": "United Kingdom",
        "SPLC": null
      },
      "Coords": {
        "Lat": "50.723477",
        "Lon": "-1.569717"
      },
      "Region": 3,
      "POITypeID": 0,
      "PersistentPOIID": -1,
      "SiteID": -1,
      "ResultType": 6,
      "ShortString": "1 Harewood Green, Keyhaven, Lymington, ENG, GB, Hampshire SO41 0TZ",
      "TimeZone": "+1:00"
    }
  ]
}

WEB SDK & APIs

INTERACTIVE MAPS

SOAP APIs (Web Services)

RESTful APIs (Web Services)

MOBILE SDK & APIs

COPILOT NAVIGATION

INTERACTIVE MAPS

Single Search Geocoding API

Getting Started

Endpoints

`GET` /search

Test the API Now

Test Response

Ways to Improve Search Speed and Results

`GET` /search/types

`GET` /search/poiCategories

`GET` /search/poiTypes

`GET` /search/countries

`GET` /search/states

Example Queries

Fielded Search

Example

Example

Single Search Response

Response Parameters

Address

Coords

Error Codes

Sample Request

Sample Response

Sample Request with Metadata

Sample Response with Metadata

Sample Request with includeTrimblePlaceIds=true

Sample Response with includeTrimblePlaceIds=true

Sample Request with LocalArea

Sample Response with LocalArea

WEB SDK & APIs

INTERACTIVE MAPS

SOAP APIs (Web Services)

RESTful APIs (Web Services)

MOBILE SDK & APIs

COPILOT NAVIGATION

INTERACTIVE MAPS

Single Search Geocoding API

Getting Started

Endpoints

GET /search

Test the API Now

Test Response

Ways to Improve Search Speed and Results

GET /search/types

GET /search/poiCategories

GET /search/poiTypes

GET /search/countries

GET /search/states

Example Queries

Fielded Search

Example

Example

Single Search Response

Response Parameters

Address

Coords

Error Codes

Sample Request

Sample Response

Sample Request with Metadata

Sample Response with Metadata

Sample Request with includeTrimblePlaceIds=true

Sample Response with includeTrimblePlaceIds=true

Sample Request with LocalArea

Sample Response with LocalArea

`GET` /search

`GET` /search/types

`GET` /search/poiCategories

`GET` /search/poiTypes

`GET` /search/countries

`GET` /search/states