Get details of an autocomplete suggestion

  1. Introduction
  2. Required Parameters
  3. Optional Parameters
  4. Address Details example
  5. Responses
  6. Usage limits


Woosmap Address Details endpoint provides details of an autocomplete suggestion (using the suggestion public_id).

Required Parameters

Certain parameters are required to initiate a Details request. As is standard in URLs, all parameters are separated using the ampersand(&) character. Few parameters are mandatory like the public_id which must be present in addition to a Woosmap API key.{PUBLIC_API_KEY}



The identifier of the autocomplete suggestion. (public_id can be retrieved in the autocomplete response)


Your project’s API key. This key identifies your Woosmap Project for purposes of security and quota management. Public keys are designed to be used client side, where every request contain a referer.

Reminder: To use the Address API, your Public API key (parameter key) has to be authorized for the domains and/or IPs (referer) where you make the call. More on securing API keys here.


Your project’s private API key. This key identifies your Woosmap Project for purposes of security and quota management. Private keys are designed to be used server side, no referer checking associated with those keys.

Optional Parameters


The language to return the address elements in. Must be a ISO 639-1 language code.


You can use this parameter to limit the returning fields (by default, all fields are return).

Available fields are (geometry) (fields should be separated by a ,). By using this parameter you will limit content of responses to the geometry part. No address component provided.


To specify the format for the short country code expected to be returned in the address_components field (default is alpha3).

Available cc_format values are alpha2 or alpha3.

Address Details example

The following example requests the details of an address by specifying the required public_id:

Address Details call
        curl -L -X GET '' \
-H 'Referer: http://localhost'

        var requestOptions = {
  method: 'GET',
  redirect: 'follow'

fetch("", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

        var axios = require('axios');

var config = {
  method: 'get',
  url: '',
  headers: { 
    'Referer': 'http://localhost'

.then(function (response) {
.catch(function (error) {

        import requests

url = ""

headers = {
    'Referer': 'http://localhost'

response = requests.request("GET", url, headers=headers, data=payload)


        OkHttpClient client = new OkHttpClient().newBuilder()
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
  .method("GET", body)
  .addHeader("Referer", "http://localhost")
Response response = client.newCall(request).execute();

        require "uri"
require "net/http"

url = URI("")

https =, url.port)
https.use_ssl = true

request =
request["Referer"] = "http://localhost"

response = https.request(request)
puts response.read_body



Address Details API endpoint provides a JSON response containing one root element, result which contains the serialized address result.

Address Details Response
      "formatted_address": "London, England, United Kingdom",
      "types": ["locality"],
      "public_id": "aGVyZTpjbTpuYW1lZHBsYWNlOjIwMzM3NDU0",
            "types": ["country"],
            "long_name": "United Kingdom",
            "short_name": "GBR",
            "types": ["state"],
            "long_name": "England",
            "short_name": "England",
          { "types": ["county"], "long_name": "London", "short_name": "LDN" },
            "long_name": "London",
            "short_name": "London",
            "types": ["locality"],
            "long_name": "SW1A 2",
            "short_name": "SW1A 2",
            "types": ["postal_code"],
          "location_type": "GEOMETRIC_CENTER",
          "location": { "lat": 51.50643, "lng": -0.12719 },
              "northeast": { "lat": 51.68629, "lng": 0.28206 },
              "southwest": { "lat": 51.28043, "lng": -0.56316 },
  "status": "OK",



A result contains the following fields:


Contains the text description of the proposal to be used as prediction in drop down list if needed.


Contains the type of result. Can be any value from following list:
house_number route address_block locality admin_level country


The public_id of the result (return by autocomplete endpoint)


Description of all the components of the address (long and short). Those fields are provided when no fields parameter is set in the request.


The geometry and the viewport of the result.


Returns more info on if the request was successful or not, valid responses:

OK indicates the response contains a valid result.
INVALID_REQUEST indicates that the provided request was invalid (e.g. wrong URL syntax).
REQUEST_DENIED indicates that the service denied use of the Address API (e.g. wrong API Key, wrong/no referer, …).
UNKNOWN_ERROR indicates an Address API request could not be processed due to a server error. The request may succeed if you try again.

Usage limits

The following usage limits are in place for the Address API on the /details endpoint:

Was this article helpful?
Have more questions? Submit a request