Geokodieren - Amazon Location Service
AnwendungsfälleVerstehe die AnfrageVerstehe die Antwort

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Geokodieren

Geokodierung wandelt Textadressen oder Ortsnamen zusammen mit detaillierten Adresskomponenten und zusätzlichen Informationen in geografische Koordinaten um. Diese API unterstützt flexible Abfragen, darunter sowohl Freitextabfragen als auch strukturierte Abfragen mit Straßennamen, Postleitzahlen und Regionen. Zu den optionalen Funktionen gehören Zeitzonendaten und Anpassungen politischer Ansichten.

Anmerkung

Für gespeicherte Ergebnisse fallen höhere Speicherpreise an. Verwenden Sie den IntendedUse Parameter, um den einmaligen Gebrauch oder die Speicherung anzugeben. Weitere Informationen Preise für Orte zu den Auswirkungen der gespeicherten Ergebnisse auf die Kosten finden Sie unter.

Weitere Informationen finden Sie unter Geocode in der Amazon Location Service API-Referenz.

Beispiele für Anfragen, Antworten, cURL- und CLI-Befehle für diese API finden Sie unter So verwenden Sie Geocode.

Anwendungsfälle

  • Fügen Sie zusätzliche Daten zu Kundenadressen hinzu: Verbessern Sie die Adressdatensätze, indem Sie Postleitzahlen und Koordinaten angeben und persistenten Speicher verwenden, um fundierte Geschäfts- und Marketingentscheidungen zu unterstützen.

  • Standardisierung von Adressdaten: Wenden Sie Geokodierung in Daten-Pipelines oder Batch-Prozessen an, um Adressdaten zu standardisieren, und nutzen Sie persistenten Speicher für fortlaufende Referenzzwecke.

  • Ermitteln Sie Zeitzonen: Identifizieren Sie die Zeitzone für Städte oder Adressen, um genaue Zeitstempel für Anwendungen wie Reisen, Terminplanung und Rechnungsstellung bereitzustellen.

Verstehe die Anfrage

Die Anfrage akzeptiert optionale Parameter wieAdditionalFeatures, und BiasPositionFilter, um die Suchergebnisse zu verfeinern. Zusätzliche Optionen, wie LanguageMaxResults, undPoliticalView, ermöglichen eine weitere Anpassung der Antwort. Der erforderliche Parameter istQuery, der als Freiformtext oder strukturiert als QueryComponents bereitgestellt werden kann. Weitere Informationen finden Sie in der Geocode API-Referenz.

Die Anfrage umfasst die folgenden Schlüsselparameter:

Authentifizierung

Für die Authentifizierung ist der Key Parameter optional, wenn andere Methoden verwendet werden.

  • Key: Optionaler Parameter für die Authentifizierung.

Weitere Informationen finden Sie unter Authentifizieren Sie sich mit Amazon Location Service.

Abfragen und Voreingenommenheit

Parameter, die für die Abfrage und geografische Verzerrung von Ergebnissen verwendet werden.

  • QueryText: Freiform-Textabfrage für die Suche nach Orten.

  • QueryComponents: Strukturierte Komponenten wie Adressnummer, Land, Ort oder Postleitzahl für eine präzise Suche.

  • BiasPosition: Geografische Position, auf die die Suchergebnisse ausgerichtet werden sollen.

Weitere Informationen finden Sie unter Abfragen und Voreingenommenheit.

Verfeinerung der Ergebnisse

Wenden Sie Filter an, um die Ergebnisse zu verfeinern.

  • Filter: Filtern Sie, um bestimmte Länder oder Ortstypen einzubeziehen. Weitere Informationen finden Sie unter Filtern.

Internationalisierung und Lokalisierung

Geben Sie die Sprache an und wenden Sie die politische Sichtweise an, um lokalisierte Ergebnisse zu erzielen.

  • Language: Sprache für die Ergebnisse.

  • PoliticalView: Wendet eine politische Sichtweise an, die territoriale Ansprüche widerspiegelt.

