Reverse Geocoding API Accurate | Documentation & Examples

Bevor du anfängst

Geokodierung ist der Prozess, bei dem eine Adresse mithilfe einer API in Breiten- und Längengradkoordinaten umgewandelt wird. Bei der umgekehrten Geokodierung werden geografische Koordinaten (Breitengrad und Längengrad) über eine API in eine menschenlesbare Adresse umgewandelt.

Wenn Sie beispielsweise geografische Koordinaten wie den Breitengrad 40,758678 und den Längengrad 73,978798 mithilfe der Reverse-Geocoding-API konvertieren, erhalten Sie die genaue Adresse „35 Rockefeller Plaza, New York, NY 10111, USA“.

DistanceMatrix.ai bietet beide Lösungen, die Reverse Geocoding API zum Umwandeln von Breiten- und Längengraden in Adressen und die Direct Geocoding API zum Umwandeln von Adressen auf der Karte in geografische Koordinaten.

So verwenden Sie die Reverse Geocoding API

Dieser Service ist zugänglich über eine HTTP Schnittstelle. Für Reverse-Geocoding-Anfragen müssten Sie eine Abfrage als Koordinaten (Breitengrad und Längengrad) einreichen. In der folgenden Liste sind sowohl die erforderlichen als auch die optionalen Parameter für diese Anfragen aufgeführt.

Bei der Anfrage erhalten Sie eine Antwort in Form einer JSON Dokument mit den relevantesten Ergebnissen. Beispiele für solche Anfragen und die entsprechenden Antworten finden Sie in der folgenden Dokumentation.

Sicherheit steht an erster Stelle. Aus diesem Grund wird HTTPS dringend empfohlen, insbesondere für Anwendungen, die mit sensiblen Daten wie dem Standort des Benutzers umgehen. Die HTTPS-Verschlüsselung erhöht die Sicherheit Ihrer App und macht sie widerstandsfähiger gegen Überwachung und Änderung.

Unsere Reverse-Geocoding-API bietet Ihnen die Flexibilität, Anfragen so zu stellen, wie es Ihren Anforderungen am besten entspricht. Die detaillierten Anweisungen oben zeigen Ihnen, wie Sie diese Anfragen mit Postman, einem vielseitigen und einfach zu bedienenden API-Interaktionstool, stellen.

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 in Anwendungen und Systeme.

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.
Bitte beachten Sie, dass Sie Ihr individuelles Token im Admin-Panel erhalten können. Lesen Sie, wie das geht in der Artikel.
Vergessen Sie nicht, diese Änderungen zu speichern.
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!
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.

Reverse-Geocoding-Entwicklerhandbuch

API-Anforderungsformat

Unsere Distancematrix.ai Reverse Geocoding API verwendet ein Anforderungsformat, das anderen Industriestandard-APIs ähnelt, und gewährleistet so einen intuitiven und reibungslosen Übergang für Benutzer, die mit Standard-Geokodierungswerkzeugen vertraut sind.

Hier ist ein Beispiel dafür, wie eine richtige API-Anfrage aussehen würde/könnte:
ERHALTEN:
https://api.distancematrix.ai/maps/api/geocode/json?latlng=37.422387799999996,-122.08418770000002&language=uk&key=<your_access_token>
Kopiert!
Bestandteile der Anfrage:
  • HTTPS-Verschlüsselung: https:// wird für sichere Kommunikation verwendet.
  • Domäne: api.distancematrix.ai ist die Domain für die genaue API.
  • Pfad der Anfrage: /maps/api/geocode/json gibt die Art der Anfrage an.
  • Erforderlicher Parameter: ?latlng=37,422387799999996,-122,08418770000002 gibt den Breiten- und Längengrad für die umgekehrte Geokodierung an.
  • Optionaler Parameter: &language=uk kann für die Sprachpräferenz hinzugefügt werden.
  • Autorisierungstoken: &key=<your_access_token> ist für die Authentifizierung der Anfrage erforderlich.
Parameter werden standardmäßig in URLs mit dem Und-Zeichen (&) getrennt.

Dieses Setup ist auf die Reverse Geocoding API zugeschnitten, bei der im Vergleich zur Standard-Geokodierung andere Parameter verwendet werden. Auf dieser Seite erfahren Sie, wie Sie Längen- und Breitengrade von einer Adressen-API abrufen können, einschließlich der zu verwendenden erforderlichen und optionalen Parameter und der Art der Geocoding-Antwort, die Sie erwarten können. Zusätzlich wird ein Beispiel für eine JSON-Antwort bereitgestellt, die auf dem Ausgabe-Flag basiert.

Hier ist zum Beispiel ein Anforderungsbeispiel, um die Koordinaten der ägyptischen Pyramiden in eine Adresse umzurechnen, die Ergebnisse jedoch auf Englisch statt auf Arabisch zu erhalten:
https://api.distancematrix.ai/maps/api/geocode/json?latlng=29.976480,%2031.131302&language=en&key=access_token
Kopiert!

