Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Cara membuat geokode area administratif dan pos
<a name="how-to-geocode-admin-postal-area"></a>

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
<a name="goecode-admin-potential-use"></a>
+ **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
<a name="geocode-admin-examples"></a>

### Geocode sebuah Negara
<a name="geocode-country"></a>

------
#### [ 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
<a name="geocode-region"></a>

------
#### [ 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
<a name="geocode-city"></a>

------
#### [ 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
<a name="geocode-postal-code"></a>

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
<a name="goecode-admin-developer-tips"></a>

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"] }
}
```