Weitere Informationen finden Sie unter Lokalisierung und Internationalisierung.

Weitere Funktionen

Fordern Sie zusätzliche Informationen wie Zeitzonendetails an.

  • AdditionalFeatures: Option, um zusätzliche Details wie die Zeitzone anzufordern. Weitere Informationen finden Sie unter Weitere Features.

Verstehe die Antwort

Die Antwort enthält ResultItems detaillierte Standortdaten wieAddress, PlaceIdPosition, und andere relevante Attribute. Zusätzliche Funktionen wie TimeZone Informationen oder MatchScores für jede Abfragekomponente können ebenfalls enthalten sein. Jede ResultItem stellt einen übereinstimmenden Standort oder ein Geokodierungsergebnis dar, das auf den angegebenen Anforderungsparametern basiert. Weitere Informationen finden Sie in der Geocode-API-Referenz.

Die Antwort umfasst die folgenden Schlüsselparameter:

Adresse und zugehörige Angaben

Details zum zurückgegebenen Standort, einschließlich Adressbestandteilen.

  • Address: Vollständige Adresse einschließlich Land, Region, Postleitzahl und Straßendetails.

  • PostalCodeDetails: Zusätzliche Informationen zu Postleitzahlen.

  • StreetComponents: Straßendetails, einschließlich Name und Typ der Basisstation.

Arten und Kategorien von Orten

Informationen zu Art und Kategorie des zurückgegebenen Ortes.

  • Categories: Liste der Kategorien, die den Ort beschreiben, zum Beispiel Restaurants, Schulen.

  • PlaceType: Gibt die Art des Ortes an, z. B. Stadt, Adresse oder Region.

Analyse der Ergebnisse

Punktzahlen, die angeben, wie genau die Ergebnisse mit der Eingabeabfrage übereinstimmen.

  • MatchScores: Punktzahlen für übereinstimmende Genauigkeit.

    • Overall: Misst auf einer Skala von 0,0 bis 1,0 (0% bis 100%), wie gut eine Adresssuche mit Ihrer Eingabe übereinstimmt. Eine perfekte Punktzahl von 1,0 bedeutet, dass jeder Teil Ihrer Suche in der Datenbank gefunden wurde. Es ist normal, dass niedrigere Punktzahlen angezeigt werden, wenn zusätzliche Details wie Kontaktnamen oder Lieferanweisungen hinzugefügt werden. Diese reduzieren natürlich die Punktzahl, bedeuten aber nicht unbedingt, dass die Adresse falsch ist.

    • Component Score: Jede Adresskomponente (wie AddressNumber oderPostalCode) wird einzeln auf einer Skala von 0,0 bis 1,0 (0% bis 100%) bewertet. Diese Werte geben an, wie genau jeder Teil der Adresse mit dem Ergebnis übereinstimmt. Wenn z. B. ein PostalCode Ergebnis nahe 1,0 liegt AddressNumberStreet, können Sie der Übereinstimmung auch dann vertrauen, wenn die Gesamtpunktzahl aufgrund anderer Abfragedetails niedriger ist.

    Anmerkung

    Wenn für eine bestimmte Komponente (z. B.Street) kein Ergebnis angezeigt wird, wird diese Komponente als 0 gezählt. Auf diese Weise können Teile der Adresse identifiziert werden, die möglicherweise überprüft werden müssen.

    Dieses Bewertungssystem hilft dabei, ein Gleichgewicht zwischen exakten Treffern und praktischer Benutzerfreundlichkeit bei der Suche nach realen Adressen zu finden, die häufig zusätzliche Informationen enthalten.

Zusätzliche Einzelheiten

Beinhaltet bei Bedarf zusätzliche standortbezogene Informationen.

  • AccessPoints: Geografische Koordinaten, die Zugangspunkte repräsentieren.

  • TimeZone: Zeitzoneninformationen für den Standort.