Géocoder une adresse
Geocoder.geocode
Convertit une adresse structurée avec le champ city obligatoire en coordonnées et détails de l’adresse correspondante.
Paramètres du body
| Corps de la requête | Type | Description |
|---|---|---|
address | object REQUIS | Fournissez un objet adresse avec le champ city obligatoire. Les autres champs sont facultatifs ; indiquez assez de détails pour obtenir une correspondance. |
country | string | Code pays facultatif. Absent ou null donne PL ; une valeur vide reste vide. Utilisez PL en majuscules pour les adresses polonaises. Le géocodage international exige un accès adapté. |
province | string | Nom de province facultatif ; aucune valeur n’est complétée automatiquement. |
district | string | Facultatif. Absent ou null donne une chaîne vide. |
community | string | Facultatif. Absent ou null donne une chaîne vide. |
city | string REQUIS | Le nom de ville city est obligatoire pour chaque adresse, y compris pour PL. |
quarter | string | Facultatif. Absent ou null donne une chaîne vide. |
pcode | string | Facultatif. Absent ou null donne une chaîne vide. |
street | string | Facultatif. Absent ou null donne une chaîne vide. |
house | string | Facultatif. Absent ou null donne une chaîne vide. |
maxResult | integer | Pour les adresses polonaises, au plus 1 à 3 correspondances par adresse (1 par défaut). Les valeurs hors plage sont limitées à 1–3. Définissez maxResult dans chaque adresse ; maxResults ne définit pas cette limite. |
Exemple de requête
{
"address": {
"country": "PL",
"city": "Warszawa",
"street": "Domaniewska",
"house": "37"
}
}Exemple de réponse
{
"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": ""
}
]
}L’exemple présente une sélection de champs de réponse. Les coordonnées et données postales réelles dépendent de l’entrée et des données cartographiques actuelles ; des champs étendus soumis à autorisation peuvent également être présents.
champs result
| champs result | Type | Description |
|---|---|---|
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 ÉTENDU | Building type. Extended. |
peoplesForAddress | integer ÉTENDU | Residents at address. Extended. |
flatsForAddress | integer ÉTENDU | Flats at address. Extended. |
buildingsForAddress | integer ÉTENDU | Buildings at address. Extended. |
pcodeExtraInfo | object[] ÉTENDU | Extra postal-code info. Extended. |
resultRadius | number | Result envelope radius (m). -1 if unknown. |
mapLink | string | Link to map result. |