API docs by Redocly

Reverse Geocode API (1.0.0)

License: Magic Lane Terms of Service

Reverse Geocode API returns the detailed address information of a given location coordinate

Reverse geocode

Returns detailed address based on a geographical filter

Returns detailed address based on a geographical filter:

  • location: around a latitude, longitude location
  • area: inside a polygon, circle, bbox area type
  • along: along a polyline path using radius field
Authorizations:
ApiKey
header Parameters
Authorization
required
string

User API token

Request Body schema: application/json
required

Reverse geocode parameters

at
Array of numbers <float> [ items <float > ]

Reference coordinate as lon, lat array

object or object or object (in)
One of
required
object or object (polygon)
One of
polyline
required
string <Google polyline 5>

Polyline path

coords
Array of numbers[ items <float >[ items <float > ] ]

Polygon coordinates

object (circle)
center
required
Array of numbers <float> [ items <float > ]

Circle center as lon, lat array

radius
required
integer

Circle radius in meters

object (bbox)
east
required
number <double>

East longitude

west
required
number <double>

West longitude

south
required
number <double>

South longitude

north
required
number <double>

North longitude

object or object (along)
One of
polyline
required
string <Google polyline 5>
coords
Array of numbers[ items <float >[ items <float > ] ]

Polyline path coordinates

radius
required
integer

Along polyline radius in meters

limit
integer
Default: 15

Results count limit

locale
string
Default: "en"

ISO 639-2 / ISO 639-3 language code for the result

debug
boolean
Default: false

If true the result is beautified for easy human read

Responses

Response Schema: application/json
Array
object
copyrights
string
Array of objects
Array
coordinates
Array of numbers <float> [ items <float > ]

Location coordinates as lon,lat float

entrance
Array of numbers <float> [ items <float > ]

Location entrance coordinates as lon,lat float

name
string

Address location name

object

Location address

street name
string
street number
string
postal code
string
settlement
string
city
string
county
string
state
string
country
string
country code
string
object

Location contact data

URL
Array of strings

List of location Urls

Phone
Array of strings

List of location phones

Email
Array of strings

List of location emails

distance
integer

Distance in meters from 'at' ref cooordinate

Request samples