Erforderliche Parameter in einer Reverse-Geocoding-Anfrage:

latlang: Dieser erforderliche Parameter enthält die Längen- und Breitengradwerte zur Angabe des Standorts, für den Sie die Adresse abrufen möchten. Beispiel:
latlng=37.422387799999996,-122.08418770000002
Kopiert!
Schlüssel: Ein eindeutiger API-Schlüssel, der den Anforderer authentifiziert und die Kontingentberechnung ermöglicht. Dieser Schlüssel muss in jeder Anfrage enthalten sein. Hängen Sie Ihren API-Schlüssel im folgenden Format an die Anfrage an &key=<your_access_token>.
Folgen Sie dem Verknüpfung um mehr über den Schlüssel, seinen Zweck, seine Erreichbarkeit und die Beschränkungen der Reverse Geocoding API zu erfahren.

Optionale Parameter in einer Reverse-Geocoding-Anfrage:

Sprache: Legt die Sprache für Ergebnisse fest.
  • Die unterstützten Sprachen sind auf der Website aufgeführt.
  • Wenn nicht angegeben, wird standardmäßig der Accept-Language-Header oder die Domänensprache der Anfrage verwendet.
  • Reverse Geocoding liefert lesbare Straßenadressen in der Landessprache, die bei Bedarf transliteriert werden, und verwendet die bevorzugte Sprache für alle anderen Adressen. Wenn ein Name in der ausgewählten Sprache nicht verfügbar ist, wird der Name verwendet, der am nächsten kommt.
Zeige die Liste der Sprachen
Zeige Sprachen
Sprachen ausblenden
Sprachcode
Sprache
Sprachcode
Sprache
Af
Afrikaans
ja
japanisch
q
albanisch
kn
Kannada
bin
Amharisch
kk
kasachisch
bin
Arabisch
km
Khmer
warum
Armenisch
Ko
Koreanisch
az
aserbaidschanisch
Ky
Kirgisisch
eu
baskisch
lo
laotisch
Sein
Belarussisch
lv
lettisch
bn
Bengalisch
lt
litauisch
bs
Bosnisch
mk
mazedonisch
bg
bulgarisch
Frau
malaiisch
meine
birmanisch
Mililiter
Malayalam
ca.
katalanisch
Herr
Marathi
zh
chinesisch
mn
mongolisch
zh-CN
Chinesisch (vereinfacht)
ne
Nepali
zh-HK
Chinesisch (Hongkong)
nein
norwegisch
zh-TW
Chinesisch (traditionell)
pl
polnisch
Std.
kroatisch
Portugal
portugiesisch
cs
tschechisch
pt-BR
Portugiesisch (Brasilien)
da
dänisch
pt-PT
Portugiesisch (Portugal)
nl
Holländisch
pa
Panjabi
en
Englisch
Ro
rumänisch
de-AU
Englisch (australisch)
ru
Russisch
de-GB
Englisch (Großbritannien)
sr
serbisch
et
estnisch
si
Singhalesisch
fa
Farsi
sk
slowakisch
fi
finnisch
sl
slowenisch
Fil
Philippinisch
Ja
Spanisch
fr
Französisch
es-419
Spanisch (Lateinamerika)
FR-CA
Französisch (Kanada)
sw
Suaheli
gl
galizisch
sv
schwedisch
Ka
georgisch
ta
Tamilisch
de
Deutsch
te
Telugu
el
griechisch
th
thailändisch
Gu
Gujarati
tr
türkisch
iw
hebräisch
Vereinigtes Königreich
Ukrainisch
hi
Hindi
Ur
Urdu
hu
ungarisch
uz
Usbekisch
ist
Isländisch
vi
Vietnamesisch
id
Indonesisch
zu
Zulu
es
Italienisch


Ergebnistyp: Filtert Ergebnisse nach Adresstypen, wobei ein Pipe (|) für mehrere Typen verwendet wird. Es fungiert als Filter nach der Suche und verwirft Ergebnisse, die nicht den angegebenen Typen entsprechen. Zu den unterstützten Typen gehören:
  • straße_adresse: Genaue Straßenanschrift.
  • Route: Benannte Routen wie „US 101".
  • Schnittpunkt: Wichtige Kreuzungen.
  • politisch: Politische Einheiten.
  • Land: Nationale politische Einheiten.
  • Verwaltungsbereich_Ebene_1 zu Verwaltungsbereich_Ebene_5: Verschiedene Ebenen ziviler Einrichtungen unterhalb des Landes.
  • Umgangssprachlicher Bereich: Häufig verwendete Namen.
  • Lokalität: Städte oder Gemeinden.
  • Sublokalität (und Unterlokalisierung_Ebene_1 zu sublocality_level_5): Entitäten unterhalb einer Lokalität.
  • Nachbarschaft: Nachbarschaften.
  • Prämisse: Benannte Orte wie Gebäude.
  • Unterprämisse: Entitäten innerhalb einer größeren Prämisse.
  • postleitzahl: Postleitzahlen.
  • natürliches_Merkmal: Naturdenkmäler.
  • Flughafen: Flughäfen.
  • Park: Parks.
  • Sehenswürdigkeit: Sehenswürdigkeiten, wie berühmte Gebäude.
