api.automapa.comv3 - todos los sistemas normales

Geocodificar una dirección

Geocoder.geocode

Convierte una dirección estructurada con el campo city obligatorio en coordenadas y detalles de la dirección coincidente.

POST/v3/Geocoder/geocodeapi.automapa.com

Parámetros del body

Cuerpo de la solicitudTipoDescripción
addressobject REQUERIDOProporcione un objeto de dirección con el campo city obligatorio. Los demás campos son opcionales; incluya suficientes datos para encontrar una coincidencia.
countrystringCódigo de país opcional. Si falta o es null, se usa PL; un valor vacío permanece vacío. Use PL en mayúsculas para direcciones polacas. La geocodificación internacional requiere acceso adecuado.
provincestringNombre de provincia opcional; no se completa automáticamente.
districtstringOpcional. Ausente o null toma una cadena vacía.
communitystringOpcional. Ausente o null toma una cadena vacía.
citystring REQUERIDOEl nombre de ciudad city es obligatorio en cada dirección, también para PL.
quarterstringOpcional. Ausente o null toma una cadena vacía.
pcodestringOpcional. Ausente o null toma una cadena vacía.
streetstringOpcional. Ausente o null toma una cadena vacía.
housestringOpcional. Ausente o null toma una cadena vacía.
maxResultintegerPara direcciones polacas, hasta 1–3 coincidencias por dirección (1 por defecto). Los valores fuera del rango se limitan a 1–3. Establezca maxResult en cada dirección; maxResults no establece este límite.

Solicitud de ejemplo

{
    "address": {
        "country": "PL",
        "city": "Warszawa",
        "street": "Domaniewska",
        "house": "37"
    }
}

Respuesta de ejemplo

{
    "result": [
        {
            "quality": 9,
            "x": 21.0071318,
            "y": 52.18284,
            "country": "PL",
            "province": "mazowieckie",
            "district": "Warszawa",
            "community": "Warszawa",
            "city": "Warszawa",
            "quarter": "Mokotów",
            "pcode": "02-672",
            "street": "Domaniewska",
            "house": "37",
            "resultRadius": 0,
            "flat": ""
        }
    ]
}

El ejemplo muestra una selección de campos de respuesta. Las coordenadas y los datos postales reales dependen de la entrada y de los datos cartográficos actuales; también pueden aparecer campos ampliados sujetos a permisos.

campos result

campos resultTipoDescripción
qualityintegerGeocoding quality score.
xdoubleLongitude (WGS84).
ydoubleLatitude (WGS84).
countrystringCountry code.
provincestringProvince.
districtstringDistrict (powiat).
communitystringCommunity (gmina).
citystringCity.
quarterstringQuarter.
pcodestringPostal code (PL only).
streetstringStreet.
housestringHouse number.
addressTypeinteger EXTENDIDOBuilding type. Extended.
peoplesForAddressinteger EXTENDIDOResidents at address. Extended.
flatsForAddressinteger EXTENDIDOFlats at address. Extended.
buildingsForAddressinteger EXTENDIDOBuildings at address. Extended.
pcodeExtraInfoobject[] EXTENDIDOExtra postal-code info. Extended.
resultRadiusnumberResult envelope radius (m). -1 if unknown.
mapLinkstringLink to map result.