View a markdown version of this page

So kontrollieren Sie Varianten von Adressnamen - Amazon Location Service
Mögliche AnwendungsfälleBeispieleTipps für Entwickler

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.

So kontrollieren Sie Varianten von Adressnamen

AddressNamesModegibt an, wie Adressnamen zurückgegeben werden. Wenn nicht gesetzt, gibt der Dienst standardmäßig normalisierte (offizielle) Namen zurück. Wenn auf gesetztMatched, basieren die Adressnamen in der Antwort auf der Eingabeabfrage und nicht auf offiziellen Namen. Wenn diese Option auf gesetzt istAdministrative, gibt der Dienst die offiziellen Administratornamen für Adresskomponenten zurück. Administrativegilt derzeit nur für Adressen in den Vereinigte Staaten.

Mögliche Anwendungsfälle

  • Ausfüllen von Adressformularen: Wird verwendetMatched, um Namen zurückzugeben, die dem entsprechen, was der Benutzer eingegeben hat, wodurch Verwirrung in Workflows zur automatischen Vervollständigung vermieden wird.

  • Standardisierung von Adressen: Wird verwendetAdministrative, um Städtenamen im Hinblick auf Datenqualität und Deduplizierung auf ihre offizielle Verwaltungsform zu normalisieren.

Beispiele

Sample request
{
    "QueryText": "100 Universal City Plaza, Hollywood, CA",
    "AddressNamesMode": "Matched"
}
Sample response
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointAddress",
            "Title": "100 Universal City Plz, Universal City, CA 91608, United States",
            "Address": {
                "Label": "100 Universal City Plz, Universal City, CA 91608, United States",
                "Country": {
                    "Code2": "US",
                    "Code3": "USA",
                    "Name": "United States"
                },
                "Region": {
                    "Code": "CA",
                    "Name": "California"
                },
                "Locality": "Universal City",
                "PostalCode": "91608",
                "Street": "Universal City Plz",
                "AddressNumber": "100"
            },
            "Position": [
                -118.36054,
                34.13857
            ]
        }
    ]
}
cURL
curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/geocode?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
    "QueryText": "100 Universal City Plaza, Hollywood, CA",
    "AddressNamesMode": "Matched"
}'
AWS CLI
aws geo-places geocode --key ${YourKey} --query-text "100 Universal City Plaza, Hollywood, CA" --address-names-mode Matched
Sample request
{
    "QueryText": "100 Universal City Plaza, Hollywood, CA",
    "AddressNamesMode": "Administrative"
}
Sample response
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointAddress",
            "Title": "100 Universal Terrace Pkwy, Los Angeles, CA 91608, United States",
            "Address": {
                "Label": "100 Universal Terrace Pkwy, Los Angeles, CA 91608, United States",
                "Country": {
                    "Code2": "US",
                    "Code3": "USA",
                    "Name": "United States"
                },
                "Region": {
                    "Code": "CA",
                    "Name": "California"
                },
                "Locality": "Los Angeles",
                "PostalCode": "91608",
                "Street": "Universal Terrace Pkwy",
                "AddressNumber": "100"
            },
            "Position": [
                -118.36054,
                34.13857
            ]
        }
    ]
}
cURL
curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/geocode?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
    "QueryText": "100 Universal City Plaza, Hollywood, CA",
    "AddressNamesMode": "Administrative"
}'
AWS CLI
aws geo-places geocode --key ${YourKey} --query-text "100 Universal City Plaza, Hollywood, CA" --address-names-mode Administrative

Tipps für Entwickler

  • Wenn nicht gesetzt, gibt der Dienst standardmäßig normalisierte (offizielle) Namen zurück.

  • Administrativegilt derzeit nur für Adressen in den Vereinigte Staaten.