standort_typ: Filtert nach Positionstypen, wobei wiederum ein senkrechter Strich (|) für Vielfache verwendet wird. Es filtert die Suchergebnisse nach und behält nur diejenigen bei, die den angegebenen Typen entsprechen. Folgende Typen werden unterstützt:
  • DACHTERRASSE„: Präzise Standorte auf Straßenadressebene.
  • BEREICH_INTERPOLIERT„: Annäherungen zwischen präzisen Punkten.
  • GEOMETRISCHES_MITTELPUNKT„: Mittelpunkte von Linien oder Bereichen.
  • UNGEFÄHRE„: Ungefähre Standorte.
Wenn beide Ergebnistyp und standort_typ Filter werden verwendet, nur Ergebnisse, die beiden entsprechen, werden zurückgegeben. Wenn keine Treffer gefunden werden, gibt die API "zurückNULL_ERGEBNISSE„.

Antworten mit umgekehrter Geokodierung

Die angegebene Anfrage verwendet die Reverse-Geocoding-API, um die Breiten- und Längengradkoordinaten '40.714224, -73.961452' in Brooklyn in eine für Menschen lesbare Adresse zu konvertieren und spezifiziert, dass die Antwort im JSON-Format sein soll.

So ist die Anfrage strukturiert:
ERHALTEN:
https://api.distancematrix.ai/maps/api/geocode/json?latlng=40.714224,-73.961452&key=<your_access_token>
Kopiert!
*Wichtiger Hinweis: Bei der Eingabe latong Parameter, stellen Sie sicher, dass zwischen den Breiten- und Längengraden kein Leerzeichen besteht.
Beispiel für eine JSON-Antwort:
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"
}
Kopiert!
Das“formatierte_Adresse„Die Ergebnisse umfassen verschiedene Möglichkeiten, einen Standort geografisch zu benennen, z. B. Straßenadressen, Städtenamen, Bundesstaaten oder Länder, wobei jeder dieser Typen als gültige Ergebnisse zurückgegeben wird. Beispielsweise kann die Geokodierung eines Punkts in Chicago als Adresse, Stadt (Chicago), Bundesstaat (Illinois) oder Land (USA) dargestellt werden. Der Reverse-Geocoder gleicht politische Einheiten, Straßenadressen und Postleitzahlen ab.

* Wichtiger Hinweis: Bei der umgekehrten Geokodierung wird die nächste adressierbare Position innerhalb eines bestimmten Toleranzbereichs geschätzt und zurückgegeben Null Ergebnisse, wenn keine enge Übereinstimmung gefunden wird.

Bitte beachten Sie, dass die JSON-Antwort zwei Hauptelemente hat:
„Status“: Dieses Element stellt Metadaten zur Anfrage bereit. Beziehen Sie sich auf die Statuscodes weiter unten finden Sie weitere Informationen.
„Ergebnis“: Dazu gehört ein Array mit geokodierten Adressdetails und Geometrieinformationen.
Beachten Sie, dass Sie zum Extrahieren bestimmter Werte aus diesen Ergebnissen in der Regel das JSON analysieren müssen, was wiederum ein unkomplizierter Prozess ist.

Statuscodes

In der Geocoding-Antwort ist der“StatusDas Feld „zeigt den Status der Anfrage an und kann Debugging-Details enthalten. Mögliche Werte sind:
„OK“: Keine Fehler; die Adresse wurde verarbeitet und Geocode (s) zurückgegeben.
„NULL_ERGEBNISSE“: Die Geokodierung war erfolgreich, aber es wurden keine Ergebnisse gefunden, möglicherweise aufgrund einer nicht existierenden Adresse.
„ÜBER_TÄGLICHES_LIMIT“: Könnte bedeuten, dass ein API-Schlüssel fehlt/ungültig ist, keine Abrechnung aktiviert ist oder eine Nutzungsobergrenze überschritten wurde.
„ÜBER_ABFRAGELIMIT“: Weist auf eine Übernutzung des Kontingents hin.
„ANFRAGE_VERWEIGERT“: Ihre Anfrage wurde abgelehnt.
„UNGÜLTIGE_ANFRAGE“: Bedeutet in der Regel fehlende Abfragedetails (Adresse, Komponenten oder latong).
„UNBEKANNTER_FEHLER“: Ein Serverfehler verhinderte die Verarbeitung. Ein erneuter Versuch könnte erfolgreich sein.

