本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 如何对行政和邮政区域进行地理编码
<a name="how-to-geocode-admin-postal-area"></a>

地理编码 API 允许您使用查询文本输入对地理区域进行地理编码，例如国家/地区、区域（州或省）或城市的名称。该 API 响应包含位置详细信息，例如地理坐标、地图可视化的边界框以及表示结果与查询相关性的匹配得分。

## 潜在使用案例
<a name="goecode-admin-potential-use"></a>
+ **获取行政区域的坐标：**在其他地方使用坐标作为偏差位置或中心 APIs。
+ **在地图上直观显示信息：**地理编码坐标可用于在地图上直观地显示数据。

## 示例
<a name="geocode-admin-examples"></a>

### 对国家/地区进行地理编码
<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"
```

------

### 对区域进行地理编码
<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"
```

------

### 对城市进行地理编码
<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"
```

------

### 对邮政编码进行地理编码
<a name="geocode-postal-code"></a>

您可以对邮政编码进行地理编码。将 `IncludePlaceTypes` 与 `["PostalCode"]` 结合使用可获得更精确的结果。

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

------

## 开发人员提示
<a name="goecode-admin-developer-tips"></a>

使用 `IncludeCountries` 和 `IncludePlaceTypes` 之类的筛选条件可获得更有针对性的结果。例如，为确保结果来自美国的温哥华，请设置 `"IncludeCountries": ["USA"]`。有关更多详细信息，请参阅。

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