Adresse geokodieren
Geocoder.geocode
Wandelt eine strukturierte Adresse mit dem erforderlichen Feld city in Koordinaten und passende Adressdetails um.
Body-Parameter
| Anfragetext | Typ | Beschreibung |
|---|---|---|
address | object ERFORDERLICH | Geben Sie ein Adressobjekt mit dem erforderlichen Feld city an. Andere Felder sind optional; machen Sie ausreichend Angaben für einen Treffer. |
country | string | Optionaler 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. |
province | string | Optionaler Provinzname; wird nicht automatisch ergänzt. |
district | string | Optional. Fehlend oder null ergibt eine leere Zeichenkette. |
community | string | Optional. Fehlend oder null ergibt eine leere Zeichenkette. |
city | string ERFORDERLICH | Der Ortsname city ist für jede Adresse erforderlich, auch für PL. |
quarter | string | Optional. Fehlend oder null ergibt eine leere Zeichenkette. |
pcode | string | Optional. Fehlend oder null ergibt eine leere Zeichenkette. |
street | string | Optional. Fehlend oder null ergibt eine leere Zeichenkette. |
house | string | Optional. Fehlend oder null ergibt eine leere Zeichenkette. |
maxResult | integer | Fü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-Felder | Typ | Beschreibung |
|---|---|---|
quality | integer | Geocoding quality score. |
x | double | Longitude (WGS84). |
y | double | Latitude (WGS84). |
country | string | Country code. |
province | string | Province. |
district | string | District (powiat). |
community | string | Community (gmina). |
city | string | City. |
quarter | string | Quarter. |
pcode | string | Postal code (PL only). |
street | string | Street. |
house | string | House number. |
addressType | integer ERWEITERT | Building type. Extended. |
peoplesForAddress | integer ERWEITERT | Residents at address. Extended. |
flatsForAddress | integer ERWEITERT | Flats at address. Extended. |
buildingsForAddress | integer ERWEITERT | Buildings at address. Extended. |
pcodeExtraInfo | object[] ERWEITERT | Extra postal-code info. Extended. |
resultRadius | number | Result envelope radius (m). -1 if unknown. |
mapLink | string | Link to map result. |