Fehlermeldungen

Wenn der Statuscode des Geocoders etwas anderes ist als“OK„, und“error_messageDas Feld“ kann in der Antwort erscheinen. Dieses Feld enthält detaillierte Gründe für den spezifischen Statuscode.

*Wichtiger Hinweis: Das“error_messageDas Feld“ ist nicht immer enthalten und sein Inhalt kann variieren.

Ergebnisse

Wenn der Geocoder Ergebnisse generiert, werden sie in einem Ergebnis-Array im JSON-Format platziert. Wenn keine Ergebnisse gefunden werden, z. B. bei einer nicht vorhandenen Adresse, wird das Array leer zurückgegeben.

Zu den wichtigsten Feldern in einem typischen 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“.
Beachten Sie diese Punkte über die Adresskomponenten [] Array in den Geokodierungsergebnissen:
Das Array kann mehr Elemente enthalten als formatierte_Adresse.
Es umfasst nicht immer alle politischen Einheiten einer Adresse, nur die in der formatierte_Adresse. Verwenden Sie die umgekehrte Geokodierung mit Breitengrad/Längengrad, um eine umfassende Liste zu erhalten.
Das Antwortformat, einschließlich der Anzahl und Art der Adresskomponenten, kann bei jeder Anfrage und im Laufe der Zeit für dieselbe Adresse variieren. Komponenten können ihre Position ändern, ihren Typ ändern oder in nachfolgenden Antworten fehlen.
Um die Geokodierungsantwort effektiv nutzen zu können, müssen Sie das Array der Komponenten analysieren und nach Bedarf Werte auswählen.
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 Standortdetails:
  • Standort: Der geokodierte Breiten- und Längengrad. Dies ist häufig das wichtigste Feld für Standardadresssuchen.
  • standort_typ: Zusätzliche Informationen zum Standort. Zu den unterstützten Werten gehören:
    • DACHTERRASSE“: Ein präziser Geocode mit exakter Straßenadresse.
    • BEREICH_INTERPOLIERT„: Ein ungefähres Ergebnis, das häufig verwendet wird, wenn bestimmte Dachdaten nicht verfügbar sind.
    • GEOMETRISCHES_MITTELPUNKT„: Der Mittelpunkt einer Linie oder Fläche.
    • UNGEFÄHRE“: Ein geschätzter Standort.
partielles Spiel: Zeigt eine nicht exakte Übereinstimmung an, bei der nur ein Teil der angeforderten Adresse gefunden werden konnte. Dies ist häufig bei Straßenadressen der Fall, die innerhalb des angeforderten Orts nicht existieren, oder wenn eine Adresse mehreren Orten entspricht. Beispielsweise könnte eine Anfrage mit einer leicht falsch geschriebenen Adresse eine nahegelegene, korrekt geschriebene Adresse als teilweise Übereinstimmung zurückgeben.

Adresstypen und Adresskomponententypen

Das Typen [] Array in den Geokodierungsergebnissen gibt den Adresstyp an, der Folgendes beinhalten kann:
straße_adresse: Eine bestimmte Straßenadresse.
Route: Eine benannte Route wie „US 101“.
Schnittpunkt: Eine wichtige Kreuzung zweier Straßen.
politisch: Eine politische Einheit, oft ein Bereich der Zivilverwaltung.
Land: Die nationale politische Einheit, in der Regel die oberste Ebene.
Verwaltungsbereich_Ebene_2: Eine sekundäre zivile Einheit, z. B. Bezirke in den USA.
Verwaltungsbereich_Ebene_3 zu Verwaltungsbereich_Ebene_5: Zivilabteilungen niedrigerer Ordnung.
Andere unterstützte Typen sind:
Umgangssprachlicher Bereich: Ein alternativer Name für einen Ort.
Lokalität: Eine eingemeindete Stadt oder Gemeinde.
Sublokalität (und Stufen 1-5): Eine zivile Einheit innerhalb eines Ortes.
Nachbarschaft: Eine bestimmte Nachbarschaft.
Prämisse: Ein benanntes Gebäude oder Komplex.
Unterprämisse: Eine Einheit in einem größeren Gebäude.
postleitzahl: Die Postleitzahl.
natürliches_Merkmal: Bemerkenswerte Naturdenkmäler.
Flughafen: Ein Flughafen.
Park: Ein benannter Park.
Sehenswürdigkeit: Signifikante lokale Einheiten wie Wahrzeichen.
Eine leere Typenliste bedeutet, dass keine Typen für diese Adresskomponente bekannt sind. Zu den weiteren Typen gehören:
Fußboden: Gebäudegeschoss.
Einrichtung: Nicht klassifizierte Orte.
Parkplatz: Parkplätze.
postfach: Spezifische Postfächer.
postal_town: Geografische Gebiete, die für Postanschriften verwendet werden.
Platz: Bestimmte Räume in einem Gebäude.
straße_nummer: Genaue Hausnummer.
Busstation, Bahnstation, Transitstation: Haltestellen des Transports.

