翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# ジオコード
ジオコーディングは、詳細な住所コンポーネントと追加情報と共に、テキストの住所や場所名を地理的座標に変換します。この API は、自由形式のテキストクエリと、通り名、郵便番号、地域を含む構造化クエリの両方を含む柔軟なクエリをサポートします。オプション機能には、タイムゾーンデータと政治的見解での調整が含まれます。
**注記**
結果を保存すると、ストレージ料金が上がります。`IntendedUse` パラメータを使用して、単回使用か保存するかを示します。保存した結果がコストに及ぼす影響については、「[場所の料金](places-pricing.md)」を参照してください。
詳細については、「*Amazon Location Service API リファレンス*」の「[Geocode](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_Geocode.html)」を参照してください。
この API のリクエスト、レスポンス、cURL、CLI コマンドの例については、「[Geocode の使用方法](https://docs.aws.amazon.com/location/latest/developerguide/how-to-geocode.html)」を参照してください。
## ユースケース
+ **顧客住所に補足データを追加する:** 郵便番号、調整、永続ストレージの活用を含めて住所レコードを改善し、情報に基づいたビジネスやマーケティングの決定をサポートします。
+ **住所データの標準化:** データパイプラインまたはバッチプロセスにジオコーディングを適用して住所データを標準化し、永続ストレージを利用して継続的な参照を行います。
+ **タイムゾーンを判断する:** 都市または住所のタイムゾーンを特定し、旅行、スケジューリング、請求などのアプリケーションに正確なタイムスタンプを提供します。
## リクエストを理解する
リクエストは、`AdditionalFeatures`、`BiasPosition`、`Filter` などのオプションパラメータを受け入れて、検索結果を絞り込みます。`Language`、`MaxResults`、`PoliticalView` などの追加オプションでは、レスポンスをさらにカスタマイズできます。必須パラメータは `Query` で、自由形式のテキストとして提供することも、`QueryComponents` として構造化することもできます。詳細については、Geocode API リファレンスを参照してください。
このリクエストには次のキーパラメータが含まれます。
**認証**
他の認証方法が使用されている場合、`Key`パラメータはオプションです。
+ `Key`: 認証のオプションパラメータ。
詳細については、[Amazon Location Service を使用して認証する](access.md)を参照してください。
**クエリとバイアス**
結果のクエリと地理的バイアスに使用されるパラメータ。
+ `QueryText`: 場所を検索するための自由形式のテキストクエリ。
+ `QueryComponents`: 正確な検索のための住所番地、国、地域、郵便番号などの構造化コンポーネント。
+ `BiasPosition`: 検索結果をバイアスする地理的位置。
詳細については、[クエリとバイアス](places-querying-biasing.md)を参照してください。
**結果の絞り込み**
フィルターを適用して結果を絞り込みます。
+ `Filter`: フィルタリングして、特定の国または場所タイプを含めます。詳細については、「[フィルタリング](places-filtering.md)」を参照してください。
**国際化とローカリゼーション**
言語を指定し、ローカライズされた結果にポリティカルビューを適用します。
+ `Language`: 結果の言語。
+ `PoliticalView`: 領土主張を反映したポリティカルビューを適用します。
詳細については、[ローカリゼーションと国際化](places-localization-internationalization.md)を参照してください。
**その他の機能**
タイムゾーンの詳細などの追加情報をリクエストします。
+ `AdditionalFeatures`: タイムゾーンなどの追加の詳細をリクエストするオプション。詳細については、「[その他の機能](additional-features.md)」を参照してください。
## レスポンスを理解する
レスポンスは、`Address`、`PlaceId`、`Position` などの詳細な位置データを含む `ResultItems`を提供します。`TimeZone` 情報や各クエリコンポーネントの `MatchScores` などの追加機能が含まれる場合もあります。各 `ResultItem` は、指定されたリクエストパラメータに基づいて一致するロケーションまたはジオコーディング結果を表します。詳細については、「Geocode API リファレンス」を参照してください。
レスポンスには、以下のキーパラメータが含まれます。
**住所と関連情報**
住所コンポーネントなど、返されたロケーションに関する詳細。
+ `Address`: 国、地域、郵便番号、通りの詳細を含む完全な住所。
+ `PostalCodeDetails`: 郵便番号に関連する追加情報。
+ `StreetComponents`: ベース名とタイプを含む通りの詳細。
**場所のタイプとカテゴリ**
返される場所のタイプとカテゴリに関する情報。
+ `Categories`: *レストラン*、*学校*など、場所を説明するカテゴリのリスト。
+ `PlaceType`: 都市、住所、地域など、場所のタイプを指定します。
**結果分析**
結果が入力クエリとどの程度一致しているかを示すスコア。
+ `MatchScores`: 一致精度のスコア。
+ `Overall`: 住所検索が入力とどの程度一致しているかを 0.0～1.0 (0%～100%) のスケールで測定します。満点である 1.0 は、検索のすべての部分がデータベースで見つかったことを意味します。連絡先名や配送の道順などの追加の詳細を含めると、スコアが低くなるのは正常です。これらによりスコアは自然に低くなりますが、住所が正しくないとは限りません。
+ `Component Score`: 各住所コンポーネント (`AddressNumber` や `PostalCode` など) は、0.0～1.0 (0%～100%) のスケールで個別にスコアリングされます。これらのスコアは、アドレスの各部分が結果とどの程度正確に一致しているかを示します。例えば、`AddressNumber`、`Street`、および `PostalCode` のスコアが 1.0 に近い場合、他のクエリの詳細が原因で全体的なスコアが低い場合でも、一致を信頼できます。
**注記**
特定のコンポーネント (`Street` など) のスコアが表示されない場合、そのコンポーネントは 0 としてカウントされます。これにより、検証が必要な住所の一部を特定できます。
このスコアリングシステムは、追加情報を含むことが多い実際の住所検索を処理するときに、完全一致と実用的なユーザビリティのバランスを取るのに役立ちます。
**その他の詳細**
必要に応じて追加の位置情報を含めます。
+ `AccessPoints`: アクセスポイントを表す地理的座標。
+ `TimeZone`: ロケーションのタイムゾーン情報。