本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 如何对地址进行地理编码
地理编码 API 允许您对特定的点地址、插值地址或街道进行地理编码。该 API 响应包含位置信息，包括地理坐标以及指示结果与查询匹配准确程度的匹配得分。
## 潜在使用案例
+ **清理地址数据库：**通过识别和更正地址记录中的错误来提高数据质量。
+ **规范化和标准化地址：**确保各数据集的地址格式保持一致，以提高数据互操作性。
+ **使用其他信息丰富地址：**将地理坐标和其他相关详细信息添加到地址记录中，以支持基于位置的分析和见解。
## 示例
### 使用查询文本
------
#### [ Sample request ]
```
{
"QueryText": "510 W Georgia St, Vancouver, BC"
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointAddress",
"Title": "510 W Georgia St, Vancouver, BC V6B 0M3, Canada",
"Address": {
"Label": "510 W Georgia St, Vancouver, BC V6B 0M3, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Vancouver",
"District": "Downtown Vancouver",
"PostalCode": "V6B 0M3",
"Street": "W Georgia St",
"StreetComponents": [
{
"BaseName": "Georgia",
"Type": "St",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Prefix": "W",
"Language": "en"
}
],
"AddressNumber": "510"
},
"Position": [
-123.11694,
49.28126
],
"MapView": [
-123.11832,
49.28036,
-123.11556,
49.28216
],
"AccessPoints": [
{
"Position": [
-123.11656,
49.28151
]
}
],
"MatchScores": {
"Overall": 1,
"Components": {
"Address": {
"Region": 1,
"Locality": 1,
"Intersection": [
1
],
"AddressNumber": 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": "510 W Georgia St, Vancouver, BC"}'
```
------
#### [ AWS CLI ]
```
aws geo-places geocode --key ${YourAPIKey} --query-text "510 W Georgia St, Vancouver, BC"
```
------
### 使用查询组件
------
#### [ Sample request ]
```
{
"QueryComponents": {
"AddressNumber": "510",
"Locality": "Vancouver",
"Region": "BC",
"Country": "Canada",
"Street": "Georgia"
}
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointAddress",
"Title": "510 W Georgia St, Vancouver, BC V6B 0M3, Canada",
"Address": {
"Label": "510 W Georgia St, Vancouver, BC V6B 0M3, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Vancouver",
"District": "Downtown Vancouver",
"PostalCode": "V6B 0M3",
"Street": "W Georgia St",
"StreetComponents": [
{
"BaseName": "Georgia",
"Type": "St",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Prefix": "W",
"Language": "en"
}
],
"AddressNumber": "510"
},
"Position": [
-123.11694,
49.28126
],
"MapView": [
-123.11832,
49.28036,
-123.11556,
49.28216
],
"AccessPoints": [
{
"Position": [
-123.11656,
49.28151
]
}
],
"MatchScores": {
"Overall": 0.99,
"Components": {
"Address": {
"Country": 1,
"Region": 1,
"Locality": 1,
"Intersection": [
0.78
],
"AddressNumber": 1
}
}
}
},
{
"PlaceId": "",
"PlaceType": "InterpolatedAddress",
"Title": "510 E Georgia St, Vancouver, BC V6A 1Z9, Canada",
"Address": {
"Label": "510 E Georgia St, Vancouver, BC V6A 1Z9, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Vancouver",
"District": "Strathcona",
"PostalCode": "V6A 1Z9",
"Street": "E Georgia St",
"StreetComponents": [
{
"BaseName": "Georgia",
"Type": "St",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Prefix": "E",
"Language": "en"
}
],
"AddressNumber": "510"
},
"Position": [
-123.0932,
49.27829
],
"MapView": [
-123.09458,
49.27739,
-123.09182,
49.27919
],
"AccessPoints": [
{
"Position": [
-123.0932,
49.27842
]
}
],
"MatchScores": {
"Overall": 0.99,
"Components": {
"Address": {
"Country": 1,
"Region": 1,
"Locality": 1,
"Intersection": [
0.78
],
"AddressNumber": 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 '{"QueryComponents": {"AddressNumber": "510", "Locality": "Vancouver", "Region": "BC", "Country": "Canada", "Street": "Georgia"}}'
```
------
#### [ AWS CLI ]
```
./aws geo-places geocode --key ${YourAPIKey} --query-components '{
"AddressNumber" : "510",
"Locality": "vancouver",
"Region": "BC",
"Country": "Canada",
"Street": "Georgia"}'
```
------
### 使用混合查询
------
#### [ Sample request ]
```
{
"QueryText": "W. 6th St",
"QueryComponents": {
"AddressNumber": "415",
"Locality": "Vancouver"
}
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointAddress",
"Title": "415 W 6th St, Vancouver, WA 98660-3375, United States",
"Address": {
"Label": "415 W 6th St, Vancouver, WA 98660-3375, United States",
"Country": {
"Code2": "US",
"Code3": "USA",
"Name": "United States"
},
"Region": {
"Code": "WA",
"Name": "Washington"
},
"SubRegion": {
"Name": "Clark"
},
"Locality": "Vancouver",
"District": "Esther Short",
"PostalCode": "98660-3375",
"Street": "W 6th St",
"StreetComponents": [
{
"BaseName": "6th",
"Type": "St",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Prefix": "W",
"Language": "en"
}
],
"AddressNumber": "415"
},
"Position": [
-122.67543,
45.62527
],
"MapView": [
-122.67672,
45.62437,
-122.67414,
45.62617
],
"AccessPoints": [
{
"Position": [
-122.67543,
45.62506
]
}
],
"MatchScores": {
"Overall": 1,
"Components": {
"Address": {
"Locality": 1,
"Intersection": [
1
],
"AddressNumber": 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": "W. 6th St", "QueryComponents": {"AddressNumber": "415", "Locality": "Vancouver"}}'
```
------
#### [ AWS CLI ]
```
./aws geo-places geocode -key ${YourAPIKey} --query-text "W. 6th St" \
--query-components '{"AddressNumber" : "415", "Locality": "Vancouver"}'
```
------
## 开发人员提示
使用 `IncludeCountries` 和 `IncludePlaceTypes` 之类的筛选条件获得准确的结果。例如，如果需要搜索美国温哥华，请应用 `"IncludeCountries": ["USA"]` 以优先考虑美国的结果。要了解更多信息，请参阅[如何使用筛选条件进行地理编码](how-to-geocode-filters.md)。
```
{
"QueryText": "Vancouver",
"Filter": {
"IncludeCountries": ["USA"],
"IncludePlaceTypes": ["City"]
}
}
```