FAQ

Was können Sie mit der Reverse Geocoding API machen?

Unternehmen, die sich mit Geokodierung befassen, verwenden häufig APIs für direkte Geokodierung und umgekehrte Geokodierung in Software und Apps, um Geschäfte, Fahrzeuge und Kunden zu lokalisieren und so das Transportmanagement und die Bewegungsverfolgung zu unterstützen.

Die umgekehrte Geokodierung ist mehr als nur die Identifizierung/Platzierung von Adressen. Sie ist ein vielseitiges Tool für die Standortkartierung, Routenplanung und Datenanalyse. Diese Technologie kann für Logistikunternehmen von Vorteil sein, die genaue Standortangaben benötigen. Weitere Beispiele aus der Praxis für die Reverse-Geocoding-API in Aktion finden Sie auf unserer Webseite.

Warum sollte ich die Reverse Geocoding API verwenden?

Die Reverse-Geocoding-API von DistanceMatrix.ai bietet genaue Standortdaten von 99% der Welt in einer Vielzahl von Formaten. Damit Sie von überall aus in Sekundenschnelle die richtige Adresse abrufen können. Aus diesem Grund ist unser Tool in zahlreichen Branchen sehr gefragt. Außerdem konkurriert es aufgrund seiner hohen Genauigkeit mit führenden Anbietern auf diesem Gebiet. Eine weitere Sache, die Sie beachten sollten, ist, dass der Umstellungsprozess von beliebigen Nebendiensten zu unserer API nahtlos und problemlos verläuft.

Bevor du anfängst

Geokodierung ist der Prozess, bei dem eine Adresse mithilfe einer API in Breiten- und Längengradkoordinaten umgewandelt wird. Bei der umgekehrten Geokodierung werden geografische Koordinaten (Breitengrad und Längengrad) über eine API in eine menschenlesbare Adresse umgewandelt.

Wenn Sie beispielsweise geografische Koordinaten wie den Breitengrad 40,758678 und den Längengrad 73,978798 mithilfe der Reverse-Geocoding-API konvertieren, erhalten Sie die genaue Adresse „35 Rockefeller Plaza, New York, NY 10111, USA“.

DistanceMatrix.ai bietet beide Lösungen, die Reverse Geocoding API zum Umwandeln von Breiten- und Längengraden in Adressen und die Direct Geocoding API zum Umwandeln von Adressen auf der Karte in geografische Koordinaten.

So verwenden Sie die Reverse Geocoding API

Dieser Service ist zugänglich über eine HTTP Schnittstelle. Für Reverse-Geocoding-Anfragen müssten Sie eine Abfrage als Koordinaten (Breitengrad und Längengrad) einreichen. In der folgenden Liste sind beide Parameter für diese Anfragen aufgeführt.

Bei der Anfrage erhalten Sie eine Antwort in Form einer JSON Dokument mit den relevantesten Ergebnissen. Beispiele für solche Anfragen und die entsprechenden Antworten finden Sie in der folgenden Dokumentation.

Sicherheit steht an erster Stelle. Aus diesem Grund wird HTTPS dringend empfohlen, insbesondere für Anwendungen, die mit sensiblen Daten wie dem Standort des Benutzers umgehen. Die HTTPS-Verschlüsselung erhöht die Sicherheit Ihrer App und macht sie widerstandsfähiger gegen Überwachung und Änderung.

Unsere Reverse-Geocoding-API bietet Ihnen die Flexibilität, Anfragen so zu stellen, wie es Ihren Anforderungen am besten entspricht. Die detaillierten Anweisungen oben zeigen Ihnen, wie Sie diese Anfragen mit Postman, einem vielseitigen und einfach zu bedienenden API-Interaktionstool, stellen.

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 in Anwendungen und Systeme.

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.
Bitte beachten Sie, dass Sie Ihr individuelles Token im Admin-Panel erhalten können. Lesen Sie, wie das geht in der Artikel.
Vergessen Sie nicht, diese Änderungen zu speichern.
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!
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.

Reverse-Geocoding-Entwicklerhandbuch

API-Anforderungsformat

Unsere Distancematrix.ai Reverse Geocoding API verwendet ein Anforderungsformat, das anderen Industriestandard-APIs ähnelt, und gewährleistet so einen intuitiven und reibungslosen Übergang für Benutzer, die mit Standard-Geokodierungswerkzeugen vertraut sind.

