翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
管理エリアと郵便番号エリアをジオコードする方法
Geocode API を使用すると、国、地域 (州）、または都市の名前などのクエリテキスト入力を使用して、地理的エリアのジオコーディングを実行できます。API レスポンスには、地理的座標、マップ視覚化の境界ボックス、クエリへの結果の関連性を示す一致スコアなどの場所の詳細が含まれます。
潜在的なユースケース
-
管理領域の座標を取得する： 座標を他の Places APIs。
-
マップ上の情報を視覚化する： ジオコードされた座標を使用して、データをマップに視覚的に表示できます。
例
- 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"
- 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"
- 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"
郵便番号をジオコードできます。より正確な結果を得る["PostalCode"]には、 IncludePlaceTypesで を使用します。
- 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"]}'
開発者向けのヒント
ターゲットを絞った結果IncludePlaceTypesを得るには、 IncludeCountriesや などのフィルターを使用します。たとえば、米国のバンクーバーからの結果を確認するには、 を設定します"IncludeCountries": ["USA"]。詳細については、「」を参照してください。
{ "QueryText": "Vancouver", "Filter": { "IncludeCountries": ["USA"] } }
Geocode を使用する
アドレスをジオコードする