Content type
application/json
{
  • "in": {
    • "polygon": {
      • "polyline": "ewkvH}tki@dvAeAzEdAj@xG|ExG?vRwAdAk@kCeC?j@~IdCdAvApE?~TmK~IwAkC}EjCk@xGiGgAvArEoDpEiGkN}EeA?rEhG|I?lCyLdLk@~Ihd@_`@dCrEnD?cCyGnDyGtHeAzW_UdCfA?jNqDjYwApf@oDpE?rEvAdAwAxGm@bWoVfAeN|I?rEbC?`JyGnV?l@~_@nD??yRpDqE?sE}E??}T|Ekd@vAqf@nDkYl@yRnVwRbCpEoDxG?pEbC?bCqExA?yA_U~PqPpDdA?~TrHkNl@mNzE}I?bWdC?vAqEj@xGpDvG?rEbC?vAyGhGdA?qEcCmCyAwGdCeAnD_Jj@pEwAdA?lCtH~IvAjNxAdA?~IbCjCj@~I}ExGoD?eCvG?~IsHdLm@_JxAeA?yGqDkNcC?wAqEeC?wAjC?rEnDgAxAlCk@pPnDqEj@dAk@jYk@dAwAyGqD?j@dL{EdAvA~IuHjN}EeA?rExApEbC?nh@}`AhGjNgNdWcCdA}ElNcC?eCvGoDdA}ExGj@jCcCxGtHdAk@_JbCkCdCxGm@~IgGdA?pEqDrEoD?m@jCsHjC?rEdNmC|EwGnDeAlKeWj@jCdCkCk@sEtHkNvAlCbC?j@_JzLsEnDwG|E?|E|IrHlCpDpP}EjC?xGoDdA{LjYgGjCiGjYk@dLiGfA?vGbCeAxAjC?xGnD?j@qP|EdA|EyGxLeAnDxG?pEpDlCvAdLdCdAbC~IiGjY?pEdC?nDkN|E?k@yGzEwGxA|IqDlC?pEbC?`JkN|ExG?~IbC??_JcCyGj@qE|EdAj@mCj@lCtHdAiGjN?xGdC?zEyG|EkNj@pEpD?vAlCwAjC?rEbCdA?vGnDrEl@pEuH?yAlC?vRoDdA?xGnD?hGrEj@pPdC?vAkC?sPbCwGxAsPxL?j@kCpD?j@~TzEpEk@jCcCeA?dLvA?j@rExA?j@jCuH??xGbCdL}EpE?rEwAjCcC?yL~IuZxGoVdLmKgAiGqEqDdA?rEpD?xLvG|E?nVeLbg@kNvAxG}E|T?xRpD|j@nD?cCq[?kNwAsE?}IvAgAvAqPvAeA?yGwAeAj@kC|WyRfG?dCeLbC?vAqEl@jCbC?|EeLtH?rH~I?jCpDlC?vGwAdA?rEvAdA?xRwAvRiGjNwA??rEbC?|E_Jj@p[bC?xAeLm@qP|EsE?wGiG?xAeL?_UbCsEqD}TxAeWdNeWvArEpDjCk@xGyAdAcCmCcClC?jNzE??kC|EsEnDdL?~IwAjCj@jYcClCvAjYdC?vAy]k@qPzEeA?sEcCkCwAkYmKkYbr@eWdC~I?heAeCrEgG?m@vGxAfA?pEhG?zEjNyLlC?vGlK?j@kCdC?nDdL?pEpDrPnD?cCkN?_UeCdAwAkCk@yRiGcb@j@w~@wAyGjRqEj@vGbCdAxApf@nDfAk@s[bCkC?qEcC?cCeLpOsEhGyGvAfA?pEdCrEbC??yGqD_Jl@kCnDvGdC?j@xGdNdWwAxGmKdLvApP|EvR`JrP?jCvA?dNp[?_JoDeLsOcWuHs[?wGtHeLdCdAbCxGbC??sEgG_J?qEyAeAwA_JqOkYm@kNvSyh@hGeAk@_JtHcW|EyGbCdAj@xG}EjNoDjCj@~IbC?l@_J`JkNrHjN?lCpDjC?jCbC?xAlC{Lv]?vRxA?vArE?p[qDxGcC??vGbC?|ErPpD?uH_U`JkCj@vGbC?hGlN~P?nDvGhGpf@vA?pDxGvAdLbC??sEgGwReCkC?yG{EkYvAsEnDkCpDdAk@wGzEmN?qEcC?qDpPoDeA?rEwAjCk@yGvA_JvAeA?qEcC_JvAkC|E?j@pEnD?j@kCdC?k@yGnDyGvA?pDwG`J?vAjC|EdAj@rEbC?xAvG`J~IzE??qEwA?cCsE?qEiGeAyLmN?qPfGqEj@jCwAdAk@jNtHeAbCdLpD?j@qEpDdAj@eLeC?cCsEnDwGk@_JpV?xLpPvAdLcCdA?rEnDjCk@|j@pD?j@cm@zEkC?sEwAeAcCjCeCkNiRkYwe@??kCbUeb@qD?}Pp[eCwGoD?vAjN}EpPgGeL?yGqDeApDqEnD??kChGyG?sEcC?iGxGeCsEoDfAcCyGfGeA?yGpDeLk@wGsOv]aJjCk@xGk@yRqDwGdC_U?kNqDeA?pPcC~TeCdAk@dL{E??pEnDdAuHfAk@pEiGeL{EeAeCyG}PqPj@kCvA?j@_JlKkNpD??mCtHkNzEkChGqPpDpEpOjCdClC?pEuHrE?vGbC?vAkCpDrEbC??yGhGkCj@|IpDlCvAvGbC?j@wGpDdAvA~IdC?j@_JsOeLj@sEdCkCxLxG?~IbC?xAsEnDrEcCp[bC?|EpE?wGqDsEpDyGnDrEwAjC?rEhGeA?yGyL_UgNkNeN_JaJeA}EyGiGdLwA?cCqE{LkCcCyGcC?yAkC|E}vAvAeA?eWdCpEnDfAj@pEpDeAbCjC?lC`JjCvAjCk@lC|E?tHpEbCrE|EdAhGdLnD?tHpE|E~IyArE?vGdCkCvAdAdCdWyAvRxA~j@bC?j@yGwAeb@bC}_@k@dAwAkCk@_UvAkCtHpEj@lCfYvGfN~IxLjCj@lCdC??sEqDqEko@_UgN_Jk@kCvAsEtHfA?sE{EqEbCs[qD?cCjYoDlCj@dLyAjCcU_J{EqE`J_`@}EdAiGjYgYwRk@kCiGsEcC?yAqEaJyGk@dAcCyGqDeA?kN|E_J?wGeCgAdCu~@zWmCvAkCpDdWtHeAbCjC?jC|WdA?kCbCeA|EdLyAjC?dL|EjNlK?vAkC|E?vAjCj@xGcCdAcCrP?vRnD?vAkNdC~IbC??sEcCwGbCsE?_JdC?j@xGbC?j@yGhGdAj@}IpD?vAmC`JkC?yGiGdAk@}IoDmCbCwGqD?wApEiG?l@_JqDeAj@eLvAkCgGyG?_UyAeApDeLfYqErO??pEnDrP?~I{EjCwApPnD?j@kCvA?|E~IpDdA?pEuHx]}EmC?xGbCdAk@xGpD?j@mCbCfAk@eLtHs[j@rEvA?|E~IdC??sEiGwGbCmC?qEcCmCiGfAwAmCdNqE?sEuH?k@qEoD?j@pEeCdAcCwGk@eLvAmCbC??qExAeA?sEeCqExAkCvAdA?jCnD?j@yGtH?xAlCqDjC?pEpDrEbC?vAsExA?m@wGpDeAbCsE`\\kC?sElKeLj@lC`J?hGpE?wGwAmCkRqEoDyGm@_JaJeLl@kCiY}`Aj@yGvAeA?qEoDmNiGeLoDeAk@qEgN_JcCsEaJfAqDyG?yGcC?eC~IcC?k@xGuHmChGqE?kC`JeL?sE{LrEeNgAoDwGeCjCwAkCbCeA?sE{E?}EqEwA_JeCeA?sEcC?j@jNhGxGj@dLvA?dCpEj@~IvAdAj@lNcCpEyA??jCcClCoD?yAeLmKeAk@sE|E??kCbCmC?wGwA?wAyGeC?k@jCk@kCiGeAuHxGk@dLk@yGwAeA?sEeCkCdCkCzEyRxAdLfGkC?sEgGeLnDqEwAyG?kNbCeAdCpEvAeAqD_JdCqE?sEqD?k@xGiGxG?dLoDgAk@lCeC??~IaJ??vGoDdAk@lNyAdAuH_JwAdA?rEvA?xAvG`JxGeCxG?pEpDrEiGvRoD_JqDkCk@dAwAqEuHsEk@qEbCsE?qEcC?yApEcC?k@xGwAeAbCko@|EsEj@}IqDgA?rEwA?j@kYwAyGqD?k@~IdClC?jCeCdA?pEvAfA?bW{Edx@k@jd@uHhd@qDrEwAxGwA?yApPcUdb@cC?oDpE?jCkRjYeC?}PxRmo@jd@mKpEuH?k@jCiGfA}EpE{EkC_Q~I?jC}EpEwAxGmK?}Ecm@`JkNpD|IhG?j@kCzi@eWbCqEhGmCzWcWxAsPfGeAdCqEzEdArOy]|EkCnDkNcCsEuHlCk@pE_QeA?qEvAmChGlC?mCbCqExA?k@eLuHeLeC?k@mCpDwGfGpE?wGwAmCpDqEk@_JzEyRpDxG?yGwAqEvAeAj@eWvAkCvAjCk@jCpDdAk@~I`JeA?qEbCgAdCwGvA??_JvAsEvAlNdC?vAvGhGeAvAjC?xGbC??kNwAkCvAgAj@kYxAeA?qEqD_UdCeLeCkNvAqExA_UyAeAl@_JeC_JhG?j@wRvAgA?qEwAeA|EsE?qEhGeLlKeL?yGgNpPoDqEuHjC?lCwAdAm@jNcCxGwAyGeC?wAkCj@mC|E??wGwAmCeC?oDxGsOyRaJqPoD??rEzEjCdC~IjRdWyAjC?jNpDrEvAjNk@dAwAsEeC?wAdLwAkCeC?k@jCwA?cCrPqD?oDvGyAeAmKxRwAvGnD?hGrP{EvG?xGvAdA?rEbC?dC|IeCrEuHpE?lCwAdAj@xGoDvGiGq[iG_JmKqE|EyRm@_JxAqE?_JeC?oD~Ij@xRqDjNk@mCyL?iGqEuHjCoDqEeCdAaJkCcCyG?eLnDsEl@cW`J?eCyGoDeA?yGfGq[k@yGpDwGbC??sEuH?wAkC?_JtHeLhGjCvAeL|EqE?yGeCdAcCxGiGdAiG~IgG?m@jCwAkCwAjCk@qE}EsEcCkNqD??rEdC|IqDlC?pEpDdAj@lCwAjCeCkCoDdA?pEnDfAoDjC?jCqDrEcCmCk@}IqDgApDeA?wGnDsPk@wRcCeAzEy]?_JcC?qD~TwAp[wAdA?~IqDxGuHqPcC?j@|I|ElCk@jCgN?oDxGeC?uHvGaJxRaJjC?_J|EqEnD?l@kCeCyGiGeA?yGdCeA?sEeCeAk@qEcC?wAjCeCkC{Ekd@eC??~IvAvGwAlCoD??pEfG?xAxGyAjCk@kCcCjCnD~IaJrE?pEdCjCj@xGbCdAk@~IoVxGcCsEeC?k@lCoDdA?pExL?j@lChGdApOsExAkCtHdAvA~I?dLvA?bCpE?dW{E~I}E?cCkC?sEyAkCcC?vAjNxA?j@jCiGlCcCgAeCwGcCjCj@jCcClCiGmCuHfAk@sEeCkCcCvGeN?uHqEvAwRqDgAcCqPhGeAj@sEhGkC?yG}ElCiGeWk@kN}EdAk@sEhGeLj@wGvA~IhGdA?pEpD??eLwAeAj@eA`J?j@jCeClC?vRxAdA`JkC?sEeCqEdCkCj@yGbCdAk@pPdC??wGbCmCj@wGlK?vAmC?wGgGjCiG?}EkCxAsEzE?wAwGvAeLtHmCj@eL{ErE}E?wAjCiGkCuw@eAm@jCwAeAoD~IeCdAiGsEoD?qD~IdCp[k@xGyAeAk@eLyLjCcCjCm@x]dC?vAyGhG?j@xGbCjC?xGaJvG?lCcCpEk@wGuHjCj@jNmKrE?pExL?vAjCwAxGkRxG?pPpDxGj@hd@cC?eCqE{EeAqDdAoDxGm@_UcCkNcC?vAbb@yLfAeCpEoDqEnDsE?qEcCeAwAeWyAgAk@wR{EeA?pEvAfA?bLvAlCcCdL}E?iGeLoDdA?pEnD?hGfLwAjC?pElKlChGdLeC|IuH~Il@~IeCrEyL_J}E?uH~Ij@|TdC?j@rEhGeAvAyGj@jChGdAiG~IaJdAj@rPaJvGiG?{EqEwAkd@qD_Jj@kC|EeA`JeL?yGaJdLuHdAuHqPuH_Jk@dAaJwRcCdA?pEnDfA|E|I?lCbC?tH~InDdL?vG|E~T?~TdCv]{LpE}fAxRwAkC?sEoD??dLkRrE?pEtH?zEkCtHjCj@qEtHmC|E?j@rEpDeAj@vGvAdAwAlC?~IqDvG?rEdC?zEsPdCeAk@_JnDeAj@wGdCsEtH?vAeAj@yGnVkCj@dAwAdAj@dAcC~I?xGyAdA?xGdC?bCsEj@dLhGkCvAjCwAdL{ExG?pEbC?vAwGpD?bC_Uj@xGdC?nDyGpDrEj@mChGeAbCeLbC?wAqPvAeAj@_JcC?oDjCm@rEwA?wAeLnVmNvA~ThGeAj@sEtH?j@qE`JeApDsEtHlCvAsE|E?nDrE`JmCj@~I|E?bCrEtH?pDpEgNjo@oDdAeCkCoD?uHpEwAeLeCqEgG?uHjCmK~Im@jCwA?uHdL{EjN_Qdx@yLhY?rEbC??kC|E_JvA??sEhGwGyAmCfNw]vAeWtHqPvA?|E_JlKqEdCpErHeAxApEk@xRvA?j@jCcClCm@pEaJjCmKeAk@kCuHeA?pEwAdAj@lNvAjCdC?nDeLtH?dCjC?lCcJdLqO?k@vGlK?qDxGsHjCeCqE}E?oDvGk@eA?xGzE??jCcUdL{WxRcCvG}WjNgGdLyAkC{E?qDrEoh@?k@mCiGeAcCdA?rEvAjC{EdA?xGzEjCwArEyLdAk@kCkd@jC?pEhG?j@lC`JmCvArEdC??kCvAgAbC~IdC??kCbCsE?dLpD?vAwGj@pEnD?pDrEqDdAk@pPwAlCksAgAiGlC?pE"
      }
    },
  • "at": [
    • 4.35685,
    • 50.85118
    ],
  • "limit": 2
}

Response samples

Content type
application/json
[
  • {
    • "info": {
      • "copyrights": "MagicLane"
      },
    • "results": [
      • {
        • "coordinates": [
          • 6.85524,
          • 50.951736
          ],
        • "name": "Give Way Sign",
        • "address": {
          • "settlement": "Lindenthal",
          • "city": "Cologne",
          • "state": "North Rhine-Westphalia",
          • "country": "Germany",
          • "country code": "DEU"
          },
        • "distance": 175495
        },
      • {
        • "coordinates": [
          • 6.855488,
          • 50.951529
          ],
        • "name": "<50> Leinsamenweg",
        • "address": {
          • "street name": "Leinsamenweg",
          • "street number": "50",
          • "postal code": "50933",
          • "settlement": "Lindenthal",
          • "city": "Cologne",
          • "state": "North Rhine-Westphalia",
          • "country": "Germany",
          • "country code": "DEU"
          },
        • "distance": 175511
        }
      ]
    }
]