api.automapa.comv3 - alle Systeme normal

Adresse geokodieren

Geocoder.geocode

Wandelt eine strukturierte Adresse mit dem erforderlichen Feld city in Koordinaten und passende Adressdetails um.

POST/v3/Geocoder/geocodeapi.automapa.com

Body-Parameter

AnfragetextTypBeschreibung
addressobject ERFORDERLICHGeben Sie ein Adressobjekt mit dem erforderlichen Feld city an. Andere Felder sind optional; machen Sie ausreichend Angaben für einen Treffer.
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

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

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

Das Beispiel zeigt ausgewählte Antwortfelder. Tatsächliche Koordinaten und Postleitzahldaten hängen von der Eingabe und den aktuellen Kartendaten ab; berechtigungsabhängige erweiterte Felder können ebenfalls enthalten sein.

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.