Hier ist ein Beispiel dafür, wie eine richtige API-Anfrage aussehen würde/könnte:
ERHALTEN:
https://api-v2.distancematrix.ai/maps/api/geocode/json?latlng=37.422387799999996,-122.08418770000002&key=<your_access_token>
Kopiert!
Bestandteile der Anfrage:
  • HTTPS-Verschlüsselung: https:// wird für sichere Kommunikation verwendet.
  • Domäne: api-v2.distancematrix.ai ist die Domain für die genaue API.
  • Pfad der Anfrage: /maps/api/geocode/json gibt die Art der Anfrage an.
  • Erforderlicher Parameter: ?latlng=37,422387799999996,-122,08418770000002 gibt den Breiten- und Längengrad für die umgekehrte Geokodierung an.
  • Optionaler Parameter: &language=uk kann für die Sprachpräferenz hinzugefügt werden.
  • Autorisierungstoken: &key=<your_access_token> ist für die Authentifizierung der Anfrage erforderlich.
Parameter werden standardmäßig in URLs mit dem Und-Zeichen (&) getrennt.

Dieses Setup ist auf die Reverse Geocoding API zugeschnitten, bei der im Vergleich zur Standard-Geokodierung andere Parameter verwendet werden. Auf dieser Seite erfahren Sie, wie Sie Längen- und Breitengrade von einer Adressen-API abrufen können. Dazu gehören auch die zu verwendenden Parameter und die Art der Geocoding-Antwort, die Sie erwarten können. Zusätzlich wird ein Beispiel für eine JSON-Antwort bereitgestellt, die auf dem Ausgabe-Flag basiert.
https://api-v2.distancematrix.ai/maps/api/geocode/json?latlng=29.976480,%2031.131302&key=access_token
Kopiert!

Erforderliche Parameter in einer Reverse-Geocoding-Anfrage:

latlang: Dieser erforderliche Parameter enthält die Längen- und Breitengradwerte zur Angabe des Standorts, für den Sie die Adresse abrufen möchten. Beispiel:
latlng=37.422387799999996,-122.08418770000002
Kopiert!
Schlüssel: Ein eindeutiger API-Schlüssel, der den Anforderer authentifiziert und die Kontingentberechnung ermöglicht. Dieser Schlüssel muss in jeder Anfrage enthalten sein. Hängen Sie Ihren API-Schlüssel im folgenden Format an die Anfrage an &key=<your_access_token>.
Folgen Sie dem Verknüpfung um mehr über den Schlüssel, seinen Zweck, seine Erreichbarkeit und die Beschränkungen der Reverse Geocoding API zu erfahren.

Antworten mit umgekehrter Geokodierung

Die angegebene Anfrage verwendet die Reverse-Geocoding-API, um die Breiten- und Längengradkoordinaten '40.714224, -73.961452' in Brooklyn in eine für Menschen lesbare Adresse zu konvertieren und spezifiziert, dass die Antwort im JSON-Format sein soll.

So ist die Anfrage strukturiert:
ERHALTEN:
https://api-v2.distancematrix.ai/maps/api/geocode/json?latlng=40.714224,-73.961452&key=<your_access_token>
Kopiert!
*Wichtiger Hinweis: Bei der Eingabe latong Parameter, stellen Sie sicher, dass zwischen den Breiten- und Längengraden kein Leerzeichen besteht.
Beispiel für eine JSON-Antwort:
BODY
{
    "result": [
        {
            "address_components": [
                {
                    "long_name": "United States",
                    "short_name": "US",
                    "types": [
                        "country",
                        "political"
                    ]
                },
                {
                    "long_name": "Brooklyn",
                    "short_name": "Brooklyn",
                    "types": [
                        "administrative_area_level_3",
                        "political"
                    ]
                },
                {
                    "long_name": "11211",
                    "short_name": "11211",
                    "types": [
                        "postal_code"
                    ]
                },
                {
                    "long_name": "Brooklyn",
                    "short_name": "Brooklyn",
                    "types": [
                        "locality",
                        "political"
                    ]
                },
                {
                    "long_name": "279",
                    "short_name": "279",
                    "types": [
                        "street_number"
                    ]
                },
                {
                    "long_name": "Bedford Avenue",
                    "short_name": "Bedford Avenue",
                    "types": [
                        "route"
                    ]
                },
                {
                    "long_name": "Michel Cluizel",
                    "short_name": "Michel Cluizel",
                    "types": [
                        "name"
                    ]
                },
                {
                    "long_name": "NY",
                    "short_name": "NY",
                    "types": [
                        "state",
                        "administrative_area_level_1",
                        "political"
                    ]
                }
            ],
            "formatted_address": "279 Bedford Avenue, Kings County, Brooklyn 11211, United States",
            "geometry": {
                "location": {
                    "lat": 40.7142138,
                    "lng": -73.9613419
                },
                "location_type": "APPROXIMATE",
                "viewport": {
                    "northeast": {
                        "lat": 40.7142138,
                        "lng": -73.9613419
                    },
                    "southwest": {
                        "lat": 40.7142138,
                        "lng": -73.9613419
                    }
                }
            },
            "place_id": "4961172027",
            "plus_code": {},
            "types": [
                "street_address"
            ]
        }
    ],
    "status": "OK"
}
Kopiert!
Das“formatierte_Adresse„Die Ergebnisse umfassen verschiedene Möglichkeiten, einen Standort geografisch zu benennen, z. B. Straßenadressen, Städtenamen, Bundesstaaten oder Länder, wobei jeder dieser Typen als gültige Ergebnisse zurückgegeben wird. Beispielsweise kann die Geokodierung eines Punkts in Chicago als Adresse, Stadt (Chicago), Bundesstaat (Illinois) oder Land (USA) dargestellt werden. Der Reverse-Geocoder gleicht politische Einheiten, Straßenadressen und Postleitzahlen ab.

