api.automapa.comv3 - todos los sistemas normales

Geocodificación por lotes

Geocoder.geocodemulti

Geocodifica hasta 100 direcciones estructuradas por solicitud. Cada una requiere city; los resultados siguen el orden de entrada.

POST/v3/Geocoder/geocodemultiapi.automapa.com

Parámetros del body

Cuerpo de la solicitudTipoDescripción
addressesobject[] REQUERIDOProporcione hasta 100 objetos de dirección, cada uno con el campo city obligatorio. Se aplican las demás reglas de geocode; los resultados siguen el orden de entrada.
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

{
    "addresses": [
        {
            "country": "PL",
            "city": "Warszawa",
            "street": "Domaniewska",
            "house": "37"
        },
        {
            "country": "PL",
            "city": "afdsgsd",
            "street": "asdfsdf",
            "house": "1"
        },
        {
            "country": "PL",
            "city": "Rumia",
            "street": "Grunwaldzka",
            "house": "2",
            "pcode": "84-230"
        }
    ]
}

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": ""
            }
        ],
        {
            "status": "ERROR",
            "message": "Unknown address"
        },
        [
            {
                "quality": 9,
                "x": 18.3865894,
                "y": 54.57206,
                "country": "PL",
                "city": "Rumia",
                "street": "Grunwaldzka",
                "house": "2",
                "pcode": "84-230"
            }
        ]
    ]
}

El ejemplo muestra una respuesta por lotes cuyos elementos result conservan el orden de la solicitud. Las coordenadas y los datos postales reales dependen de cada dirección de entrada y de los datos cartográficos actuales; cada dirección puede devolver un número distinto de coincidencias, hasta maxResult.

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.