Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Cara mengontrol varian nama alamat
AddressNamesModemenentukan bagaimana nama alamat dikembalikan. Jika tidak disetel, layanan mengembalikan nama (resmi) yang dinormalisasi secara default. Saat disetel keMatched, nama alamat dalam respons didasarkan pada kueri masukan daripada nama resmi. Ketika diatur keAdministrative, layanan mengembalikan nama administratif resmi untuk komponen alamat. Administrativesaat ini hanya berlaku untuk alamat di Amerika Serikat.
Kasus penggunaan potensial
-
Penyelesaian formulir alamat: Gunakan Matched untuk mengembalikan nama yang konsisten dengan apa yang diketik pengguna, mengurangi kebingungan dalam alur kerja pelengkapan otomatis.
-
Standardisasi alamat: Gunakan Administrative untuk menormalkan nama kota ke formulir administrasi resmi mereka untuk kualitas data dan deduplikasi.
Contoh
- 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
Kiat pengembang
-
Jika tidak disetel, layanan mengembalikan nama (resmi) yang dinormalisasi secara default.
-
Administrativesaat ini hanya berlaku untuk alamat di Amerika Serikat.
