翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 行政区域と郵便区域をジオコーディングする方法
Geocode API を使用すると、国、地域 (都道府県)、または都市の名前などのクエリテキスト入力を使用して、地理的エリアのジオコーディングを実行できます。API レスポンスには、地理的座標、マップ視覚化の境界ボックス、クエリへの結果の関連性を示す一致スコアなどの場所の詳細が含まれます。
## 想定されるユースケース
+ **行政区域の座標を取得する:** 座標を他の Places API におけるバイアス位置または中心点として使用します。
+ **マップの情報を視覚化する:** ジオコーディングされた座標を使用して、データをマップに視覚的に表示します。
## 例
### 国をジオコーディングする
------
#### [ Sample request ]
```
{
"QueryText": "Canada"
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId":"",
"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"
```
------
### リージョンをジオコーディングする
------
#### [ Sample request ]
```
{
"QueryText": "BC"
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"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"
```
------
### 都市をジオコーディングする
------
#### [ Sample request ]
```
{
"QueryText": "Vancouver"
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"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"
```
------
### 郵便番号をジオコーディングする
郵便番号をジオコーディングできます。より正確な結果を得るには、`["PostalCode"]` に `IncludePlaceTypes` を使用します。
------
#### [ Sample request ]
```
{
"QueryText": "800006",
"Filter": { "IncludePlaceTypes": ["PostalCode"] }
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"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"]}'
```
------
## デベロッパー向けのヒント
ターゲットを絞った結果を得るには、`IncludeCountries` や `IncludePlaceTypes` などのフィルターを使用します。例えば、米国のバンクーバーからの結果を確認するには、`"IncludeCountries": ["USA"]` を設定します。詳細については、以下を参照してください。
```
{
"QueryText": "Vancouver",
"Filter": { "IncludeCountries": ["USA"] }
}
```