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

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.

POST/v3/Geocoder/geocodeapi.automapa.com

Paramètres du body

Corps de la requêteTypeDescription
addressobject REQUISFournissez un objet adresse avec le champ city obligatoire. Les autres champs sont facultatifs ; indiquez assez de détails pour obtenir une correspondance.
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

{
    "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 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.