Geocode

Overview

Geocoding allows you to retrieve GPS coordinates and complete address info for searched address.

Request

API Reference

Geocoding service is located under one of the following API references:

https://eu-geocoding.api.sygic.com/v0/api/geocode
https://na-geocoding.api.sygic.com/v0/api/geocode

Methods

  • GET

Parameters

Required Parameters

Sygic's Geocode function can work as free text geocoder or as a structured geocoder. Please note that these two methods cannot be combined and are mutually exclusive.

  • Free text is defined with combination "location" & "key" parameters
Parameter Data type Description
location string Free text geocode location.
key string The API key.
  • Structured is defined with "country", "city", "street", "house_number" and other optional parameters & "key"
Parameter Data type Description
country string Country name can be entered as abreviation, translated, or as full name in English.
city string
street string
house_number string
key string The API key.

Optional Parameters

Optional parameters are only applicable when working with structured geocoder, and will not work when using free text geocoder.

Parameter Data type Description
suburb string
zip string
admin_level_1 string

Response

GET

GET https://geocoding.api.sygic.com/v0/api/geocode?country=Deutschland&city=Berlin&street=Bernauer%20Stra%C3%9Fe&house_number=12&zip=13355&key=yourAPIkey

Response body

{
    "results": [
        {
            "location": {
                "country": "Germany",
                "city": "Berlin",
                "street": "Bernauer Straße",
                "house_number": "12",
                "zip": "13355",
                "admin_level_1": "Berlin"
            },
            "geometry": {
                "lat": 52.53686,
                "lon": 13.39268
            },
            "confidence": 0.661186951754386
        }
    ],
    "status": "OK",
    "copyright": "© 2018 Sygic a.s."
}