Avant de commencer
Les API de géocodage convertissent une adresse en coordonnées géographiques utiles pour placer des marqueurs sur des cartes ou localiser des adresses. Par exemple, la conversion de « Rockefeller Center, New York, États-Unis » donne 40,7587402 de latitude et 73,9786736 de longitude.
De même, le géocodage inversé convertit les coordonnées géographiques en une adresse lisible.
Comment utiliser l'API de géocodage
Les API de géocodage Distancematrix.ai sont disponibles via une interface HTTP pour diverses applications, notamment les navigateurs Web, Postman et l'intégration directe d'applications. Les utilisateurs peuvent soumettre des demandes de géocodage standard avec une adresse, ou des demandes de géocodage inversé avec des coordonnées (latitude et longitude). Le service vous permet de configurer davantage les demandes en spécifiant des paramètres supplémentaires avec des options de personnalisation.
Après avoir soumis votre demande, le service répond par un document au format JSON contenant les résultats les plus pertinents, idéalement structuré pour une utilisation simple et une intégration avec différentes plateformes, des navigateurs Web aux différents types d'applications.
La sécurité est importante et le protocole HTTPS est recommandé dans la mesure du possible, en particulier pour les applications qui incluent des données utilisateur sensibles, telles que la localisation d'un utilisateur, dans les demandes. L'utilisation du cryptage HTTPS renforce la sécurité de votre application et la rend plus résistante à l'espionnage ou à la falsification.
Vous trouverez ci-dessous des exemples et des instructions sur nos requêtes HTTPS d'API de géocodage, adaptées à un large éventail d'approches, que ce soit par le biais d'un navigateur Web, de toute plate-forme ou application de votre choix ou de systèmes tels que Postman. Ce guide comprend des descriptions complètes sur la manière de formuler des demandes et d'interpréter les réponses dans différents environnements.
Comment utiliser l'API de géocodage via Postman
Notre API est un service HTTP polyvalent adapté à divers cas d'utilisation et scénarios d'intégration. Il peut être utilisé de la manière qui convient à vos besoins, y compris pour les requêtes directes du navigateur, le codage dans différents langages de programmation ou l'intégration avec des applications et des systèmes.
L'un des moyens les plus simples et les plus efficaces de commencer à interagir et à intégrer notre API dans vos projets consiste à utiliser
Facteur, connu pour son interface conviviale et ses fonctionnalités puissantes.
Voici comment procéder :
Pour commencer à utiliser Postman, installez-le sur votre ordinateur ou accédez à une version Web de votre navigateur.
Importez notre collection d'API préconfigurée :
Lors de l'importation, Postman ajoutera automatiquement la collection dans votre espace de travail.
Pour les utilisateurs de la version en ligne de Postman, vous pouvez directement ouvrir le lien de collecte et créer un fork. Pour ce faire, cliquez sur les trois points à côté du nom de la collection.
Configurez votre environnement dans Postman, accédez à la section Variables et ajoutez votre jeton d'authentification dans le champ « Jeton d'autorisation API ».
N'oubliez pas de sauvegarder ces modifications.
Faites votre première demande : sélectionnez un point de terminaison dans notre collection, configurez les paramètres de votre demande et appuyez sur Envoyer pour voir la réponse.
-min.webp)
Veuillez noter que vous pouvez obtenir votre jeton individuel dans le panneau d'administration. Lisez comment procéder dans
l'article.
-min.webp)
N'oubliez pas de sauvegarder ces modifications.
-min.webp)
Dans la collection Postman, vous trouverez tous les paramètres dont vous avez besoin pour configurer vos demandes. Si vous avez des questions, n'hésitez pas à
nous contacter.
Une fois que vous serez à l'aise avec les bases, vous pourrez explorer les fonctionnalités plus avancées de notre API. Notre documentation détaillée ci-dessous vous guidera à travers les fonctionnalités spécifiques de notre API.
Paramètres facultatifs dans une demande de géocodage :
langue — La langue dans laquelle les résultats doivent être renvoyés.
Consultez la liste des langues prises en charge.
Le géocodeur utilise par défaut la langue spécifiée dans l'en-tête Accept-Language ou la langue maternelle du domaine de la demande si aucune langue n'est fournie.
Pour garantir la lisibilité, le géocodeur renvoie les adresses postales dans la langue locale, en utilisant la translittération si nécessaire, en fonction de la langue préférée de l'utilisateur. Tous les composants d'adresse sont fournis dans la même langue, déterminée par la langue du premier composant.
Si un nom d'adresse n'est pas disponible dans la langue préférée, le géocodeur sélectionne la correspondance disponible la plus proche.
La langue préférée influence subtilement la sélection et l'ordre des résultats, car le géocodeur interprète les abréviations et les synonymes différemment selon les langues. Par exemple, « utca » et « tér » en hongrois correspondent à « rue » et à « place ».
Afficher les langues
Masquer les langues
Code de langue
Langue
Code de langue
Langue
af
Afrikaans
ja
japonais
m²
albanais
kn
Kannada
am
Amharique
kk
Kazakh
am
arabe
km
Khmer
pourquoi
arménien
ko
Coréen
az
azerbaïdjanais
ky
kirghize
ue
Basque
lo
laotien
être
biélorusse
lv
letton
milliards
Bengali
lt
lituanien
bs
bosniaque
mk
Macédonien
bg
Bulgare
ms
Malais
mon
Birman
ml
Malayalam
californie
Catalan
m.
Marathi
zh
chinois
mn
mongol
zh-CN
Chinois (simplifié)
ne
népalais
zh-HK
Chinois (Hong Kong)
non
Norvégien
zh-TW
Chinois (traditionnel)
pl
polonais
heure
Croate
pt
portugais
cs
tchèque
PT-BR
Portugais (Brésil)
da
danois
Pt-PT
Portugais (Portugal)
nl
néerlandais
pa
Pendjabi
fr
Anglais
ro
roumain
fr-AU
Anglais (australien)
ru
russe
fr-GB
Anglais (Grande-Bretagne)
sr
serbe
et
estonien
si
Cinghalais
fa
Farsi
sk
slovaque
fi
finnois
sl
slovène
fichier
Philippin
El Salvador
espagnol
fr
français
es-419
Espagnol (Amérique latine)
FR-CA
Français (Canada)
so
Swahili
grand livre
Galicien
sv
Suédois
ka
géorgien
assistant pédagogique
Tamoul
de
allemand
te
télougou
el
Grec
th
Thaï
pistolet
Gujarati
tr
Turc
iwi
Hébreu
royaume-uni
Ukrainien
salut.
Hindi
ur
ourdou
hu
Hongrois
uz
Ouzbek
est
islandais
vi
Vietnamien
identifiant
indonésien
zu
Zoulou
il
italien
région — spécifié sous la forme d'une valeur de ccTLD (« domaine de premier niveau ») à deux caractères, ce paramètre influence mais ne limite pas strictement les résultats du géocodeur.
Paramètres requis dans une demande de géocodage :
adresse : Ici, vous devez mentionner l'adresse postale pour le géocodage. Il doit être formaté conformément aux normes de service postal nationales du pays concerné, à l'exclusion des éléments tels que les noms commerciaux ou les numéros d'unité/de suite/d'étage. Utiliser des espaces (URL échappée sous forme de %20) pour séparer les éléments de l'adresse postale, par exemple :
adresse= 10020 %Queens20 %Parc20 %Toronto%20 SUR où « 100 Queens Park, Toronto, ON » est l'adresse du Musée royal de l'Ontario
clé: Ce paramètre nécessite votre jeton d'autorisation API unique, qui est nécessaire pour vérifier l'identité et les autorisations du client à l'origine de la demande, garantir un accès sécurisé et un suivi précis de son quota d'utilisation.
Vous trouverez plus de détails sur la clé, son objectif, le processus d'obtention et les limites de l'API de géocodage appliquées à la clé sur le
lien.
Réponses de géocodage
Notre API Geo convertit les adresses en coordonnées (latitude et longitude). Il renvoie les réponses dans le format spécifié dans la demande d'URL, tel que JSON. Dans l'exemple ci-dessous, une demande pour « 1600 Amphitheatre Parkway, Mountain View, CA » utilise le format JSON pour sa réponse, comme indiqué par l'indicateur de sortie JSON dans la demande :
OBTENIR :
https://api.distancematrix.ai/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=<your_access_token>
Exemple de réponse JSON :
CORPS
{
"result": [
{
"address_components": [
{
"long_name": "1600",
"short_name": "1600",
"types": [
"street_number"
]
},
{
"long_name": "amphitheatre parkway",
"short_name": "amphitheatre parkway",
"types": [
"route"
]
},
{
"long_name": "mountain view",
"short_name": "mountain view",
"types": [
"locality"
]
},
{
"long_name": "ca",
"short_name": "ca",
"types": [
"state"
]
}
],
"formatted_address": "1600 Amphitheatre Parkway, Mountain View, CA",
"geometry": {
"location": {
"lat": 37.422387799999996,
"lng": -122.08418770000002
},
"location_type": "APPROXIMATE",
"viewport": {
"northeast": {
"lat": 37.422387799999996,
"lng": -122.08418770000002
},
"southwest": {
"lat": 37.422387799999996,
"lng": -122.08418770000002
}
}
},
"place_id": "",
"plus_code": {
"compound_code": "CWC8+R9 Mountain View, California, United States",
"global_code": "849VCWC8+R9"
},
"types": [
"locality",
"political"
]
}
],
"status": "OK"
}
Notez que la réponse JSON contient deux éléments racine :
« status » contient les métadonnées de la demande. Voir
Codes d'état ci-dessous.
« résultats » contient un tableau d'informations d'adresse géocodées et d'informations de géométrie.
Généralement, une seule entrée du tableau « résultats » est renvoyée pour les recherches d'adresses, bien que le géocodeur puisse renvoyer plusieurs résultats lorsque les requêtes d'adresse sont ambiguës.
Notez que ces résultats doivent généralement être analysés si vous souhaitez en extraire des valeurs.
Codes d'état
Le champ « statut » de la réponse Geocoding fournit l'état de la demande et des informations de débogage pour aider à diagnostiquer les problèmes. Les valeurs d'état possibles incluent :
« OK » : la demande a abouti et les données de géocodage sont renvoyées.
« ZERO_RESULTS » : le géocodage a réussi mais n'a donné aucun résultat, probablement en raison d'une adresse inexistante.
« OVER_DAILY_LIMIT » : cela peut signifier une clé API non valide ou manquante, l'absence de facturation sur le compte ou un dépassement du plafond d'utilisation.
« OVER_QUERY_LIMIT » : votre utilisation a dépassé le quota.
« REQUEST_DENIED » : La demande a été refusée.
« INVALID_REQUEST » : signifie souvent une requête manquante (adresse, composants ou latlng).
« UNKNOWN_ERROR » : une erreur de serveur s'est produite ; une nouvelle tentative peut aboutir.
Messages d'erreur
Si le code d'état renvoyé par le géocodeur n'est pas « OK », un champ facultatif « error_message » peut apparaître dans la réponse. Ce champ fournit plus de détails sur la raison pour laquelle ce code de statut particulier a été renvoyé.
*Remarque : le champ « error_message » n'est pas toujours disponible et son contenu peut changer.
Résultats
Lorsque le géocodeur renvoie des résultats, ceux-ci sont placés dans un tableau de résultats au format JSON. Si aucun résultat n'est trouvé (par exemple pour une adresse inexistante), le tableau sera vide.
Les champs typiques d'un résultat sont les suivants :
tableau types [] : Spécifie le type de résultat, avec des balises telles que « localité » pour les villes ou « politique » pour les entités politiques. Par exemple, « Chicago » pourrait être étiqueté comme les deux.
adresse_formatée : Chaîne d'adresse lisible par l'homme, souvent similaire à une adresse postale. Cependant, dans certains pays, comme au Royaume-Uni, les véritables adresses postales peuvent ne pas être distribuables. Cette adresse est composée d'éléments tels que le numéro de rue, l'itinéraire, la ville et l'État. Au lieu d'analyser cette adresse, utilisez les composants d'adresse distincts qui sont également fournis dans la réponse.
adresse_composants [] : Tableau des composants de l'adresse.
Chaque composant d'adresse contient généralement les champs suivants :
types [] : Spécifie le type de chaque composant d'adresse.
nom_long : Fournit la description en texte intégral ou le nom du composant d'adresse tel que donné par le géocodeur.
nom_court : S'applique au nom du composant d'adresse avec une version abrégée disponible du nom du composant d'adresse. Prenons l'exemple de l'État de l'Alaska : nom_court de « AK », qui est son abréviation postale à 2 lettres et un nom_long de « Alaska ».
Voici quelques informations supplémentaires sur le adresse_composants [] tableau à garder à l'esprit :
Le adresse_composants [] le tableau d'une réponse de géocodage peut contenir plus d'éléments que la formatted_address.
Il n'inclut pas toujours toutes les entités politiques contenant l'adresse, à l'exception de celles figurant dans adresse_formatée. Pour obtenir une liste complète, utilisez le géocodage inversé avec la latitude/longitude de l'adresse.
Le format de réponse, y compris le nombre et les types de composants d'adresse, peut varier d'une demande à l'autre et dans le temps pour une même adresse. Les composants peuvent changer de position, de type ou peuvent être omis dans les réponses suivantes.
Pour utiliser efficacement la réponse du géocodeur, vous devez analyser le tableau de composants :
localité_de_code postal []: Ce tableau répertorie toutes les localités comprises dans un code postal. Il n'apparaît que pour les codes postaux couvrant plusieurs localités.
géométrie: Comprend des informations clés telles que :
match_partiel: indique une correspondance inexacte avec la demande, ce qui est utile pour identifier les problèmes potentiels tels que les fautes d'orthographe ou les adresses incomplètes. Des correspondances partielles se produisent souvent pour des adresses postales inexistantes ou lorsqu'une adresse correspond à plusieurs emplacements dans la même zone. Par exemple, une adresse mal orthographiée (« 21 Henr St, Bristol, Royaume-Uni ») peut renvoyer une rue à consonance similaire en tant que correspondance partielle (« Henry Street » et « Henrietta Street »).
Types d'adresses et types de composants d'adresse
Le types [] Un tableau dans le résultat du géocodage spécifie le type d'adresse, tel qu'une adresse postale, un pays ou une entité politique. Il y a aussi un types [] tableau à l'intérieur adresse_composants [] qui spécifie le type de chaque partie de l'adresse, comme le numéro de rue ou le pays. Les adresses peuvent être de plusieurs types et fonctionner comme des « balises ». Par exemple, les villes ont souvent des tags tels que « politique » et « localité ».
Le géocodeur prend en charge et renvoie différents types dans les tableaux de types d'adresses et de types de composants :
adresse_rue : Une adresse postale précise.
itinéraire : Un itinéraire nommé comme « US 101 ».
intersection : Intersection majeure de deux routes principales.
politique : Entité politique, désignant généralement un polygone d'administration civile.
pays : L'entité politique nationale, souvent du plus haut niveau.
zone_administrative_niveau_1 : Une entité civile principale en dessous du niveau du pays, comme les États américains. Elles sont souvent conformes aux subdivisions de la norme ISO 3166-2.
zone_administrative_niveau_2: Entité civile secondaire, comme les comtés des États-Unis.
superficie_administrative_niveau_3/superficie_administrative_niveau_4/superficie_administrative_niveau_5 : Entités civiles d'ordre inférieur, représentant des divisions mineures.
domaine_familier : Autre nom couramment utilisé pour l'entité.
localité : Une ville ou un village incorporé.
sous-localité (et niveaux 1 à 5 : sublocality_level_1 à sublocality_level_5) : entités d'ordre inférieur au sein d'une localité. Plus la zone géographique est petite, plus les nombres sont élevés.
quartier : Un quartier nommé.
prémisse : Lieu désigné, généralement un bâtiment ou un complexe.
sous-site : Partie d'un bâtiment plus vaste, comme un bâtiment au sein d'un complexe.
code_postal : Code postal utilisé dans le pays.
caractéristique_naturelle : Une caractéristique naturelle importante.
point_d'intérêt : Une entité de premier plan comme « l'Empire State Building » ou la « Tour Eiffel ».
Si la liste des types d'un composant d'adresse est vide, cela signifie qu'aucun type spécifique n'est connu pour ce composant, comme un « Lieu-dit » en France. En outre, les composants d'adresse peuvent inclure :
étage : Le numéro d'étage d'un bâtiment.
établissement : Un lieu qui n'a pas encore été classé.
point_d'intérêt : Un point d'intérêt désigné.
stationnement : Un parc de stationnement ou une structure.
boite_postale : Une boîte postale spécifique.
ville_postale : Regroupement de zones géographiques utilisé pour les adresses postales dans certains pays.
chambre : Une chambre dans un immeuble.
numéro de rue : Le numéro de rue exact.
gare_routière, gare_ferroviaire, gare_de_transit : Emplacement des arrêts d'autobus, de train ou de transport en commun.
FAQ
Qu'est-ce qui différencie cette API des autres API de géocodage ?
L'API de géocodage Distancematrix.ai présente plusieurs facteurs qui la différencient des autres API de géocodage :
Haute précision : l'API de géocodage Distancematrix.ai utilise des algorithmes et des sources de données avancés pour fournir des résultats de géocodage précis et fiables. L'API présente également un taux de réussite élevé en matière de correspondance d'adresses, ce qui signifie qu'elle peut gérer un large éventail de formats et de variantes d'adresses.
Couverture mondiale : l'API couvre un large éventail de pays et de régions, y compris des endroits difficiles d'accès tels que les zones rurales, les îles et les pays en développement. Cela signifie que les utilisateurs peuvent compter sur l'API pour fournir des résultats précis, quelle que soit la provenance de leurs données.
Rapidité et évolutivité : l'API est conçue pour gérer de grands volumes de demandes de géocodage rapidement et efficacement.
Rentable : l'API propose un modèle de tarification simple et transparent, sans frais cachés ni coûts initiaux. L'API propose un plan gratuit et un plan de croissance avec un modèle de tarification par répartition.
Puis-je utiliser cette API comme adresse de conversion en API lat long ?
Oui, vous pouvez utiliser l'API de géocodage Distancematrix.ai pour convertir les adresses en coordonnées latitude-longitude. En fait, c'est l'une des principales fonctions d'une API address to lat long comme celle-ci.
Pour utiliser l'API pour le géocodage, vous devez envoyer une demande à l'API avec un paramètre d'adresse, et l'API répondra avec les coordonnées lat-long correspondantes pour cette adresse.
L'API de géocodage Distancematrix.ai est conçue pour obtenir la latitude et la longitude à partir d'une API d'adresse facile à utiliser. Il peut être intégré à un large éventail d'applications et de plateformes. L'API prend en charge une variété de langages de programmation et de frameworks, notamment Python, JavaScript et PHP.
Puis-je utiliser cette API comme convertisseur d'API de latitude et de longitude vers des adresses lisibles par l'homme ?
Oui, vous pouvez utiliser l'API de géocodage Distancematrix.ai pour convertir les coordonnées latitude-longitude (lat-long) en adresses lisibles par l'homme. Ce processus est également connu sous le nom de géocodage inversé et les développeurs recherchent généralement une API de latitude et de longitude ou les coordonnées d'un agent à partir de l'API d'adresse.
Pour utiliser l'API pour le géocodage inversé, vous devez envoyer une demande à l'API avec les paramètres de latitude et de longitude, et l'API répondra avec l'adresse lisible par l'homme correspondante pour ces coordonnées.
Si vous avez des questions ou si vous avez besoin d'une assistance supplémentaire pour utiliser l'API pour vos besoins de géocodage inversé, l'équipe Distancematrix.ai fournit une documentation détaillée et un support client pour vous aider à démarrer.
Que pouvez-vous faire avec l'API de géocodage ?
De nombreuses entreprises utilisent des logiciels et des applications pour localiser les magasins, les entrepôts, les véhicules et les clients, afin de contrôler le transport et les mouvements liés au géocodage. Mais actuellement, sa définition ne se limite pas aux recherches d'adresses. Il s'agit d'un outil assez universel qui vous permet de l'appliquer à l'ensemble du marché, qu'il s'agisse de la localisation précise et de la cartographie des itinéraires, de l'analyse des données clients ou de la reconnaissance des modèles géographiques.
Cette solution est utile, par exemple, pour les chauffeurs de taxi s'ils ne disposent pas de données précises sur les adresses de destination des clients. De plus, ce service est pratique pour les coursiers de livraison de nourriture dans leurs activités quotidiennes. Vous pouvez lire d'autres exemples d'API de géocodage réussis à l'aide de notre site web.
Pourquoi utiliser l'API Geocoding ?
Les API Distancematrix.ai offrent une précision inégalée, comparable à celle des géants du secteur, mais à un prix bien plus abordable, une plus grande évolutivité et une équipe d'assistance humaine et sympathique, toujours disponible pour répondre à vos questions. Un avantage supplémentaire est la facilité de transition par rapport aux autres fournisseurs, ce qui garantit un processus de changement fluide.
En outre, Distancematrix.ai permet aux utilisateurs de tester le service sans avoir à joindre de carte de crédit/débit avant de prendre une décision finale. Ceci est fait pour que les utilisateurs puissent vérifier la qualité et la valeur des résultats obtenus. N'hésitez pas à essayer de vous assurer que Distancematrix.ai est une solution de haute qualité, rapide mais rentable. De plus, même pendant la période d'essai, les utilisateurs peuvent contacter le support en direct disponible pour toute question.
Qu'est-ce qu'une API de géocodage ?
Une API de géocodage est un service qui convertit les adresses postales en coordonnées géographiques (latitude/longitude) et vice versa. Il permet aux applications de placer des emplacements avec précision sur des cartes, de calculer les distances entre les points et d'effectuer des opérations basées sur la localisation.
