Avant de commencer
Le géocodage est le processus qui consiste à convertir une adresse en coordonnées de latitude et de longitude à l'aide d'une API, tandis que le géocodage inversé consiste à convertir les coordonnées géographiques (latitude et longitude) en une adresse lisible par l'homme via une API.
Ainsi, par exemple, lors de la conversion de coordonnées géographiques telles que 40,758678 de latitude et 73,978798 de longitude, à l'aide de l'API de géocodage inversé, vous recevrez l'adresse exacte « 35 Rockefeller Plaza, New York, NY 10111, États-Unis ».
DistanceMatrix.ai propose les deux solutions, l'API de géocodage inversé pour transformer la latitude et la longitude en adresse et l'API de géocodage direct pour convertir les adresses de la carte en coordonnées géographiques.
Comment utiliser l'API de géocodage inversé
Ce service est accessible via un HTTP interface. Pour les demandes de géocodage inversé, vous devez soumettre une requête sous forme de coordonnées (latitude et longitude). La liste ci-dessous détaille les paramètres obligatoires et facultatifs pour ces demandes.
Lors de votre demande, vous recevrez une réponse sous la forme d'un JSON document contenant les résultats les plus pertinents. Des exemples de telles demandes et les réponses correspondantes sont fournis dans la documentation ci-dessous.
La sécurité passe avant tout. C'est pourquoi le HTTPS est vivement conseillé, en particulier pour les applications traitant des données sensibles telles que la localisation de l'utilisateur. Le cryptage HTTPS renforce la sécurité de votre application en la rendant plus résistante à la surveillance et à la modification.
Notre API de géocodage inversé vous offre la flexibilité nécessaire pour effectuer des demandes de la manière qui répond le mieux à vos besoins. Les instructions détaillées ci-dessus vous indiquent comment effectuer ces demandes à l'aide de Postman, un outil d'interaction API polyvalent et facile à utiliser.
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 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.
Paramètres requis dans une demande de géocodage inversé :
latling : Ce paramètre obligatoire inclut les valeurs de latitude et de longitude pour spécifier l'emplacement pour lequel vous souhaitez obtenir l'adresse. Exemple :
latlng=37.422387799999996,-122.08418770000002
clé : Une clé API unique qui authentifie le demandeur et permet le calcul des quotas. Cette clé doit être incluse dans chaque demande. Ajoutez votre clé API à la demande en utilisant le format &key=<your_access_token>.
Suivez le
lien pour en savoir plus sur la clé, son objectif, comment l'obtenir et les limites de l'API Reverse Geocoding.
Paramètres facultatifs dans une demande de géocodage inversé :
langue: définit la langue des résultats.
Afficher la liste des langues
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ï
gu
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
type_résultat: filtre les résultats par type d'adresse, en utilisant un tube (|) pour plusieurs types. Il agit comme un filtre de post-recherche, en supprimant les résultats ne correspondant pas aux types spécifiés. Les types pris en charge incluent :
type_lieu: filtre par type d'emplacement, en utilisant à nouveau un tube (|) pour les multiples. Il filtre les résultats de recherche en ne conservant que ceux correspondant aux types spécifiés. Les types pris en charge sont les suivants :
Si les deux type_résultat et type_lieu les filtres sont utilisés, seuls les résultats correspondant aux deux sont renvoyés. Si aucune correspondance n'est trouvée, l'API renvoie »ZÉRO_RÉSULTATS«.
Réponses de géocodage inversé
La requête donnée utilise l'API Reverse Geocoding pour convertir les coordonnées de latitude et de longitude « 40.714224, -73.961452 », situées à Brooklyn, en une adresse lisible par l'homme et spécifie que la réponse doit être au format JSON.
Voici comment la demande est structurée :
OBTENIR :
https://api.distancematrix.ai/maps/api/geocode/json?latlng=40.714224,-73.961452&key=<your_access_token>
*Remarque importante : lors de la saisie du latling paramètre, assurez-vous qu'il n'y a pas d'espace entre les valeurs de latitude et de longitude.
Exemple de réponse JSON :
BODY
{
"result": [
{
"address_components": [
{
"long_name": "290-306",
"short_name": "290-306",
"types": [
"street_number"
]
},
{
"long_name": "bedford ave",
"short_name": "bedford ave",
"types": [
"route"
]
},
{
"long_name": "brooklyn",
"short_name": "brooklyn",
"types": [
"city_district"
]
},
{
"long_name": "ny",
"short_name": "ny",
"types": [
"state"
]
},
{
"long_name": "11249",
"short_name": "11249",
"types": [
"postcode"
]
},
{
"long_name": "usa",
"short_name": "usa",
"types": [
"country"
]
}
],
"formatted_address": "290-306 Bedford Ave, Brooklyn, NY 11249, USA",
"geometry": {
"location": {
"lat": 40.714224,
"lng": -73.961452
},
"location_type": "APPROXIMATE",
"viewport": {
"northeast": {
"lat": 40.714224,
"lng": -73.961452
},
"southwest": {
"lat": 40.714224,
"lng": -73.961452
}
}
},
"place_id": "",
"plus_code": {},
"types": [
"locality",
"political"
]
}
],
"status": "OK"
}
Le »adresse_formatée« les résultats incluent différentes manières de nommer géographiquement un lieu, telles que les adresses postales, les noms de villes, les états ou les pays, renvoyant n'importe lequel de ces types comme résultats valides. Par exemple, le géocodage d'un point à Chicago peut être représenté sous la forme d'une adresse postale, d'une ville (Chicago), d'un État (Illinois) ou d'un pays (États-Unis). Le géocodeur inversé fait correspondre les entités politiques, les adresses postales et les codes postaux.
* Remarque importante : Le géocodage inversé estime l'emplacement adressable le plus proche dans une plage de tolérance spécifique, en renvoyant aucun résultat si aucune correspondance proche n'est trouvée.
Veuillez noter que la réponse JSON comporte deux éléments principaux :
« statut »: cet élément fournit des métadonnées relatives à la demande. Reportez-vous à la
Codes d'état ci-dessous pour plus de détails.
« résultat »: Cela inclut un tableau contenant des informations d'adresse et de géométrie géocodées.
N'oubliez pas que pour extraire des valeurs spécifiques de ces résultats, vous devez généralement analyser le JSON, qui est à son tour un processus simple.
Codes d'état
Dans la réponse Geocoding, le »statutLe champ « indique l'état de la demande et peut inclure des détails de débogage. Les valeurs possibles sont les suivantes :
« OK »: Aucune erreur ; l'adresse a été traitée et le ou les géocodes ont été renvoyés.
« ZÉRO_RÉSULTATS »: Le géocodage a réussi mais aucun résultat n'a été trouvé, probablement en raison d'une adresse inexistante.
« DÉPASSEMENT DE LA LIMITE QUOTIDIENNE »: Cela peut signifier une clé API manquante/non valide, aucune facturation activée ou un plafond d'utilisation dépassé.
« DÉPASSEMENT DE LA LIMITE DE REQUÊTES »: indique une utilisation excessive des quotas.
« DEMANDE_REFUSÉE »: Votre demande a été refusée.
« DEMANDE_INVALIDE »: signifie généralement que les détails de la requête sont manquants (adresse, composants ou latling).
« ERREUR_INCONNUE »: une erreur de serveur a empêché le traitement. Une nouvelle tentative pourrait aboutir.
Messages d'erreur
Si le code d'état du géocodeur est autre chose que »OK.», » et »message_d'erreurLe champ » peut apparaître dans la réponse. Ce champ fournit des raisons détaillées à l'origine du code de statut spécifique.
*Remarque importante : Le »message_d'erreurLe champ » n'est pas toujours inclus et son contenu peut varier.
Résultats
Lorsque le géocodeur produit 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 avec une adresse inexistante, le tableau est renvoyé vide.
Les principaux champs d'un résultat type 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 ».
Gardez à l'esprit ces points concernant adresse_composants [] tableau dans les résultats du géocodage :
Le tableau peut inclure plus d'éléments que adresse_formatée.
Il n'englobe pas toujours toutes les entités politiques d'une adresse, mais uniquement celles du adresse_formatée. Utilisez le géocodage inversé avec latitude/longitude pour obtenir une liste complète.
Le format de réponse, y compris le nombre et les types de composants d'adresse, peut varier en fonction de chaque demande et dans le temps pour la même adresse. Les composants peuvent changer de position, changer de type ou être absents dans les réponses suivantes.
Pour utiliser efficacement la réponse de géocodage, vous devez analyser le tableau de composants et sélectionner les valeurs nécessaires.
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: Fournit des informations de localisation clés :
match_partiel: indique une correspondance non exacte, dans laquelle seule une partie de l'adresse demandée a pu être trouvée. Cela est courant pour les adresses postales inexistantes dans la localité demandée, ou lorsqu'une adresse correspond à plusieurs emplacements. Par exemple, une demande dont l'adresse est légèrement mal orthographiée peut renvoyer une adresse à proximité, correctement orthographiée, sous forme de correspondance partielle.
Types d'adresses et types de composants d'adresse
Le types [] un tableau dans les résultats de géocodage indique le type d'adresse, qui peut inclure :
adresse_rue: adresse postale spécifique.
route: Un itinéraire nommé comme « US 101 ».
intersection: Un carrefour majeur de deux routes.
politique: Entité politique, souvent une zone d'administration civile.
pays : L'entité politique nationale, généralement du niveau le plus élevé.
zone_administrative_niveau_2: Entité civile secondaire, telle que les comtés des États-Unis.
zone_administrative_niveau_3 pour zone_administrative_niveau_5: divisions civiles d'ordre inférieur.
Les autres types pris en charge incluent :
zone_familier: nom alternatif pour un lieu.
localité: ville ou village incorporé.
sous-localité (et niveaux 1 à 5) : Entité civile au sein d'une localité.
quartier: Un quartier en particulier.
prémisse: Un bâtiment ou un complexe nommé.
sous-prémisse: Unité située dans un bâtiment plus vaste.
code_postal: Le code postal.
caractéristique_naturelle: sites naturels remarquables.
point_d'intérêt: Entités locales importantes, telles que des monuments.
Une liste de types vide signifie qu'aucun type n'est connu pour ce composant d'adresse. Les autres types incluent :
établissement: Lieux non classés.
se garer: Aires de stationnement.
boîte aux lettres: Boîtes postales spécifiques.
ville_postale: zones géographiques utilisées pour les adresses postales.
pièce: pièces spécifiques d'un bâtiment.
numéro de rue: Numéro de rue exact.
gare_routière, gare_ferroviaire, gare_de_transit: Arrêts de transport en commun.
FAQ
Que pouvez-vous faire avec l'API de géocodage inversé ?
Les entreprises qui s'occupent du géocodage utilisent largement les API de géocodage direct et de géocodage inversé dans les logiciels et les applications pour localiser les magasins, les véhicules et les clients, ce qui facilite la gestion des transports et le suivi des mouvements.
Bien plus qu'une simple identification/localisation d'adresses, le géocodage inversé est un outil polyvalent pour la cartographie de localisation, la planification d'itinéraires et l'analyse des données. Cette technologie peut être bénéfique pour les entreprises de logistique qui ont besoin de détails de localisation précis. Vous trouverez d'autres exemples concrets d'API de géocodage inversé en action sur notre site web.
Pourquoi utiliser l'API Reverse Geocoding ?
L'API de géocodage inversé de DistanceMatrix.ai fournit des données de localisation précises provenant de 99 % du monde dans différents formats. Ainsi, vous pouvez obtenir la bonne adresse en quelques secondes, où que vous soyez. C'est pourquoi notre outil est très demandé dans de nombreux secteurs. En outre, en raison de sa grande précision, il est en concurrence avec les meilleurs fournisseurs du domaine. Une autre chose à noter est que le processus de passage de n'importe quel service secondaire à notre API est fluide et sans tracas.
