So vervollständigen Sie eine Adresse

Die Autocomplete-API ermöglicht es Ihnen, teilweise eingegebene Adressen zu vervollständigen, sodass Endbenutzer standardisierte Eingaben erhalten und die Effizienz bei der Dateneingabe verbessert wird.

Mögliche Anwendungsfälle

• Vervollständigen Sie eine Adresse beim Checkout: Erleichtern Sie Kunden die genaue und schnelle Adresseingabe, wenn sie in ein Checkout-Formular eingeben.

• Länderspezifische Adressvervollständigung: Beschränken Sie Vorschläge auf ein bestimmtes Land, um die Einhaltung der Vorschriften zu gewährleisten oder sie für den Standort des Benutzers relevant zu machen.

Beispiele

Vollständige Adresse mit minimalen Daten

In diesem Beispiel werden nur wenige Daten zurückgegeben, um die Antwort präzise und kostengünstig zu halten. Vollständige Ortsdetails können später PlaceId mithilfe der GetPlace API abgerufen werden.

Sample request

{
  "QueryText": "100 McCullum Rd"
}

Sample response

{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointAddress",
            "Title": "United Kingdom, E3 5JB, London, 100 McCullum Road"
        }
    ],
    "QueryRefinements": []
}

cURL

curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/autocomplete?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
  "QueryText": "100 McCullum Rd"
}'

AWS CLI

aws geo-places autocomplete --key ${YourKey} --query-text "100 McCullum Rd"

Vollständige Adresse mit Adresskomponente

In diesem Beispiel werden mehrere Adressvorschläge zurückgegeben, sodass Benutzer ein standardisiertes Adressformat für das genaue Ausfüllen von Formularfeldern auswählen können.

Sample request

{
  "QueryText": "100 McCullum Rd",
  "AdditionalFeatures": [
    "Core"
  ]
}

Sample response

{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointAddress",
            "Title": "United Kingdom, E3 5JB, London, 100 McCullum Road",
            "Address": {
                "Label": "100 McCullum Road, London, E3 5JB, United Kingdom",
                "Country": {
                    "Code2": "GB",
                    "Code3": "GBR",
                    "Name": "United Kingdom"
                },
                "Region": {
                    "Name": "England"
                },
                "SubRegion": {
                    "Code": "LDN",
                    "Name": "London"
                },
                "Locality": "London",
                "District": "Bow",
                "PostalCode": "E3 5JB",
                "Street": "McCullum Road",
                "StreetComponents": [
                    {
                        "BaseName": "McCullum",
                        "Type": "Road",
                        "TypePlacement": "AfterBaseName",
                        "TypeSeparator": " ",
                        "Language": "en"
                    }
                ],
                "AddressNumber": "100"
            },
            "Language": "en",
            "Highlights": {
                "Title": [
                    {
                        "StartIndex": 32,
                        "EndIndex": 35,
                        "Value": "100"
                    },
                    {
                        "StartIndex": 36,
                        "EndIndex": 49,
                        "Value": "McCullum Road"
                    }
                ],
                "Address": {
                    "Label": [
                        {
                            "StartIndex": 0,
                            "EndIndex": 3,
                            "Value": "100"
                        },
                        {
                            "StartIndex": 4,
                            "EndIndex": 17,
                            "Value": "McCullum Road"
                        }
                    ],
                    "Street": [
                        {
                            "StartIndex": 0,
                            "EndIndex": 13,
                            "Value": "McCullum Road"
                        }
                    ],
                    "AddressNumber": [
                        {
                            "StartIndex": 0,
                            "EndIndex": 3,
                            "Value": "100"
                        }
                    ]
                }
            }
        },
        ...
    ],
    "QueryRefinements": []
}

cURL

curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/autocomplete?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
  "QueryText": "100 McCullum Rd",
  "AdditionalFeatures": [
    "Core"
  ]
}'

AWS CLI

aws geo-places autocomplete --key ${YourKey} --query-text "100 McCullum Rd" --additional-features "Core"