* Wichtiger Hinweis: Bei der umgekehrten Geokodierung wird die nächste adressierbare Position innerhalb eines bestimmten Toleranzbereichs geschätzt und zurückgegeben Null Ergebnisse, wenn keine enge Übereinstimmung gefunden wird.

Bitte beachten Sie, dass die JSON-Antwort zwei Hauptelemente hat:
„Status“: Dieses Element stellt Metadaten zur Anfrage bereit. Beziehen Sie sich auf die Statuscodes weiter unten finden Sie weitere Informationen.
„Ergebnis“: Dazu gehört ein Array mit geokodierten Adressdetails und Geometrieinformationen.
Beachten Sie, dass Sie zum Extrahieren bestimmter Werte aus diesen Ergebnissen in der Regel das JSON analysieren müssen, was wiederum ein unkomplizierter Prozess ist.

Statuscodes

In der Geocoding-Antwort ist der“StatusDas Feld „zeigt den Status der Anfrage an und kann Debugging-Details enthalten. Mögliche Werte sind:
„OK“: Keine Fehler; die Adresse wurde verarbeitet und Geocode (s) zurückgegeben.
„NULL_ERGEBNISSE“: Die Geokodierung war erfolgreich, aber es wurden keine Ergebnisse gefunden, möglicherweise aufgrund einer nicht existierenden Adresse.
„ÜBER_TÄGLICHES_LIMIT“: Könnte bedeuten, dass ein API-Schlüssel fehlt/ungültig ist, keine Abrechnung aktiviert ist oder eine Nutzungsobergrenze überschritten wurde.
„ÜBER_ABFRAGELIMIT“: Weist auf eine Übernutzung des Kontingents hin.
„ANFRAGE_VERWEIGERT“: Ihre Anfrage wurde abgelehnt.
„UNGÜLTIGE_ANFRAGE“: Bedeutet in der Regel fehlende Abfragedetails (Adresse, Komponenten oder latong).
„UNBEKANNTER_FEHLER“: Ein Serverfehler verhinderte die Verarbeitung. Ein erneuter Versuch könnte erfolgreich sein.

Fehlermeldungen

Wenn der Statuscode des Geocoders etwas anderes ist als“OK„, und“error_messageDas Feld“ kann in der Antwort erscheinen. Dieses Feld enthält detaillierte Gründe für den spezifischen Statuscode.

*Wichtiger Hinweis: Das“error_messageDas Feld“ ist nicht immer enthalten und sein Inhalt kann variieren.

Ergebnisse

Wenn der Geocoder Ergebnisse generiert, werden sie in einem Ergebnis-Array im JSON-Format platziert. Wenn keine Ergebnisse gefunden werden, z. B. bei einer nicht vorhandenen Adresse, wird das Array leer zurückgegeben.

Zu den wichtigsten Feldern in einem typischen 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“.
Beachten Sie diese Punkte über die Adresskomponenten [] Array in den Geokodierungsergebnissen:
Das Array kann mehr Elemente enthalten als formatierte_Adresse.
Es umfasst nicht immer alle politischen Einheiten einer Adresse, nur die in der formatierte_Adresse. Verwenden Sie die umgekehrte Geokodierung mit Breitengrad/Längengrad, um eine umfassende Liste zu erhalten.
Das Antwortformat, einschließlich der Anzahl und Art der Adresskomponenten, kann bei jeder Anfrage und im Laufe der Zeit für dieselbe Adresse variieren. Komponenten können ihre Position ändern, ihren Typ ändern oder in nachfolgenden Antworten fehlen.
Um die Geokodierungsantwort effektiv nutzen zu können, müssen Sie das Array der Komponenten analysieren und nach Bedarf Werte auswählen.
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 Standortdetails:
  • Standort: Der geokodierte Breiten- und Längengrad. Dies ist häufig das wichtigste Feld für Standardadresssuchen.
  • standort_typ: Zusätzliche Informationen zum Standort. Zu den unterstützten Werten gehören:
    • DACHTERRASSE“: Ein präziser Geocode mit exakter Straßenadresse.
    • BEREICH_INTERPOLIERT„: Ein ungefähres Ergebnis, das häufig verwendet wird, wenn bestimmte Dachdaten nicht verfügbar sind.
    • GEOMETRISCHES_MITTELPUNKT„: Der Mittelpunkt einer Linie oder Fläche.
    • UNGEFÄHRE“: Ein geschätzter Standort.
