api.automapa.comv3 - tous les systèmes sont opérationnels

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.

POST/v3/Geocoder/geocodemultiapi.automapa.com

Paramètres du body

Corps de la requêteTypeDescription
addressesobject[] REQUISFournissez 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.
countrystringCode 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é.
provincestringNom de province facultatif ; aucune valeur n’est complétée automatiquement.
districtstringFacultatif. Absent ou null donne une chaîne vide.
communitystringFacultatif. Absent ou null donne une chaîne vide.
citystring REQUISLe nom de ville city est obligatoire pour chaque adresse, y compris pour PL.
quarterstringFacultatif. Absent ou null donne une chaîne vide.
pcodestringFacultatif. Absent ou null donne une chaîne vide.
streetstringFacultatif. Absent ou null donne une chaîne vide.
housestringFacultatif. Absent ou null donne une chaîne vide.
maxResultintegerPour 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 resultTypeDescription
qualityintegerGeocoding quality score.
xdoubleLongitude (WGS84).
ydoubleLatitude (WGS84).
countrystringCountry code.
provincestringProvince.
districtstringDistrict (powiat).
communitystringCommunity (gmina).
citystringCity.
quarterstringQuarter.
pcodestringPostal code (PL only).
streetstringStreet.
housestringHouse number.
addressTypeinteger ÉTENDUBuilding type. Extended.
peoplesForAddressinteger ÉTENDUResidents at address. Extended.
flatsForAddressinteger ÉTENDUFlats at address. Extended.
buildingsForAddressinteger ÉTENDUBuildings at address. Extended.
pcodeExtraInfoobject[] ÉTENDUExtra postal-code info. Extended.
resultRadiusnumberResult envelope radius (m). -1 if unknown.
mapLinkstringLink to map result.