Géocodage par lot
Geocoder.geocodemulti
Géocode jusqu’à 100 adresses structurées par requête. Chacune exige city ; les résultats suivent l’ordre des entrées.
Paramètres du body
| Corps de la requête | Type | Description |
|---|---|---|
addresses | object[] REQUIS | Fournissez jusqu’à 100 objets adresse, chacun avec le champ city obligatoire. Les autres règles des champs de geocode s’appliquent ; les résultats suivent l’ordre des entrées. |
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
{
"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"
}
]
}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": ""
}
],
{
"status": "ERROR",
"message": "Unknown address"
},
[
{
"quality": 9,
"x": 18.3865894,
"y": 54.57206,
"country": "PL",
"city": "Rumia",
"street": "Grunwaldzka",
"house": "2",
"pcode": "84-230"
}
]
]
}L’exemple présente une réponse par lot dont les éléments result conservent l’ordre de la requête. Les coordonnées et données postales réelles dépendent de chaque adresse d’entrée et des données cartographiques actuelles ; chaque adresse peut renvoyer un nombre différent de résultats, dans la limite de maxResult.
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. |