翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# リバースジオコード
<a name="reverse-geocode"></a>

Reverse Geocode は、地理的座標を人間が読めるアドレスまたは場所に変換します。詳細な住所コンポーネント、場所タイプ、カテゴリ、道路情報を提供し、場所タイプに基づいてフィルタリングオプションを使用して結果を絞り込みます。この API には、タイムゾーン情報やポリティカルビューの調整などの追加機能を含めることもできます。

**注記**  
結果を保存すると、より高いストレージ料金階層で請求されます。`IntendedUse` パラメータを使用して、結果を単回使用するか保存するかを指定します。保存された結果に関連するコストへの影響については、「[場所の料金](places-pricing.md)」を参照してください。

詳細については、「*Amazon Location Service API リファレンス*」の「[ReverseGeocode](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_ReverseGeocode.html)」を参照してください。

この API のリクエスト、レスポンス、cURL、CLI コマンドの例については、「[Reverse Geocode の使用方法](https://docs.aws.amazon.com/location/latest/developerguide/reverse-geocode-how-to.html)」を参照してください。

## ユースケース
<a name="reverse-geocode-use-cases"></a>
+ **顧客のポジションデータに補足データを追加する:** 郵便番号、座標、永続ストレージの活用を含めてポジションデータレコードを改善し、情報に基づいたビジネスやマーケティングの決定をサポートします。
+ **位置データの標準化:** データパイプラインまたはバッチプロセスにジオコーディングを適用して位置データを標準化し、永続的ストレージを利用して継続的な参照を行います。
+ **タイムゾーンを判断する:** 都市または住所のタイムゾーンを特定し、旅行、スケジューリング、請求などのアプリケーションに正確なタイムスタンプを提供します。

## リクエストを理解する
<a name="reverse-geocode-request-parameters"></a>

**注記**  
 `ap-southeast-1` と のお客様は`ap-southeast-5`、サポートされているリクエストフィールドとレスポンスフィールドが異なる場合があります。詳細については、[ReverseGeocode API リファレンス](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_ReverseGeocode.html)」を参照してください。

Reverse Geocode API リクエストは、結果をカスタマイズするために必須パラメータとオプションパラメータの組み合わせを受け入れます。必須パラメータ `QueryPosition` (経度と緯度) は、ジオコードを反転させる座標を指定します。オプションのパラメータには、追加データの `AdditionalFeatures`、結果を絞り込む `Filter`、返される結果の数を制限する `MaxResults` が含まれます。`Language`、`PoliticalView`、`IntendedUse` などの追加オプションを使用すると、さらにカスタマイズできます。詳細については、「Reverse Geocode API リファレンス」を参照してください。

リクエストは、次のキーパラメータを受け入れます。

**認証**  
他の認証方法を使用する場合、`Key` パラメータはオプションです。  
+ `Key`: 認証のオプションパラメータ。
詳細については、「[Amazon Location Service を使用して認証する](access.md)」を参照してください。

**クエリ**  
地理的位置と検索半径の定義に使用されるパラメータ。  
+ `QueryPosition`: リバースジオコードリクエストの経度と緯度を指定します。
+ `QueryRadius`: 座標を囲む検索半径を定義します。
詳細については、「[クエリとバイアス](places-querying-biasing.md)」を参照してください。

**結果の絞り込み**  
フィルターを適用して、検索結果を特定の国または場所タイプに制限します。  
+ `Filter`: 国または場所のタイプに基づいて結果をフィルタリングします。
詳細については、[フィルタリング](places-filtering.md)を参照してください。

**国際化とローカリゼーション**  
言語をカスタマイズし、結果にポリティカルビューを適用するオプション。  
+ `Language`: 結果の言語を指定します。
+ `PoliticalView`: 領土主張を反映したポリティカルビューを適用します。
詳細については、「[ローカリゼーションと国際化](places-localization-internationalization.md)」を参照してください。

**その他の機能**  
タイムゾーン情報などの追加データをリクエストします。  
+ `AdditionalFeatures`: タイムゾーンの詳細などの追加データをリクエストするオプション。
詳細については、「[その他の機能](additional-features.md)」を参照してください。

## レスポンスを理解する
<a name="reverse-geocode-response-details"></a>

Reverse Geocode API からのレスポンスは、指定された座標の位置に関する詳細情報を提供します。`ResultItems` 配列には場所オブジェクトのリストが含まれ、それぞれに住所の詳細、カテゴリ、地理的位置が含まれます。`TimeZone`、`FoodTypes`、`PostalCodeDetails` などの追加データは、さらにコンテキストを提供します。レスポンスには、マッピング用の境界ボックス情報とクエリ位置からの距離も含まれます。詳細については、「Reverse Geocode API リファレンス」を参照してください。

このレスポンスには、以下のキーデータが含まれます。

**住所と関連情報**  
返される場所の詳細な住所情報。  
+ `Address`: 国、地域、郵便番号、番地の詳細など、住所情報を入力します。
+ `PostalCodeDetails`: 分類や郵政当局など、郵便番号に関連する追加の詳細。
+ `StreetComponents`: ベース名やタイプなど、番地に関する追加の詳細。

**場所のタイプとカテゴリ**  
返される場所のタイプとカテゴリについて説明します。  
+ `Categories`: *レストラン*や*学校*など、場所を説明するカテゴリ。
+ `PlaceType`: 都市、住所、リージョンなど、場所のタイプを指定します。

**結果分析**  
各結果が入力クエリとどの程度一致するかに関する情報。  
+ `MatchScores`: 入力クエリに対する各一致の精度を示すスコア。

**その他の詳細**  
追加のロケーション関連データを提供します。  
+ `TimeZone`: ロケーションのタイムゾーン情報。
+ `AccessPoints`: 場所へのエントリポイントを表す地理的座標。