partielles Spiel: Zeigt eine nicht exakte Übereinstimmung an, bei der nur ein Teil der angeforderten Adresse gefunden werden konnte. Dies ist häufig bei Straßenadressen der Fall, die innerhalb des angeforderten Orts nicht existieren, oder wenn eine Adresse mehreren Orten entspricht. Beispielsweise könnte eine Anfrage mit einer leicht falsch geschriebenen Adresse eine nahegelegene, korrekt geschriebene Adresse als teilweise Übereinstimmung zurückgeben.

Adresstypen und Adresskomponententypen

Das Typen [] Array in den Geokodierungsergebnissen gibt den Adresstyp an, der Folgendes beinhalten kann:
straße_adresse: Eine bestimmte Straßenadresse.
Route: Eine benannte Route wie „US 101“.
Schnittpunkt: Eine wichtige Kreuzung zweier Straßen.
politisch: Eine politische Einheit, oft ein Bereich der Zivilverwaltung.
Land: Die nationale politische Einheit, in der Regel die oberste Ebene.
Verwaltungsbereich_Ebene_2: Eine sekundäre zivile Einheit, z. B. Bezirke in den USA.
Verwaltungsbereich_Ebene_3 zu Verwaltungsbereich_Ebene_5: Zivilabteilungen niedrigerer Ordnung.
Andere unterstützte Typen sind:
Umgangssprachlicher Bereich: Ein alternativer Name für einen Ort.
Lokalität: Eine eingemeindete Stadt oder Gemeinde.
Sublokalität (und Stufen 1-5): Eine zivile Einheit innerhalb eines Ortes.
Nachbarschaft: Eine bestimmte Nachbarschaft.
Prämisse: Ein benanntes Gebäude oder Komplex.
Unterprämisse: Eine Einheit in einem größeren Gebäude.
postleitzahl: Die Postleitzahl.
natürliches_Merkmal: Bemerkenswerte Naturdenkmäler.
Flughafen: Ein Flughafen.
Park: Ein benannter Park.
Sehenswürdigkeit: Signifikante lokale Einheiten wie Wahrzeichen.
Eine leere Typenliste bedeutet, dass keine Typen für diese Adresskomponente bekannt sind. Zu den weiteren Typen gehören:
Fußboden: Gebäudegeschoss.
Einrichtung: Nicht klassifizierte Orte.
Parkplatz: Parkplätze.
postfach: Spezifische Postfächer.
postal_town: Geografische Gebiete, die für Postanschriften verwendet werden.
Platz: Bestimmte Räume in einem Gebäude.
straße_nummer: Genaue Hausnummer.
Busstation, Bahnstation, Transitstation: Haltestellen des Transports.

FAQ

Was können Sie mit der Reverse Geocoding API machen?

Unternehmen, die sich mit Geokodierung befassen, verwenden häufig APIs für direkte Geokodierung und umgekehrte Geokodierung in Software und Apps, um Geschäfte, Fahrzeuge und Kunden zu lokalisieren und so das Transportmanagement und die Bewegungsverfolgung zu unterstützen.

Die umgekehrte Geokodierung ist mehr als nur die Identifizierung/Platzierung von Adressen. Sie ist ein vielseitiges Tool für die Standortkartierung, Routenplanung und Datenanalyse. Diese Technologie kann für Logistikunternehmen von Vorteil sein, die genaue Standortangaben benötigen. Weitere Beispiele aus der Praxis für die Reverse-Geocoding-API in Aktion finden Sie auf unserer Webseite.

Warum sollte ich die Reverse Geocoding API verwenden?

Die Reverse-Geocoding-API von DistanceMatrix.ai bietet genaue Standortdaten von 99% der Welt in einer Vielzahl von Formaten. Damit Sie von überall aus in Sekundenschnelle die richtige Adresse abrufen können. Aus diesem Grund ist unser Tool in zahlreichen Branchen sehr gefragt. Außerdem konkurriert es aufgrund seiner hohen Genauigkeit mit führenden Anbietern auf diesem Gebiet. Eine weitere Sache, die Sie beachten sollten, ist, dass der Umstellungsprozess von beliebigen Nebendiensten zu unserer API nahtlos und problemlos verläuft.

Es ist keine Vorauszahlung erforderlich.
Starten Sie kostenlos und erhalten Sie sofortigen Zugriff auf alle Produkte und Funktionen von DistanceMatrix.AI