API de géocodage précise | Documentation et exemples
Avant de commencer
De même, le géocodage inversé convertit les coordonnées géographiques en une adresse lisible.
Comment utiliser l'API de géocodage
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
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 :
- Ouvrez Postman
- Cliquez sur le bouton « Importer » en haut à gauche.
- Sélectionnez « Importer depuis le lien » et collez ce lien de collection Postman : https://www.postman.com/distancematrix/workspace/distance-matrix/overview
- 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)
-min.webp)
-min.webp)
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
Format de demande d'API
- 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.matrice de distance .ai
- URL de la demande : Pour le géocodage, c'est /cartes/api/géocode/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 ? Adresse=Westermarkt+20, +1016+GV+Amsterdam, +Pays-Bas 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 &langue=Royaume-Uni 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 &clé=<your_access_token> pour authentifier la demande.
Paramètres facultatifs dans une demande de géocodage :
- 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 ».
Paramètres requis dans une demande de géocodage :
adresse= 10020 %Queens20 %Parc20 %Toronto%20 SUR où « 100 Queens Park, Toronto, ON » est l'adresse du Musée royal de l'Ontario
Réponses de géocodage
Notez que ces résultats doivent généralement être analysés si vous souhaitez en extraire des valeurs.
Codes d'état
Messages d'erreur
*Remarque : le champ « error_message » n'est pas toujours disponible et son contenu peut changer.
Résultats
Les champs typiques d'un résultat sont les suivants :
- emplacement : contient la latitude et la longitude. C'est généralement crucial pour les recherches d'adresses standard.
- location_type : fournit des informations supplémentaires sur l'emplacement, avec des valeurs telles que :
- « TOIT »: un géocode précis avec une précision d'adresse postale.
- « RANGE_INTERPOLATED »: résultat approximatif entre deux points précis, généralement utilisé lorsque les données sur les toits ne sont pas disponibles.
- « CENTRE_GÉOMÉTRIQUE »: centre géométrique d'une ligne ou d'une zone.
- « APPROXIMATIF »: Emplacement approximatif.
Types d'adresses et types de composants d'adresse
Le géocodeur prend en charge et renvoie différents types dans les tableaux de types d'adresses et de types de composants :
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.
L'API de géolocalisation est-elle gratuite ?
Oui, l'API de géolocalisation propose un plan gratuit dans lequel vous pouvez utiliser jusqu'à 1 000 éléments par mois.