ジオコード - Amazon Location Service
ユースケースリクエストを理解するレスポンスを理解する

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

ジオコード

ジオコーディングは、詳細なアドレスコンポーネントや追加情報とともに、テキストアドレスまたはプレース名を地理的座標に変換します。この API は、自由形式のテキストクエリと、通りの名前、郵便番号、リージョンを含む構造化クエリの両方を含む柔軟なクエリをサポートします。オプション機能には、タイムゾーンデータと政治的表示の調整が含まれます。

注記

保存された結果では、ストレージ料金が高くなります。IntendedUse パラメータを使用して、シングルユースまたはストレージを示します。保存された結果のコストへの影響についてはプレイスの料金、「」を参照してください。

詳細については、Amazon Location Service API リファレンスの「Geocode」を参照してください。

この API のリクエスト、レスポンス、cURL、CLI コマンドの例については、「Geocode の使用方法」を参照してください。

ユースケース

  • 顧客の住所に補足データを追加する： 郵便番号、調整、永続的ストレージの活用を含めて住所レコードを改善し、情報に基づいたビジネスやマーケティングの決定をサポートします。

  • Address Data Standardization: データパイプラインまたはバッチプロセスにジオコーディングを適用してアドレスデータを標準化し、永続的ストレージを利用して継続的な参照を行います。

  • タイムゾーンを決定する： 都市または住所のタイムゾーンを特定し、旅行、スケジューリング、請求などのアプリケーションに正確なタイムスタンプを提供します。

リクエストを理解する

リクエストは、AdditionalFeatures、、 BiasPositionなどのオプションパラメータを受け入れてFilter、検索結果を絞り込みます。、Language、 MaxResultsなどの追加オプションではPoliticalView、レスポンスをさらにカスタマイズできます。必須パラメータは でQuery、自由形式のテキストとして提供することも、 として構造化することもできますQueryComponents。詳細については、Geocode API リファレンスを参照してください。

リクエストには、次のキーパラメータが含まれます。

認証

認証では、他のメソッドが使用されている場合、 Keyパラメータはオプションです。

  • Key: 認証のオプションパラメータ。

詳細については、Amazon Location Service による認証を参照してください。

クエリとバイアス

結果のクエリと地理的バイアスに使用されるパラメータ。

  • QueryText: 場所を検索するための自由形式のテキストクエリ。

  • QueryComponents: 正確な検索のための住所番号、国、地域、郵便番号などの構造化コンポーネント。

  • BiasPosition: 検索結果をバイアスする地理的位置。

詳細については、クエリとバイアスを参照してください。

結果の絞り込み

フィルターを適用して結果を絞り込みます。

  • Filter: フィルタリングして、特定の国または場所タイプを含めます。詳細については、「フィルタリング」を参照してください。

国際化とローカリゼーション

言語を指定し、ローカライズされた結果に政治的ビューを適用します。

  • Language: 結果の言語。

  • PoliticalView: 領土クレームを反映した政治的見解を適用します。

詳細については、ローカリゼーションと国際化を参照してください。

その他の機能

タイムゾーンの詳細などの追加情報をリクエストします。

  • AdditionalFeatures: タイムゾーンなどの追加の詳細をリクエストするオプション。詳細については、「その他の機能」を参照してください。

レスポンスを理解する

レスポンスは、ResultItems、、Address、 Positionなどの詳細な位置データを含む PlaceIdを提供します。各クエリコンポーネントの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: 場所のタイムゾーン情報。