Avant de commencer
Le géocodage convertit 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
Le service de géocodage Distancematrix.ai est disponible via un interface HTTP pour une variété d'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 Formaté au format JSON document 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 montrant comment formuler des demandes et interpréter les réponses, illustrant le processus pour différentes plateformes et méthodes, notamment les navigateurs, Postman et le codage basé sur les applications.
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, allez dans 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 le faire dans
l'article.
-min.webp)
N'oubliez pas de sauvegarder ces modifications.
-min.webp)
Dans notre collection Postman, vous trouverez tous les points de terminaison, les types de demandes et les paramètres disponibles. En général, nous vous recommandons d'utiliser des requêtes synchrones. Toutefois, dans les situations où vous devez traiter des demandes groupées avec un très grand nombre d'emplacements en une seule fois, les demandes asynchrones sont également disponibles et peuvent être efficaces. Pour travailler avec eux, cliquez sur Distancematrix Accurate → Demandes groupées → Envoyer un travail → Body, start work !
-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.
Guide du développeur de Direct Geocoding
Ci-dessous, vous pouvez lire comment obtenir la latitude et la longitude à partir de l'API d'adresse. Vous découvrirez quels paramètres obligatoires et facultatifs vous devez utiliser et quelle réponse de géocodage vous obtenez. Nous vous montrerons également un exemple de réponse JSON basé sur l'indicateur de sortie.
Format de demande d'API
La demande d'API Geocoding a été spécialement conçue pour ressembler au format de demande couramment utilisé afin de faciliter la transition depuis des services alternatifs.
Une demande d'API de géocodage ressemble à ceci :
OBTENIR :
URL de base : Dans le service de géocodage DistanceMatrix.ai, les demandes sont structurées sous forme d'URL avec des paramètres obligatoires et facultatifs, séparés par une esperluette (&). Utilisez le cryptage HTTPS pour des raisons de sécurité : https://.
Domaine : Le domaine de l'API DistanceMatrix.ai précise est api-v2.distancematrix.ai
URL de la demande : Pour le géocodage, c'est /maps/api/geocode/json.
Paramètres: les paramètres sont des informations supplémentaires qui sont ajoutées à l'URL de la demande pour fournir des détails spécifiques à l'API. Ces paramètres peuvent être classés en deux types : obligatoires et facultatifs.
Paramètres requis sont obligatoires pour que l'API puisse traiter correctement la demande car ils fournissent des informations essentielles sans lesquelles l'API ne peut pas effectuer l'opération prévue. Ainsi, dans une demande d'API de géocodage, l'adresse pour laquelle vous avez besoin des coordonnées géographiques est un paramètre obligatoire. Sans cette adresse, l'API ne saurait quel emplacement géocoder. Par exemple, pour un lieu d'intérêt tel que la Maison Anne Frank ?address=Westermarkt+20,+1016+GV+Amsterdam,+Netherlands spécifie l'adresse pour le géocodage standard.
Paramètres facultatifs ne sont pas obligatoires, mais peuvent être incluses pour affiner ou personnaliser la réponse de l'API. Les paramètres facultatifs peuvent fournir un contrôle supplémentaire sur le format de la réponse de l'API, la langue dans laquelle les données sont renvoyées ou d'autres informations spécifiques relatives à la demande. Par exemple, dans une demande de géocodage, un paramètre facultatif peut être la langue dans laquelle vous souhaitez que les résultats soient renvoyés, comme &language=uk pour spécifier une préférence de langue. L'inclusion de ce paramètre n'est pas nécessaire pour la fonction de géocodage elle-même, mais elle peut améliorer l'utilisabilité des données.
Jeton d'autorisation : Incluez votre jeton d'accès unique comme &key=<your_access_token> pour authentifier la demande.
Voici un exemple de demande complète :
https://api-v2.distancematrix.ai/maps/api/geocode/json?address=Westermarkt%2020,%201016%20GV%20Amsterdam,%20Netherlands&key=<your_access_token>
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-v2.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": "United States",
"short_name": "US",
"types": [
"country",
"political"
]
},
{
"long_name": "Mountain View",
"short_name": "Mountain View",
"types": [
"administrative_area_level_3",
"political"
]
},
{
"long_name": "94043",
"short_name": "94043",
"types": [
"postal_code"
]
},
{
"long_name": "1600",
"short_name": "1600",
"types": [
"street_number"
]
},
{
"long_name": "Amphitheatre Parkway",
"short_name": "Amphitheatre Parkway",
"types": [
"route"
]
},
{
"long_name": "Google Headquarters",
"short_name": "Google Headquarters",
"types": [
"name"
]
},
{
"long_name": "CA",
"short_name": "CA",
"types": [
"state",
"administrative_area_level_1",
"political"
]
}
],
"formatted_address": "1600 Amphitheatre Parkway, Mountain View 94043, United States",
"geometry": {
"location": {
"lat": 37.4217636,
"lng": -122.084614
},
"location_type": "APPROXIMATE",
"viewport": {
"northeast": {
"lat": 37.4217636,
"lng": -122.084614
},
"southwest": {
"lat": 37.4217636,
"lng": -122.084614
}
}
},
"place_id": "2192620021",
"plus_code": {},
"types": [
"street_address"
]
}
],
"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é rejeté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.
