API de géocodage direct
Envoyez une adresse, un nom de lieu, un code postal ou une description approximative comme « café près de Kings Cross » et recevez des coordonnées, une adresse nettoyée, ses composants, une zone englobante et un niveau de précision qui vous indique à quel point vous pouvez vous fier au point.
Exemple
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/forward?q=221B+Baker+Street,+London&limit=1"Le texte libre fonctionne. Une requête structurée aussi, si vous disposez déjà des éléments : street=221B Baker Street&city=London&country=gb. Limitez les résultats à un ou plusieurs pays avec country=gb,ie, privilégiez ceux proches d'un point avec proximity=lat,lon, ou d'une zone avec bounds.
{
"status": "ok",
"query": "221B Baker Street, London",
"results": [
{
"formatted": "221B Baker Street, London NW1 6XE, United Kingdom",
"lat": 51.523767,
"lon": -0.158555,
"type": "address",
"precision": "house",
"confidence": 0.97,
"components": {
"house_number": "221B",
"road": "Baker Street",
"neighbourhood": "Marylebone",
"city": "London",
"state": "England",
"postcode": "NW1 6XE",
"country": "United Kingdom",
"country_code": "gb"
},
"bounds": { "north": 51.523917, "south": 51.523617, "east": -0.158305, "west": -0.158805 }
}
]
}Ce que vous recevez
| Champ | Signification |
|---|---|
formatted | L'adresse complète, rédigée selon les conventions d'adressage du pays. |
lat, lon | Degrés décimaux, WGS 84. Jusqu'à six décimales. |
type | Ce qui a été trouvé : address, street, postcode, city, region, country ou poi. |
precision | house, street, postcode ou admin. Voir la couverture. |
confidence | De 0 à 1. Notre degré de certitude que ce lieu est bien celui que vous vouliez, compte tenu de la requête. Indépendant de la précision : une requête portant sur une ville peut obtenir une confiance de 1 avec une précision admin. |
components | L'adresse décomposée en éléments, avec les mêmes noms de clés dans tous les pays. Seuls les éléments existants sont présents. |
bounds | Une zone englobante pour l'élément trouvé : le bâtiment, la rue, la zone du code postal ou la ville. |
Où elle est utilisée
Nettoyer les adresses des clients
Géocodez à l'inscription et enregistrez formatted et components à côté de ce que le client a saisi. Refusez tout ce qui est en dessous de precision: street et demandez-lui de vérifier.
Placer des enregistrements sur une carte
Traitez par lots un CSV d'adresses de magasins ou de biens immobiliers à 50 par seconde et affichez-les sur une carte. Le champ bounds vous donne un niveau de zoom adapté pour chacun.
Rechercher par lieu
Transformez « appartements à Hackney » en zone englobante et interrogez votre propre base de données avec. type vous indique si l'utilisateur a saisi une ville, une rue ou un bâtiment.
Précision
Les résultats au niveau du numéro de rue dépendent de l'existence de données d'adresses pour le pays, et elles n'existent pas partout. La page de couverture indique le meilleur niveau que nous atteignons dans chacun des 249 pays et territoires. Lorsque nous ne trouvons pas le numéro, nous nous rabattons sur la rue, puis le code postal, puis la localité, et le champ precision indique lequel. Nous ne renvoyons jamais le centroïde d'un pays présenté comme une adresse.
Prix et limites
Un appel correspond à une requête, quel que soit le nombre de résultats renvoyés (jusqu'à 10 avec limit). Chaque clé dispose de 2 500 requêtes gratuites par jour ; au-delà, 0,0001 € par requête sur le crédit prépayé, ou rien avec une clé Unlimited (50 € par mois). Détails des tarifs.
Vous migrez depuis un autre fournisseur ? Les hôtes compatibles Google, Bing, HERE, Mapbox et les autres hôtes compatibles (drop-in) répondent aux requêtes de géocodage direct dans les formats de ces fournisseurs.