api.automapa.comv3 - alle Systeme normal

Batch-Geocoding

Geocoder.geocodemulti

Geokodiert bis zu 100 strukturierte Adressen pro Anfrage. Jede erfordert city; die Ergebnisse folgen der Eingabereihenfolge.

POST/v3/Geocoder/geocodemultiapi.automapa.com

Body-Parameter

AnfragetextTypBeschreibung
addressesobject[] ERFORDERLICHGeben Sie bis zu 100 Adressobjekte an, jedes mit dem erforderlichen Feld city. Die übrigen Feldregeln von geocode gelten; die Ergebnisse folgen der Eingabereihenfolge.
countrystringOptionaler Ländercode. Fehlend oder null ergibt PL; ein leerer Wert bleibt leer. Verwenden Sie PL in Großbuchstaben für polnische Adressen. Internationale Geokodierung erfordert entsprechenden Zugang.
provincestringOptionaler Provinzname; wird nicht automatisch ergänzt.
districtstringOptional. Fehlend oder null ergibt eine leere Zeichenkette.
communitystringOptional. Fehlend oder null ergibt eine leere Zeichenkette.
citystring ERFORDERLICHDer Ortsname city ist für jede Adresse erforderlich, auch für PL.
quarterstringOptional. Fehlend oder null ergibt eine leere Zeichenkette.
pcodestringOptional. Fehlend oder null ergibt eine leere Zeichenkette.
streetstringOptional. Fehlend oder null ergibt eine leere Zeichenkette.
housestringOptional. Fehlend oder null ergibt eine leere Zeichenkette.
maxResultintegerFür polnische Adressen höchstens 1–3 Treffer je Adresse (Standard 1). Werte außerhalb des Bereichs werden auf 1–3 begrenzt. Setzen Sie maxResult in jeder Adresse; maxResults setzt diese Grenze nicht.

Beispielrequest

{
    "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"
        }
    ]
}

Beispielresponse

{
    "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"
            }
        ]
    ]
}

Das Beispiel zeigt eine Stapelantwort, deren result-Einträge die Reihenfolge der Anfrage beibehalten. Tatsächliche Koordinaten und Postleitzahldaten hängen von jeder Eingabeadresse und den aktuellen Kartendaten ab; jede Adresse kann bis maxResult unterschiedlich viele Treffer liefern.

result-Felder

result-FelderTypBeschreibung
qualityintegerGeocoding quality score.
xdoubleLongitude (WGS84).
ydoubleLatitude (WGS84).
countrystringCountry code.
provincestringProvince.
districtstringDistrict (powiat).
communitystringCommunity (gmina).
citystringCity.
quarterstringQuarter.
pcodestringPostal code (PL only).
streetstringStreet.
housestringHouse number.
addressTypeinteger ERWEITERTBuilding type. Extended.
peoplesForAddressinteger ERWEITERTResidents at address. Extended.
flatsForAddressinteger ERWEITERTFlats at address. Extended.
buildingsForAddressinteger ERWEITERTBuildings at address. Extended.
pcodeExtraInfoobject[] ERWEITERTExtra postal-code info. Extended.
resultRadiusnumberResult envelope radius (m). -1 if unknown.
mapLinkstringLink to map result.