Cara membuat geokode area administratif dan pos

Geocode API memungkinkan Anda melakukan geocoding untuk area geografis menggunakan input teks kueri, seperti nama negara, wilayah (negara bagian atau provinsi), atau kota. Respons API mencakup detail lokasi seperti koordinat geografis, kotak pembatas untuk visualisasi peta, dan skor kecocokan yang menunjukkan relevansi hasil dengan kueri.

Kasus penggunaan potensial

• Dapatkan koordinat untuk area administratif: Gunakan koordinat sebagai posisi bias atau pusat di Tempat lain. APIs

• Visualisasikan informasi di peta: Koordinat geokode dapat digunakan untuk menampilkan data secara visual di peta.

Contoh

Geocode sebuah Negara

Sample request

{
  "QueryText": "Canada"
}

Sample response

{
    "ResultItems": [
        {
            "PlaceId":"<Redacted>",
            "PlaceType": "Country",
            "Title": "Canada",
            "Address": {
                "Label": "Canada",
                "Country": {
                    "Code2": "CA",
                    "Code3": "CAN",
                    "Name": "Canada"
                }
            },
            "Position": [-75.69122, 45.42177],
            "MapView": [-141.00271, 41.67659, -52.61901, 83.11062],
            "MatchScores": {
                "Overall": 1,
                "Components": {
                    "Address": { "Country": 1 }
                }
            }
        }
    ]
}

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": "Canada"
}'

AWS CLI

aws geo-places geocode --key ${YourAPIKey} --query-text "Canada"

Geocode sebuah Wilayah

Sample request

{
  "QueryText": "BC"
}

Sample response

{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "Region",
            "Title": "BC, Canada",
            "Address": {
                "Label": "BC, Canada",
                "Country": {
                    "Code2": "CA",
                    "Code3": "CAN",
                    "Name": "Canada"
                },
                "Region": {
                    "Code": "BC",
                    "Name": "British Columbia"
                }
            },
            "Position": [-123.36445, 48.42854],
            "MapView": [-139.04941, 48.22478, -114.05201, 60.00043],
            "MatchScores": {
                "Overall": 1,
                "Components": {
                    "Address": { "Region": 1 }
                }
            }
        }
    ]
}

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": "BC"
}'

AWS CLI

aws geo-places geocode --key ${YourAPIKey} --query-text "BC"

Geocode Kota

Sample request

{
  "QueryText": "Vancouver"
}

Sample response

{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "Locality",
            "Title": "Vancouver, BC, Canada",
            "Address": {
                "Label": "Vancouver, BC, Canada",
                "Country": {
                    "Code2": "CA",
                    "Code3": "CAN",
                    "Name": "Canada"
                },
                "Region": {
                    "Code": "BC",
                    "Name": "British Columbia"
                },
                "SubRegion": {
                    "Name": "Metro Vancouver"
                },
                "Locality": "Vancouver",
                "PostalCode": "V5Y"
            },
            "Position": [-123.11336, 49.26038],
            "MapView": [-123.26754, 49.19891, -123.02301, 49.33557],
            "MatchScores": {
                "Overall": 1,
                "Components": {
                    "Address": { "Locality": 1 }
                }
            }
        }
    ]
}

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": "Vancouver"
}'

AWS CLI

aws geo-places geocode --key ${YourAPIKey} --query-text "Vancouver"

Geocode dan Kode Pos

Anda dapat membuat geocode kode pos. Gunakan IncludePlaceTypes dengan ["PostalCode"] untuk hasil yang lebih tepat.

Sample request

{
  "QueryText": "800006",
  "Filter": { "IncludePlaceTypes": ["PostalCode"] }
}

Sample response

{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PostalCodeArea",
            "Title": "800006, Patna, Bihar, India",
            "Address": {
                "Label": "800006, Patna, Bihar, India",
                "Country": {
                    "Code2": "IN",
                    "Code3": "IND",
                    "Name": "India"
                },
                "Region": {
                    "Code": "BR",
                    "Name": "Bihar"
                },
                "SubRegion": { "Name": "Patna" },
                "Locality": "Patna",
                "PostalCode": "800006"
            },
            "Position": [85.18048, 25.61532],
            "MapView": [85.16599, 25.60054, 85.19103, 25.6221],
            "MatchScores": {
                "Overall": 1,
                "Components": {
                    "Address": { "PostalCode": 1 }
                }
            }
        }
    ]
}

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": "800006",
  "Filter": { "IncludePlaceTypes": ["PostalCode"] }
}'

AWS CLI

aws geo-places geocode --key ${YourAPIKey} --query-text "800006" --filter '{"IncludePlaceTypes": ["PostalCode"]}'

Kiat pengembang

Gunakan filter seperti IncludeCountries dan IncludePlaceTypes untuk hasil yang lebih bertarget. Misalnya, untuk memastikan hasil dari Vancouver di AS, tetapkan. "IncludeCountries": ["USA"] Untuk detail selengkapnya, lihat .

{
  "QueryText": "Vancouver",
  "Filter": { "IncludeCountries": ["USA"] }
}