Cara geocode menggunakan filter

Geocode API memungkinkan Anda menggunakan filter untuk mendapatkan hasil yang diinginkan.

Potensi penggunaan

Gunakan filter untuk membatasi hasil berdasarkan kebutuhan bisnis Anda.

Contoh

Batasi hasil dalam suatu negara

Tentukan nilai IncludeCountries untuk mengembalikan nilai untuk negara tersebut dalam hasil.

Sample request

TanpaIncludeCountries": ["USA"], API Geocode akan mengembalikan Vancouver, BC, Kanada.

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

Sample response

{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "Locality",
            "Title": "Vancouver, WA, United States",
            "Address": {
                "Label": "Vancouver, WA, United States",
                "Country": {
                    "Code2": "US",
                    "Code3": "USA",
                    "Name": "United States"
                },
                "Region": {
                    "Code": "WA",
                    "Name": "Washington"
                },
                "SubRegion": {
                    "Name": "Clark"
                },
                "Locality": "Vancouver",
                "PostalCode": "98660"
            },
            "Position": [
                -122.67156,
                45.63248
            ],
            "MapView": [
                -122.77466,
                45.57714,
                -122.46451,
                45.69803
            ],
            "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",
    "Filter" : {
        "IncludeCountries": ["USA"]
    }
}'

AWS CLI

aws geo-places geocode --key ${YourKey} --query-text "Vancouver" --filter '{"IncludeCountries": ["USA"]}'

Sempurnakan hasil dengan filter tipe tempat

Tentukan nilai IncludePlaceTypes untuk mengembalikan nilai untuk tempat itu di hasil.

Sample request

TanpaIncludePlaceTypes": ["Street"], API Geocode akan mengembalikan Georgia, sebuah negara. Anda dapat lebih menyempurnakan hasil "IncludeCountries" dengan menambahkan dengan nilai CAN dan USA dan membandingkan hasilnya.

{
  "QueryText": "Georgia", 
    "Filter" : {
        "IncludePlaceTypes": ["Street"]
    }
    
}

Sample response

{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "Street",
            "Title": "Georgia, Benito Juárez, CDMX, México",
            "Address": {
                "Label": "Georgia, Benito Juárez, CDMX, México",
                "Country": {
                    "Code2": "MX",
                    "Code3": "MEX",
                    "Name": "México"
                },
                "Region": {
                    "Code": "CDMX",
                    "Name": "Ciudad de México"
                },
                "SubRegion": {
                    "Name": "Ciudad de México"
                },
                "Locality": "Benito Juárez",
                "Street": "Georgia",
                "StreetComponents": [
                    {
                        "BaseName": "Georgia",
                        "Language": "es"
                    }
                ]
            },
            "Position": [
                -99.17754,
                19.38887
            ],
            "MapView": [
                -99.18133,
                19.38755,
                -99.17374,
                19.39016
            ],
            "MatchScores": {
                "Overall": 1,
                "Components": {
                    "Address": {
                        "Intersection": [
                            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": "Georgia", 
    "Filter" : {
        "IncludePlaceTypes": ["Street"]
    }
    
}'

AWS CLI

aws geo-places geocode --key ${YourKey} --query-text "Georgia" --filter '{"IncludePlaceTypes": ["Street"]}'

Kiat pengembang

Untuk geocoding alamat, coba gunakan alamat lengkap atau komponen kueri dengan kombinasi posisi bias, termasuk negara dan tempat. Untuk mempelajari informasi lebih lanjut, lihat Cara membuat geokode alamat.