本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 如何對地址進行地理編碼
Geocode 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`來取得準確的結果。例如，如果您需要來自美國的 Vancouver，請申請 `"IncludeCountries": ["USA"]`以排定在美國的結果優先順序。如需進一步了解，請參閱[如何使用篩選條件進行地理編碼](how-to-geocode-filters.md)。
```
{
"QueryText": "Vancouver",
"Filter": {
"IncludeCountries": ["USA"],
"IncludePlaceTypes": ["City"]
}
}
```