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.
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-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 [] Das Array im Geokodierungsergebnis gibt den Adresstyp an, z. B. eine Straßenadresse, ein Land oder eine politische Einheit. Es gibt auch eine Typen [] Array innerhalb Adresskomponenten [] das gibt den Typ jedes Adressteils an, z. B. Hausnummer oder Land. Adressen können mehrere Typen haben und als „Tags“ dienen. Städte haben beispielsweise häufig Stichwörter wie „politisch“ und „örtlich“.
Der Geocoder unterstützt verschiedene Typen in Adresstyp- und Komponententyp-Arrays und gibt sie zurück:
straße_adresse: Eine genaue Adresse.
Reiseroute: Eine benannte Route wie „US 101".
Kreuzung: Eine wichtige Kreuzung zweier Hauptstraßen.
politisch: Eine politische Einheit, die in der Regel auf ein Polygon der Zivilverwaltung hinweist.
Land: Die nationale politische Einheit, oft die höchste Ordnung.
Verwaltungsbereich_Ebene_1: Eine primäre zivile Einheit unterhalb der Landesebene, wie Staaten in den USA. Diese entsprechen häufig den Unterabteilungen nach ISO 3166-2.
Verwaltungsbereich_Ebene_2: Eine sekundäre zivile Einheit, wie Bezirke in den USA.
Verwaltungsbereich_Ebene_3/Verwaltungsbereich_Ebene_4/Verwaltungsbereich_Ebene_5: Zivilbehörden unterer Ordnung, die kleinere Abteilungen vertreten.
Umgangssprachlicher Bereich: Ein häufig verwendeter alternativer Name für die Entität.
Lokalität: Eine eingemeindete Stadt oder Gemeinde.
Sublokalität (und Stufen 1-5: sublocality_level_1 bis sublocality_level_5): Entitäten niedrigerer Ordnung innerhalb einer Lokalität. Je kleiner das geografische Gebiet, desto größer die Zahlen.
Nachbarschaft: Ein benanntes Viertel.
Prämisse: Ein benannter Standort, in der Regel ein Gebäude oder ein Komplex.
Unterprämisse: Ein Teil eines größeren Geländes, wie ein Gebäude innerhalb eines Komplexes.
postleitzahl: Eine innerhalb des Landes verwendete Postleitzahl.
natürliches_Merkmal: Ein bedeutendes natürliches Merkmal.
flughafen: Ein Flughafen.
Parken: Ein benannter Park.
Sehenswürdigkeit: Ein prominentes Objekt wie das „Empire State Building“ oder der „Eiffelturm“.
Wenn die Typliste einer Adresskomponente leer ist, bedeutet dies, dass für diese Komponente keine bestimmten Typen bekannt sind, z. B. ein „Lieu-dit“ in Frankreich. Darüber hinaus können Adresskomponenten Folgendes enthalten:
Stockwerk: Die Stockwerksnummer in einem Gebäude.
Einrichtung: Ein Ort, der noch nicht kategorisiert ist.
Sehenswürdigkeit: Eine benannte Sehenswürdigkeit.
Parken: Ein Parkplatz oder ein Gebäude.
postfach: Ein bestimmtes Postfach.
postal_ort: Eine geografische Gebietsgruppierung, die in einigen Ländern für Postanschriften verwendet wird.
zimmer: Ein Zimmer in einem Gebäude.
straße_nummer: Die genaue Hausnummer.
Busstation, Bahnstation, Transitstation: Standorte von Haltestellen von Bus-, Zug- oder öffentlichen Verkehrsmitteln.
FAQ
Was unterscheidet diese API von anderen Geocoding-APIs?
Die Distancematrix.ai Geocoding-API unterscheidet sich durch mehrere Faktoren von anderen Geocoding-APIs:
Hohe Genauigkeit: Die Distancematrix.ai Geocoding API verwendet fortschrittliche Algorithmen und Datenquellen, um genaue und zuverlässige Geokodierungsergebnisse zu liefern. Die API weist auch eine hohe Erfolgsquote beim Abgleich von Adressen auf, was bedeutet, dass sie eine Vielzahl von Adressformaten und -variationen verarbeiten kann.
Weltweite Abdeckung: Die API deckt eine Vielzahl von Ländern und Regionen ab, einschließlich schwer erreichbarer Orte wie ländliche Gebiete, Inseln und Entwicklungsländer. Dies bedeutet, dass sich Benutzer darauf verlassen können, dass die API genaue Ergebnisse liefert, unabhängig davon, woher ihre Daten stammen.
Geschwindigkeit und Skalierbarkeit: Die API ist so konzipiert, dass große Mengen an Geokodierungsanfragen schnell und effizient bearbeitet werden können.
Kostengünstig: Die API bietet ein einfaches und transparentes Preismodell ohne versteckte Gebühren oder Vorabkosten. Die API bietet einen kostenlosen Tarif und einen Wachstumsplan mit nutzungsbasiertem Preismodell.
Kann ich diese API als Konvertierungsadresse für eine Lat Long-API verwenden?
Ja, Sie können die Geocoding-API von Distancematrix.ai verwenden, um Adressen in Breiten- und Längengradkoordinaten umzuwandeln. Tatsächlich ist dies eine der Hauptfunktionen einer Adress to Lat Long-API wie dieser.
Um die API für die Geokodierung zu verwenden, würden Sie eine Anfrage mit einem Adressparameter an die API senden, und die API würde mit den entsprechenden Längen- und Längenkoordinaten für diese Adresse antworten.
Die Geocoding-API von Distancematrix.ai wurde als einfach zu verwendende API zum Abrufen von Breitengrad und Längengrad von Adressen konzipiert. Sie kann in eine Vielzahl von Anwendungen und Plattformen integriert werden. Die API unterstützt eine Vielzahl von Programmiersprachen und Frameworks, darunter Python, JavaScript und PHP.
Kann ich diese API als API-Konverter für Breitengrad und Längengrad in menschenlesbare Adressen verwenden?
Ja, Sie können die Geocoding-API von Distancematrix.ai verwenden, um Breitengrad- und Längengradkoordinaten (Breitengrad) in menschenlesbare Adressen umzuwandeln. Dieser Vorgang wird auch als umgekehrte Geokodierung bezeichnet. Entwickler suchen in der Regel nach einer Breitengrad- und Längengrad-API oder nach Aget-Koordinaten von der Adressen-API.
Um die API für die umgekehrte Geokodierung zu verwenden, würden Sie eine Anfrage mit den Breitengrad- und Längengradparametern an die API senden, und die API würde mit der entsprechenden menschenlesbaren Adresse für diese Koordinaten antworten.
Wenn Sie Fragen haben oder weitere Unterstützung bei der Verwendung der API für Ihre Reverse-Geocoding-Anforderungen benötigen, stellt Ihnen das Team von Distancematrix.ai eine ausführliche Dokumentation und Kundensupport zur Verfügung, um Ihnen den Einstieg zu erleichtern.
Was können Sie mit der Geocoding-API machen?
Viele Unternehmen und Unternehmen verwenden Software und Anwendungen, um Geschäfte, Lagerhäuser, Fahrzeuge und Kunden zu lokalisieren und Transporte und Bewegungen zu steuern, die mit der Geokodierung zu tun haben. Derzeit ist die Definition jedoch nicht auf Adresssuchen beschränkt. Es ist ein ziemlich universelles Tool, mit dem Sie es auf den Gesamtmarkt anwenden können, von der genauen Standort- und Routenkartierung bis hin zur Analyse von Kundendaten und geografischer Mustererkennung.
Diese Lösung ist beispielsweise für Taxifahrer praktisch, falls ihnen genaue Daten über die Zieladressen der Kunden fehlen. Dieser Service ist auch praktisch für Kuriere, die Lebensmittel liefern, in ihrer täglichen Routine. Weitere Beispiele für erfolgreiche Geokodierungs-APIs finden Sie in unserer Webseite.
Warum die Geocoding-API verwenden?
Die APIs von Distancematrix.ai bieten eine erstklassige Genauigkeit, die mit Branchenriesen mithalten kann, aber zu einem viel günstigeren Preis, einer höheren Skalierbarkeit und einem freundlichen, echten menschlichen Support-Team, das Ihnen bei Ihren Fragen jederzeit zur Verfügung steht. Ein zusätzlicher Vorteil ist die einfache Umstellung von anderen Anbietern, wodurch ein reibungsloser Umstellungsprozess gewährleistet wird.
Darüber hinaus ermöglicht Distancematrix.ai Benutzern, den Dienst zu testen, ohne eine Kredit-/Debitkarte beifügen zu müssen, bevor sie eine endgültige Entscheidung treffen. Dies geschieht, damit Benutzer die Qualität und den Wert der erzielten Ergebnisse überprüfen können. Sie können gerne versuchen, sicherzustellen, dass Distancematrix.ai eine qualitativ hochwertige und schnelle und dennoch kostengünstige Lösung ist. Darüber hinaus können sich Benutzer auch während der Testphase an den Live-Support wenden, der für alle Fragen zur Verfügung steht.
