Bevor du anfängst
Die Geokodierung wandelt eine Adresse in geografische Koordinaten um, die zum Platzieren von Markierungen auf Karten oder zum Auffinden von Adressen nützlich sind. Beispielsweise ergibt die Konvertierung von „Rockefeller Center, NY, USA“ den Breitengrad 40,7587402 und den Längengrad 73,9786736.
Ebenso konvertiert die umgekehrte Geokodierung geografische Koordinaten in eine lesbare Adresse.
So verwenden Sie die Geocoding-API
Der Geokodierungsdienst Distancematrix.ai ist über eine HTTP-Schnittstelle für eine Vielzahl von Anwendungen, einschließlich Webbrowser, Postman und direkte Anwendungsintegration. Benutzer können Standardanfragen zur Geokodierung mit einer Adresse oder Anfragen zur umgekehrten Geokodierung mit Koordinaten (Breitengrad und Längengrad) einreichen. Der Service ermöglicht es Ihnen, Anfragen weiter zu konfigurieren, indem Sie zusätzliche Parameter mit Anpassungsoptionen angeben.
Nach dem Absenden Ihrer Anfrage antwortet der Dienst mit einem JSON-formatiert Dokument mit den relevantesten Ergebnissen, ideal strukturiert für eine einfache Verwendung und Integration mit verschiedenen Plattformen — von Webbrowsern bis hin zu verschiedenen Arten von Anwendungen.
Sicherheit ist wichtig und HTTPS wird nach Möglichkeit empfohlen, insbesondere für Anwendungen, die vertrauliche Benutzerdaten wie den Standort eines Benutzers in Anfragen enthalten. Die Verwendung der HTTPS-Verschlüsselung macht Ihre Anwendung sicherer und resistenter gegen Spionage oder Manipulation.
Im Folgenden finden Sie Beispiele, die zeigen, wie Anfragen gestellt und Antworten interpretiert werden. Sie veranschaulichen den Prozess für verschiedene Plattformen und Methoden, einschließlich Browser, Postman und anwendungsbasierte Codierung.
So verwenden Sie die Geocoding-API über Postman
Unsere API ist ein vielseitiger HTTP-Dienst, der für verschiedene Anwendungsfälle und Integrationsszenarien geeignet ist. Es kann auf jede Weise verwendet werden, die Ihren Anforderungen entspricht, einschließlich direkter Browseranfragen, Codierung in verschiedenen Programmiersprachen oder Integration mit Anwendungen und Systemen.
Eine der einfachsten und effizientesten Möglichkeiten, mit der Interaktion und Integration unserer API in Ihre Projekte zu beginnen, ist die Verwendung
Postbote, bekannt für seine benutzerfreundliche Oberfläche und seine leistungsstarken Funktionen.
So geht's:
Um mit Postman zu beginnen, installieren Sie es auf Ihrem Computer oder greifen Sie auf eine Browser-Webversion zu.
Importieren Sie unsere vorkonfigurierte API-Sammlung:
Nach dem Import fügt Postman die Sammlung automatisch zu Ihrem Workspace hinzu.
Für Benutzer der Online-Version von Postman können Sie den Sammlungslink direkt öffnen und einen Fork erstellen. Klicken Sie dazu auf die drei Punkte neben dem Namen der Sammlung.
Richten Sie Ihre Umgebung in Postman ein, gehen Sie zum Abschnitt Variablen und fügen Sie Ihr Authentifizierungstoken in das Feld „API-Autorisierungstoken“ ein.
Vergessen Sie nicht, diese Änderungen zu speichern.
Stellen Sie Ihre erste Anfrage: Wählen Sie einen Endpunkt aus unserer Sammlung aus, konfigurieren Sie Ihre Anforderungsparameter und klicken Sie auf Senden, um die Antwort zu sehen.
-min.webp)
Bitte beachten Sie, dass Sie Ihr individuelles Token im Admin-Panel erhalten können. Lesen Sie, wie das geht in
der Artikel.
-min.webp)
Vergessen Sie nicht, diese Änderungen zu speichern.
-min.webp)
In unserer Postman-Sammlung finden Sie alle Endpunkte, Arten von Anfragen und verfügbaren Parameter. Im Allgemeinen empfehlen wir, synchrone Anfragen zu verwenden. In Situationen, in denen Sie Massenanfragen mit einer sehr großen Anzahl von Standorten auf einmal verarbeiten müssen, sind jedoch auch asynchrone Anfragen verfügbar und können effektiv sein. Um mit ihnen zu arbeiten, klicken Sie auf Distancematrix Accurate → Bulk requests → Send a job → Body, begin work!
-min.webp)
In der Postman-Sammlung finden Sie alle Parameter, die Sie zum Einrichten Ihrer Anfragen benötigen. Wenn Sie Fragen haben, zögern Sie nicht
kontaktiere uns.
Sobald Sie mit den Grundlagen vertraut sind, können Sie die erweiterten Funktionen unserer API erkunden. Unsere ausführliche Dokumentation führt Sie durch die spezifischen Funktionen unserer API.
Erforderliche Parameter in einer Geokodierungsanforderung:
adresse: Hier müssen Sie die Straßenadresse für die Geokodierung angeben. Sie sollte gemäß den nationalen Postdienststandards des jeweiligen Landes formatiert sein, mit Ausnahme von Elementen wie Firmennamen oder Nummern von Einheiten, Suiten und Stockwerken. Verwenden Sie Leerzeichen (URL-Escaped) als %20), um Straßenadresselemente zu trennen, z. B.:
Adresse=100% 20Königinnen% 20Park% 20Toronto%20AUF wobei „100 Queens Park, Toronto, ON“ die Adresse des Royal Ontario Museum ist
Schlüssel: Für diesen Parameter ist Ihr eindeutiges API-Autorisierungstoken erforderlich. Dieses ist erforderlich, um die Identität und die Berechtigungen des Kunden zu überprüfen, der die Anfrage stellt, um einen sicheren Zugriff und eine genaue Überwachung seines Nutzungskontingents zu gewährleisten.
Weitere Informationen über den Schlüssel, seinen Zweck, den Abrufvorgang und die für den Schlüssel geltenden Geocoding-API-Grenzwerte finden Sie unter
Verknüpfung.
Geokodierung von Antworten
Unsere Geo-API konvertiert Adressen in Koordinaten (Breitengrad und Längengrad). Sie gibt Antworten in dem in der URL-Anfrage angegebenen Format zurück, z. B. JSON. Im folgenden Beispiel verwendet eine Anfrage für „1600 Amphitheatre Parkway, Mountain View, CA“ für ihre Antwort das JSON-Format, wie durch das JSON-Ausgabe-Flag in der Anfrage angegeben:
ERHALTEN:
https://api-v2.distancematrix.ai/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=<your_access_token>
Die Beispiel-JSON-Antwort:
KÖRPER
{
"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"
}
Beachten Sie, dass die JSON-Antwort zwei Stammelemente enthält:
„status“ enthält Metadaten zur Anfrage. Siehe
Statuscodes unten.
„Ergebnisse“ enthält eine Reihe von geokodierten Adressinformationen und Geometrieinformationen.
Im Allgemeinen wird bei Adresssuchen nur ein Eintrag im Array „results“ zurückgegeben, obwohl der Geocoder mehrere Ergebnisse zurückgeben kann, wenn Adressabfragen mehrdeutig sind.
Beachten Sie, dass diese Ergebnisse im Allgemeinen analysiert werden müssen, wenn Sie Werte aus den Ergebnissen extrahieren möchten.
Statuscodes
Das Feld „Status“ in der Geocoding-Antwort enthält den Anforderungsstatus und Debugging-Informationen, die bei der Diagnose von Problemen helfen. Zu den möglichen Statuswerten gehören:
„OK“: Die Anfrage war erfolgreich und Geokodierungsdaten werden zurückgegeben.
„ZERO_RESULTS“: Die Geokodierung war erfolgreich, lieferte aber keine Ergebnisse, möglicherweise aufgrund einer nicht existierenden Adresse.
„OVER_DAILY_LIMIT“: Dies kann bedeuten, dass ein ungültiger oder fehlender API-Schlüssel, keine Abrechnung für das Konto oder eine Überschreitung der Nutzungsobergrenze vorliegen.
„OVER_QUERY_LIMIT“: Ihre Nutzung hat das Kontingent überschritten.
„REQUEST_DENIED“: Die Anfrage wurde abgelehnt.
„INVALID_REQUEST“: Bedeutet oft eine fehlende Abfrage (Adresse, Komponenten oder Latlng).
„UNKNOWN_ERROR“: Ein Serverfehler ist aufgetreten; ein erneuter Versuch kann erfolgreich sein.
Fehlermeldungen
Wenn der vom Geocoder zurückgegebene Statuscode nicht „OK“ lautet, kann in der Antwort ein optionales Feld „error_message“ erscheinen. Dieses Feld enthält weitere Informationen darüber, warum dieser bestimmte Statuscode zurückgegeben wurde.
*Hinweis: Das Feld „error_message“ ist möglicherweise nicht immer verfügbar und sein Inhalt kann sich ändern.
Ergebnisse
Wenn der Geocoder Ergebnisse zurückgibt, werden sie in einem Ergebnis-Array im JSON-Format platziert. Wenn keine Ergebnisse gefunden werden (z. B. für eine nicht existierende Adresse), ist das Array leer.
Zu den typischen Feldern in einem Ergebnis gehören:
Typen [] -Array: Gibt die Art des Ergebnisses an, mit Tags wie „Lokalität“ für Städte oder „politisch“ für politische Einheiten. Zum Beispiel könnte „Chicago“ als beides gekennzeichnet werden.
formatierte_Adresse: Eine für Menschen lesbare Adresszeichenfolge, die oft einer Postanschrift ähnelt. In einigen Ländern, z. B. im Vereinigten Königreich, können echte Postanschriften jedoch möglicherweise nicht weitergegeben werden. Diese Adresse besteht aus Komponenten wie Hausnummer, Route, Stadt und Bundesland. Anstatt diese Adresse zu analysieren, verwenden Sie die separaten Adresskomponenten, die auch in der Antwort enthalten sind.
Adresskomponenten []: Ein Array der Adresskomponenten.
Jede Adresskomponente enthält in der Regel die folgenden Felder:
Typen []: Gibt den Typ jeder Adresskomponente an.
Langer Name: Stellt die vollständige Textbeschreibung oder den Namen der Adresskomponente bereit, wie sie vom Geocoder angegeben wurde.
Kurzname: Gilt für den Namen der Adresskomponente mit einer verfügbaren abgekürzten Version des Namens der Adresskomponente. Nehmen wir als Beispiel den Bundesstaat Alaska: a kurz_name von „AK“, was die zweibuchstabige postalische Abkürzung ist, und ein lang_name von „Alaska“.
Hier sind einige weitere Fakten über die Adresskomponenten [] Array, das Sie beachten sollten:
Das Adresskomponenten [] Ein Array in einer Geocoding-Antwort kann mehr Elemente als die formatted_address enthalten.
Es enthält nicht immer alle politischen Einheiten, die die Adresse enthalten, außer denen in der formatierte_Adresse. Verwenden Sie für eine vollständige Liste die umgekehrte Geokodierung mit dem Breitengrad/Längengrad der Adresse.
Das Antwortformat, einschließlich der Anzahl und Art der Adresskomponenten, kann je nach Anforderung und im Laufe der Zeit für dieselbe Adresse variieren. Komponenten können sich in Position und Typ ändern oder in nachfolgenden Antworten weggelassen werden.
Um die Antwort des Geocoders effektiv nutzen zu können, müssen Sie das Array der Komponenten analysieren:
PLZ_Ortschaften []: Dieses Array listet alle Orte innerhalb einer Postleitzahl auf. Es erscheint nur für Postleitzahlen, die mehrere Orte umfassen.
Geometrie: Enthält wichtige Informationen wie:
partielles Spiel: Weist auf eine nicht exakte Übereinstimmung mit der Anfrage hin. Dies ist nützlich, um potenzielle Probleme wie Rechtschreibfehler oder unvollständige Adressen zu identifizieren. Teilweise Treffer treten häufig bei nicht existierenden Straßenadressen auf oder wenn eine Adresse mit mehreren Orten in derselben Gegend übereinstimmt. Beispielsweise könnte eine falsch geschriebene Adresse (sei es „21 Henr St, Bristol, UK“) eine ähnlich klingende Straße als unvollständige Übereinstimmung zurückgeben („Henry Street“ und „Henrietta Street“).
Adresstypen und Adresskomponententypen
Das Typen [] array in the geocoding result specifies the address type, such as a street address, country, or political entity. There's also a types[] array within address_components[] that specifies the type of each address part, such as street number or country. Addresses can have multiple types, functioning as 'tags'. For example, cities often have tags like 'political' and 'locality'.
The geocoder supports and returns various types in both address type and component type arrays:
street_address: A precise street address.
route: A named route like "US 101".
intersection: A major intersection of two major roads.
political: A political entity, usually indicating a civil administration polygon.
country: The national political entity, often the highest order type.
administrative_area_level_1: A primary civil entity below the country level, like states in the USA. These often align with ISO 3166-2 subdivisions.
administrative_area_level_2: A secondary civil entity, like counties in the USA.
administrative_area_level_3/administrative_area_level_4/administrative_area_level_5: Lower order civil entities, representing minor divisions.
colloquial_area: A commonly used alternative name for the entity.
locality: An incorporated city or town.
sublocality (and levels 1-5: sublocality_level_1 to sublocality_level_5): Lower order entities within a locality.The smaller geographic area the larger numbers.
neighborhood: A named neighborhood.
premise: A named location, typically a building or complex.
subpremise: A part of a larger premise, like a building within a complex.
postal_code: A postal code used within the country.
natural_feature: A significant natural feature.
point_of_interest: A prominent entity like "Empire State Building" or "Eiffel Tower".
If an address component's type list is empty, it means that no specific types are known for that component, such as a 'Lieu-dit' in France. Additionally, address components may include:
floor: The floor number in a building.
establishment: A place not yet categorized.
point_of_interest: A named point of interest.
parking: A parking lot or structure.
post_box: A specific postal box.
postal_town: A geographic area grouping used for mailing addresses in some countries.
room: A room in a building.
street_number: The precise street number.
bus_station, train_station, transit_station: Locations of bus, train, or public transit stops.
FAQ
What differentiates this API from other Geocoding APIs?
The Distancematrix.ai Geocoding API has several factors that differentiate it from other geocoding APIs:
High Accuracy: The Distancematrix.ai Geocoding API uses advanced algorithms and data sources to provide accurate and reliable geocoding results. The API also has a high success rate for matching addresses, which means that it can handle a wide range of address formats and variations.
Global Coverage: The API covers a wide range of countries and regions, including hard-to-reach places like rural areas, islands, and developing countries. This means that users can rely on the API to provide accurate results no matter where their data is coming from.
Speed and Scalability: The API is designed to handle large volumes of geocoding requests quickly and efficiently.
Cost-Effective: The API offers a simple and transparent pricing model, with no hidden fees or upfront costs. The API offers a Free plan and a Growth plan with pay-as-you-go pricing model.
Can I use this API as a converting address to lat long API?
Yes, you can use the Distancematrix.ai Geocoding API to convert addresses to latitude-longitude coordinates. In fact, that is one of the primary functions of an address to lat long API like this one.
To use the API for geocoding, you would send a request to the API with an address parameter, and the API would respond with the corresponding lat-long coordinates for that address.
The Distancematrix.ai Geocoding API is designed as a get latitude longitude from address API that is easy to use. It can be integrated into a wide range of applications and platforms. The API supports a variety of programming languages and frameworks, including Python, JavaScript, and PHP, among others.
Can I use this API as a latitude longitude API converter to human-readable addresses?
Yes, you can use the Distancematrix.ai Geocoding API to convert latitude-longitude (lat-long) coordinates to human-readable addresses. This process is also known as reverse geocoding and developers usually search for a latitude and longitude API or for aget coordinates from address API.
To use the API for reverse geocoding, you would send a request to the API with the latitude and longitude parameters, and the API would respond with the corresponding human-readable address for those coordinates.
If you have any questions or need further assistance in using the API for your reverse geocoding needs, the Distancematrix.ai team provides detailed documentation and customer support to help you get started.
What can you do with the Geocoding API?
Many companies and enterprises use software and applications to locate stores, warehouses, vehicles, and customers, to control transportation and movements that deal with geocoding. But currently, its definition is not limited to address searches. It is quite a universal tool that allows you to apply it to the overall market, from precise location and route mapping to customer data analysis and geographic pattern recognition.
This solution is in handy among, for example, taxi drivers in case they lack accurate data about the clients' destination addresses. Also, this service is convenient for food delivery couriers in their daily routines. You can read other successful geocoding API examples using our website.
Why use the Geocoding API?
The Distancematrix.ai APIs offer best-in-class accuracy that rivals industry giants but at a much more affordable price, greater scalability, and a friendly, real human support team that is always available to help you with your questions. An added benefit is the ease of transition from other vendors, ensuring a smooth switching process.
In addition, Distancematrix.ai allows users to test the service without the need to attach a credit/debit card before making a final decision. This is done so that users can verify the quality and value of the results obtained. Feel free to try to make sure that Distancematrix.ai is a high-quality and fast, yet cost-effective solution. What’s more, even during the trial period, users can reach out to the live support available for any queries.
