v1

latestOpenAPI 3.0.32026-07-242666111.1 KB
super-geocoding

super geocoding

post/api/v3/super-geocoding

Request body

address_linesstring[] required
region_code'MX' | 'US' | 'CO' | 'PE' | 'CL' required
algorithm'FAST' | 'EXPENSIVE'

Example request

{
  "address_lines": [
    "Calle Masaryk 29",
    "Anzures"
  ],
  "region_code": "MX",
  "algorithm": "FAST"
}

Response

Successful Response

statusstring required
addressstring required
locationobject required
uncertainty_in_metersnumber
place_idstring required
plus_codeobject required
place_typesstring[] required
unconfirmed_component_typesstring[]
algorithmstring required
creditsinteger required

Example response

{
  "status": "VALID",
  "address": "Calle Masaryk 29, Anzures, Miguel Hidalgo, 11590 CDMX, México",
  "components": [
    {
      "confidence": "CONFIRMED",
      "name": "Calle Masaryk",
      "type": "street"
    },
    {
      "confidence": "CONFIRMED",
      "name": "29",
      "type": "street_number"
    },
    {
      "confidence": "CONFIRMED",
      "name": "Anzures",
      "type": "neighborhood"
    }
  ],
  "location": {
    "latitude": 19.4356382,
    "longitude": -99.181854
  },
  "uncertainty_in_meters": 10.539512,
  "place_id": "ChIJczyrNaz40YUR2CgG_IrhgkQ",
  "place_types": [
    "premise"
  ],
  "unconfirmed_component_types": [
    "street_number"
  ],
  "algorithm": "FAST",
  "credits": 1
}