ジオコーディングのリクエストとレスポンス

リクエスト

Geocoding API リクエストの形式は次のとおりです。

https://maps.googleapis.com/maps/api/geocode/outputFormat?parameters

outputFormat には次のいずれかの値を設定します。

  • json(推奨)は、出力が JSON(JavaScript Object Notation)であることを示します。または
  • xml: 出力が XML であることを示します。

HTTPS が必要です。

必須のパラメータと省略可能なパラメータがあります。URL の標準と同様に、パラメータはアンパサンド(&)文字を使用して区切ります。

このページの残りの部分では、ジオコーディングと リバース ジオコーディングを個別に処理します。これは、 リクエストのタイプごとに異なるパラメータを使用できます。

ジオコーディング(緯度と経度の検索)パラメータ

ジオコーディング リクエストの必須パラメータ:

  • address - 番地または plus code 指定します。次の形式に従って住所を指定します。 対象国の郵便業務で使用されている。追加 ビジネス名や部屋番号、部屋番号、階数などの住所要素 避けるべきです。番地の住所要素はスペースで区切る必要があります(ここでは URL エスケープされた %20 として示されています)。
    address=24%20Sussex%20Drive%20Ottawa%20ON
    plus code を次のような形式にします(プラス記号は %2B に URL エスケープされ、スペースは %20 に URL エスケープされます)。
    • グローバル コードは、6 文字以上の 4 文字の市外局番です。 (849VCWC8+R9 は 849VCWC8%2BR9)。
    • 複合コードは 6 文字以上のローカルコードで、 明示的な位置情報(CWC8+R9 Mountain View, CA, USA は CWC8%2BR9%20Mountain%20View%20CA%20USA)。
    で確認できます。
    --OR--
    components - 要素を含むコンポーネント フィルタ パイプ(|)で区切ります。コンポーネント フィルタも使用できます。 address が指定されている場合は、オプションのパラメータとして渡されます。 コンポーネント フィルタ内の各要素は、 component:value ペアを指定し、結果を完全に制限します。 ジオコーダから取得します。詳細情報: コンポーネントのフィルタリングをご覧ください。
  • key - アプリケーションの API キー。このキーは クォータ管理を目的としています。手順 キーを取得します。

詳しくは、よくある質問をご覧ください。 追加ガイダンスがあります

ジオコーディング リクエストの省略可能なパラメータ:

  • bounds - ビューポートの境界ボックス ジオコーディングの結果に大きくバイアスをかけることができます。このパラメータを使用すると、 ジオコーダからの結果に影響を与えるだけです。完全に制限することはできません。(詳細については、 詳しくは、下記のビューポートのバイアス設定をご覧ください)。
  • language - 使用する言語。 結果を返します。
    • サポートされている 。対応言語は頻繁に更新されるため、 すべてを網羅しているとは限りません。
    • language が指定されていない場合、ジオコーダは 記載されている優先言語を使用します。 Accept-Language ヘッダー、つまり リクエスト送信元のドメイン。
    • ジオコーダは、できるだけユーザーとローカルの両言語で判読可能な番地を返します。この目標を達成するために、 は、番地をローカル言語で 必要に応じてユーザーが読み取り可能なスクリプトで、望ましい状態を あります。それ以外の住所はすべて優先 あります。住所コンポーネントはすべて同じ言語で返されます 最初のコンポーネントから選択されます。
    • 使用したい言語で名前を表示できない場合、ジオコーダは 最も近いものを選択します
    • 優先言語は、表示される結果セットにほとんど影響しません。 返される順序を指定します。 ジオコーダでは、モデルによって略語の解釈が 道路の種類を表す略語や同義語など、 ある言語では有効であっても別の言語では有効でない場合があります。(例: utca)。 「tér」は「ストリート」と「スクエア」の同義語である (ハンガリー語)。
  • region - ccTLD(「トップレベル ドメイン」)の 2 文字の値として指定される地域コードです。このパラメータは、ジオコーダから返される結果に影響を与えますが、完全に制限するわけではありません。(詳細については、 詳しくは、下記の地域のバイアスをご覧ください)。このパラメータは、適用される法律に基づいて結果に影響することもあります。
  • components - 要素がパイプ(|)で区切られたコンポーネント フィルタ。リクエストに address が含まれていない場合、コンポーネント フィルタは必須です。コンポーネント フィルタ内の各要素は component:value ペアで構成され、ジオコーダからの結果を完全に制限します。詳しくは、後述のコンポーネントのフィルタリングをご覧ください。
  • extra_computations - このパラメータを使用して、 レスポンスには次のような特徴があります。 <ph type="x-smartling-placeholder">で確認できます。 同じ API リクエストに対してこれらの機能を複数有効にするには、 各特徴量のリクエストの extra_computations パラメータ 次に例を示します。
    extra_computations=ADDRESS_DESCRIPTORS&extra_computations=BUILDING_AND_ENTRANCES

レスポンス

ジオコーディングのレスポンスは、output フラグで指定された形式で返されます。 デフォルトで JSON 形式を使用します。

この例では、Geocoding API は json をリクエストしています。 住所「1600 Amphitheatre Parkway, Mountain View, CA」とあります。

このリクエストでは、JSON output フラグを使用しています。

https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY

このリクエストでは、XML の output フラグを使用しています。

https://maps.googleapis.com/maps/api/geocode/xml?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY

次のタブを選択すると、JSON と XML のレスポンスの例が表示されます。

JSON

{
    "results": [
        {
            "address_components": [
                {
                    "long_name": "1600",
                    "short_name": "1600",
                    "types": [
                        "street_number"
                    ]
                },
                {
                    "long_name": "Amphitheatre Parkway",
                    "short_name": "Amphitheatre Pkwy",
                    "types": [
                        "route"
                    ]
                },
                {
                    "long_name": "Mountain View",
                    "short_name": "Mountain View",
                    "types": [
                        "locality",
                        "political"
                    ]
                },
                {
                    "long_name": "Santa Clara County",
                    "short_name": "Santa Clara County",
                    "types": [
                        "administrative_area_level_2",
                        "political"
                    ]
                },
                {
                    "long_name": "California",
                    "short_name": "CA",
                    "types": [
                        "administrative_area_level_1",
                        "political"
                    ]
                },
                {
                    "long_name": "United States",
                    "short_name": "US",
                    "types": [
                        "country",
                        "political"
                    ]
                },
                {
                    "long_name": "94043",
                    "short_name": "94043",
                    "types": [
                        "postal_code"
                    ]
                },
                {
                    "long_name": "1351",
                    "short_name": "1351",
                    "types": [
                        "postal_code_suffix"
                    ]
                }
            ],
            "formatted_address": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
            "geometry": {
                "location": {
                    "lat": 37.4222804,
                    "lng": -122.0843428
                },
                "location_type": "ROOFTOP",
                "viewport": {
                    "northeast": {
                        "lat": 37.4237349802915,
                        "lng": -122.083183169709
                    },
                    "southwest": {
                        "lat": 37.4210370197085,
                        "lng": -122.085881130292
                    }
                }
            },
            "place_id": "ChIJRxcAvRO7j4AR6hm6tys8yA8",
            "plus_code": {
                "compound_code": "CWC8+W7 Mountain View, CA",
                "global_code": "849VCWC8+W7"
            },
            "types": [
                "street_address"
            ]
        }
    ],
    "status": "OK"
}

JSON レスポンスには次の 2 つのルート要素が含まれています:

  • "status" にはリクエストに関するメタデータが含まれます。詳しくは、 後述のステータス コードをご覧ください。
  • "results" には、ジオコーディングされた住所情報の配列が含まれます。 ジオメトリ情報を返します。

通常、"results" 配列内のエントリは 1 つだけ返されます。 ただし、ジオコーダは、住所が検索されたときに複数の結果を返すことがあります。 曖昧です

XML

<GeocodeResponse>
    <status>OK</status>
    <result>
        <type>street_address</type>
        <formatted_address>1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA</formatted_address>
        <address_component>
            <long_name>1600</long_name>
            <short_name>1600</short_name>
            <type>street_number</type>
        </address_component>
        <address_component>
            <long_name>Amphitheatre Parkway</long_name>
            <short_name>Amphitheatre Pkwy</short_name>
            <type>route</type>
        </address_component>
        <address_component>
            <long_name>Mountain View</long_name>
            <short_name>Mountain View</short_name>
            <type>locality</type>
            <type>political</type>
        </address_component>
        <address_component>
            <long_name>Santa Clara County</long_name>
            <short_name>Santa Clara County</short_name>
            <type>administrative_area_level_2</type>
            <type>political</type>
        </address_component>
        <address_component>
            <long_name>California</long_name>
            <short_name>CA</short_name>
            <type>administrative_area_level_1</type>
            <type>political</type>
        </address_component>
        <address_component>
            <long_name>United States</long_name>
            <short_name>US</short_name>
            <type>country</type>
            <type>political</type>
        </address_component>
        <address_component>
            <long_name>94043</long_name>
            <short_name>94043</short_name>
            <type>postal_code</type>
        </address_component>
        <geometry>
            <location>
                <lat>37.4224428</lat>
                <lng>-122.0842467</lng>
            </location>
            <location_type>ROOFTOP</location_type>
            <viewport>
                <southwest>
                    <lat>37.4212648</lat>
                    <lng>-122.0856069</lng>
                </southwest>
                <northeast>
                    <lat>37.4239628</lat>
                    <lng>-122.0829089</lng>
                </northeast>
            </viewport>
        </geometry>
        <place_id>ChIJeRpOeF67j4AR9ydy_PIzPuM</place_id>
        <plus_code>
            <global_code>849VCWC8+X8</global_code>
            <compound_code>CWC8+X8 Mountain View, CA</compound_code>
        </plus_code>
    </result>
</GeocodeResponse>

XML レスポンスは、1 つのファイルで 1 つの <GeocodeResponse> と 2 つの最上位要素:

  • <status> にはリクエストに関するメタデータが含まれます。下記のステータス コードをご覧ください。
  • 0 個以上の <result> 要素。それぞれに 1 つの要素が含まれます。 ジオコーディングされた住所情報とジオメトリ情報のセット。

XML レスポンスは JSON レスポンスよりかなり長くなります。そのため、何らかの理由でサービスで xml を使用する必要がない限り、Google では、優先出力フラグとして json を使用することをおすすめします。また、XML ツリーの処理には注意が必要です。 適切なノードと要素です。出力処理のお勧めの設計パターンについては、XPath による XML の処理をご覧ください。

<ph type="x-smartling-placeholder">
    </ph>
  • XML の結果はルートの <GeocodeResponse> 要素でラップされます。
  • JSON は、複数の要素を含むエントリを複数配列(types)で示します。 XML では、複数の単一要素(<type>)を使用してこれらを示します。
  • JSON では、空白の要素は空の配列として示されますが、 XML で参照できます。結果が生成されなかったレスポンスは、空の文字列を返します。 JSON には results 配列がありますが、XML には <result> 要素がありません。 できます。

ステータス コード

ジオコーディング レスポンス オブジェクトの "status" フィールドには、リクエストのステータスが含まれます。ジオコーディングが行えなかった原因を追跡できるようにデバッグ情報が含まれることもあります。"status" フィールドには次の値が含まれることがあります。

  • "OK" は、エラーが発生せず、住所が正常に解析され、少なくとも 1 件のジオコードが返されたことを示します。
  • "ZERO_RESULTS" は、ジオコードは成功したものの結果が返されなかったことを示します。これは、実在しない address がジオコーダに渡された場合に発生することがあります。
  • OVER_DAILY_LIMIT は次のいずれかを示します。 <ph type="x-smartling-placeholder">
      </ph>
    • API キーがないか、無効です。
    • アカウントで課金が有効になっていません。
    • ご自身で設定した使用量の上限を超えています。
    • ご指定のお支払い方法が無効になりました(例: クレジット カードの有効期限が切れています)。

    詳しくは、マップに関するよくある質問をご覧ください。 見てみましょう

  • "OVER_QUERY_LIMIT" はリクエストが割り当て量を超えていることを示します。
  • "REQUEST_DENIED" はリクエストが拒否されたことを示します。
  • "INVALID_REQUEST" は一般的に、クエリ(addresscomponentslatlng)が不足していることを示します。
  • "UNKNOWN_ERROR" はサーバーエラーでリクエストが処理できなかったことを示します。再度リクエストすると、成功する可能性があります。

エラー メッセージ

ジオコーダから OK 以外のステータス コードが返された場合、ジオコーディング レスポンス オブジェクト内に error_message フィールドが付加されている場合があります。このフィールドには、返されたステータス コードの原因に関する詳細情報が含まれています。

結果

ジオコーダは、返された結果を(JSON)results 内に格納します。 あります。ジオコーダが返す結果がない場合(住所が存在しない場合など)は、 空の results 配列を返します。(XML レスポンスは 0 個以上の <result> elements.)

一般的な結果には次のフィールドが含まれます。

  • types[] 配列は、返されたオブジェクトの型を示します。 表示されます。この配列には、コンテンツのタイプを識別する 0 個以上のタグのセットが 返されます。たとえば、「Chicago」のジオコードは返品 「地域区分」「シカゴ」は都市名の場合は "political" を返します 行政区画であることを示しています。住所コンポーネントに既知のタイプがない場合、コンポーネントのタイプ アレイが空になることがあります。API は、必要に応じて新しい型の値を追加することがあります。詳細については、住所タイプと住所コンポーネントをご覧ください。
  • formatted_address は、人が読める形式の文字列 住所を入力します。

    ほとんどの場合、この住所は「郵便の宛先」と同一です。イギリスなど一部の国では、ライセンス上の制限があるため実際の郵便の宛先は配信できません。

    フォーマット済み住所は、論理的には 1 つ以上の住所コンポーネントで構成されます。たとえば、「111 8th Avenue, New York, NY」という住所は、「111」(番地)、「8th Avenue」(道路名)、「New York」(都市名)、「NY」(アメリカの州名)で構成されています。

    フォーマット済み住所は、プログラムで解析しないでください。その代わりに、フォーマット済み住所のフィールドに加えて、API レスポンスに含まれる個々の住所コンポーネントを使用してください。

  • address_components[] は、個々の変数を含む配列です。 この住所に適用される項目です。

    通常、各住所コンポーネントには次のフィールドがあります。

    • types[] は住所コンポーネントのタイプを示す配列です。サポートされているタイプのリストをご覧ください。
    • long_name は、ジオコーダが返した住所コンポーネントの説明または名前です。
    • short_name は、住所コンポーネントの略称です(略称がある場合)。たとえば、アラスカ州の住所コンポーネントの場合は、long_name には「Alaska」が設定され、short_name には 2 文字の郵便略称を使用して「AK」が設定されます。

    address_components[] 配列については、次の点に注意してください。

    • 住所コンポーネントの配列には、formatted_address よりも多くのコンポーネントが含まれている場合があります。
    • この配列には、formatted_address に含まれているもの以外の住所を持つ行政区画が、すべて含まれているとは限りません。特定の住所を含むすべての行政区画を取得するには、リバース ジオコーディングを使用して住所の緯度と経度をパラメータとしてリクエストに渡します。
    • レスポンスの形式は、リクエスト間で同じになるとは限りません。特に、address_components の数はリクエストされた住所によって異なり、同じ住所でも将来的に変わる可能性があります。コンポーネントは、配列内の位置が変わる場合があります。 コンポーネントのタイプは変わる場合があります。特定のコンポーネントが以降のレスポンスに含まれない場合があります。

    コンポーネントの配列を処理するには、レスポンスを解析して、 式で適切な値を選択できます。詳しくは、 返すことができます

  • postcode_localities[] は、最大 100 個の地域区分を示す配列です。 含まれます。結果が「postal」である場合にのみ存在します。 記述する必要があります。
  • geometry には、次の情報が含まれます。 <ph type="x-smartling-placeholder">
      </ph>
    • location には、ジオコーディングされた緯度と経度の値が含まれます。通常用 ルックアップに使用されますが、通常、このフィールドは最も重要です。
    • location_type には、指定された場所に関する追加データが格納されます。「 現在サポートされている値は次のとおりです。

      • "ROOFTOP" は、返された結果が次の場所の正確なジオコーディングであることを示します。 正確な位置情報を取得しています
      • "RANGE_INTERPOLATED" の意味 想定していることを示す (交差点など)正確な 2 点間で補間された近似値(通常は道路上) 補間された結果が返されるのは、道路について屋上ジオコードを使用できない場合が一般的です。 あります。
      • "GEOMETRIC_CENTER" は、 返される結果は、各要素の幾何学的中心 ポリライン(道路など)やポリゴン(地域)などの結果を返します。
      • "APPROXIMATE" は、 近似値です。
    • viewport には、表示に推奨されるビューポートが含まれています。 返された結果。緯度および経度の 2 つの値として指定され、 southwest と ビューポートの境界ボックスの northeast の隅。通常、 結果をユーザーに表示するときに結果をフレーム化するために使用されます。
    • bounds(必要に応じて返される)には境界ボックスが格納されます。 返される結果を完全に含むことができます。なお、これらの境界は、 推奨のビューポートです。(たとえば、サンフランシスコには ファラロン諸島 は厳密には都市の一部ですが、多くの場合はビューポートに返す必要はありません)。
  • plus_code(参照: 地域コードを開く Plus Codes など)は、 緯度と経度の座標から導出される 面積を表す: 1/8000 度から 1/8000 度(約 14m x 14 m 以下)。Plus Code はコードの代わりに 住所が存在しない場所(建物がない場所)の番地 道路に名前がありません)。API がプラスコードを返すとは限りません。

    サービスが Plus Code を返す場合、そのサービスはグローバル コードと複合コードの形式になります。

    • global_code は 4 文字の市外局番と 6 文字以上のローカルコードです (849VCWC8+R9)。
    • compound_code は、明示的な場所を含む 6 文字以上のローカルコードです (米国カリフォルニア州マウンテンビュー、CWC8+R9)。このコンテンツをプログラムで解析しないでください。
    利用可能な場合は、API はグローバル コードと複合コードの両方を返します。ただし、 遠く離れた場所(海や砂漠など)に検索した場合にのみ グローバル コードが返されることがあります。
  • partial_match は、ジオコーダによって、元のリクエストに完全一致する住所は見つからなかったものの、部分一致する住所は見つかったことを示します。元のリクエストで住所の表記が間違っていたり、不完全である可能性があります。

    多くの場合、リクエストで渡された地域に番地が存在しないために部分一致が発生します。また、同じ地域内に複数の場所があるリクエストを行った場合も部分一致が返されます。たとえば、「Hillpar St, Bristol, UK」の場合は、Henry Street と Henrietta Street の両方の部分一致が返されます。リクエストに表記が間違った住所コンポーネントが含まれている場合、ジオコーディング サービスが別の住所を提示することもある点に注意してください。この場合も、部分一致として結果が返されます。

  • place_id は一意です 他の Google API で使用できる識別子が用意されています。たとえば place_id を 取得する Places API リクエスト ローカル ビジネスの詳細情報(電話番号、営業時間、ユーザーなど) 使用できます。プレイス ID を確認する 概要をご覧ください。

住所タイプと住所コンポーネント タイプ

結果の types[] 配列は、住所タイプを示します。住所タイプの例としては、番地、 政治的団体などのグループですtypes[] 配列もあります。 address_components[] は、メッセージの各部分のタイプを あります。たとえば、国や番地などです。(以下にタイプの全項目のリストを示します)。住所には複数のタイプがあります。これらのタイプは「タグ」と考えることができます。 たとえば、多くの都市には politicallocality 型。

ジオコーダでは、 住所タイプと住所コンポーネント タイプの配列:

  • street_address は正確な住所を示します。
  • route は名前のある道路(US 101 など)を示します。
  • intersection は、主要交差点(通常は 2 つの大通りの交差点)を示します。
  • political は行政区画を示します。通常、このタイプは行政区画のポリゴンを示します。
  • country は国レベルの行政区画を示し、一般的にはジオコーダから返される最上位のタイプです。
  • administrative_area_level_1 は国レベルの下の 1 次的な行政区画を示します。米国の場合、州がこの行政区画レベルに相当しますが、すべての国でこの行政区画レベルが存在するわけではありません。多くの場合、administrative_area_level_1 の省略名は下位区分 ISO 3166-2 とその他の一般的なリストに一致します。ただし、Google のジオコーディングの結果はさまざまな信号と位置情報データに基づいているため、これらの名前が厳密に一致するとは限りません。
  • administrative_area_level_2 は国レベルの下の 2 次的な行政区画を示します。米国の場合、郡がこの行政区画レベルに相当しますが、すべての国でこの行政区画レベルが存在するわけではありません。
  • administrative_area_level_3 は国レベルの下の 3 次的な行政区画を示します。このタイプは小規模な行政区域を示します。 すべての国でこの行政区画レベルが存在するわけではありません。
  • administrative_area_level_4 は国レベルより下位の 4 次の行政区画を示します。このタイプは小規模な行政区域を示します。 すべての国でこの行政区画レベルが存在するわけではありません。
  • administrative_area_level_5 は国レベルの 5 次以下の行政区画を示します。このタイプは小規模な行政区域を示します。 すべての国でこの行政区画レベルが存在するわけではありません。
  • administrative_area_level_6 は国レベルの 6 次以下の行政区画を示します。このタイプは小規模な行政区域を示します。すべての国でこの行政区画レベルが存在するわけではありません。
  • administrative_area_level_7 は国レベルの 7 次以下の行政区画を示します。このタイプは小規模な行政区域を示します。すべての国でこの行政区画レベルが存在するわけではありません。
  • colloquial_area は一般的に使用されている通称を示します。
  • locality は行政区画である都市または町を示します。
  • sublocality は locality の下の 1 次的な行政区画を示します。一部の場所では、sublocality_level_1sublocality_level_5 のいずれかの追加タイプを受け取ります。各下位地区レベルは行政区画で、数が大きいほど区域は小さくなります。
  • neighborhood は名前のある区域を示します。
  • premise は名前のある場所を示します。通常は共通の名前を持つ建物や建物の集合体です。
  • subpremise は名前のある場所の下の 1 次的な存在を示します。通常は共通の名前を持つ建物の集合体内の 1 棟の建物です。
  • plus_code はエンコードされた場所の参照情報を示します。緯度と経度に基づきます。Plus Codes は、番地がない場所(建物に番号が付いていない場所や、通りに名前がない場所)で、番地の代わりに使用できます。詳しくは https://plus.codes をご覧ください。
  • postal_code は対象の国内で郵便物の宛先として使用される郵便番号を示します。
  • natural_feature は特徴的な地勢を示します。
  • airport は空港を示します。
  • park は名前付きの公園を示します。
  • point_of_interest は名前のあるスポットを示します。通常、これらの「スポット」は、その地域で有名な場所のことを指し、「エンパイア ステートビル」や「エッフェル塔」など、他のカテゴリにはあまり当てはまらないものです。

タイプリストが空の場合は、特定の住所コンポーネントに対して既知のタイプが存在しないことを意味します。たとえば、フランスのリュディがこれに相当します。

上記の他に、住所コンポーネントにはここに示すタイプが含まれることがあります。このリストは すべてを網羅しているわけではなく、変更される可能性があります。

  • floor は建物の階数を示します。
  • establishment は通常、まだ分類されていない場所を示します。
  • landmark は、ナビゲーションを支援するために参照として使用される付近の場所を示します。
  • point_of_interest は名前のあるスポットを示します。
  • parking は、駐車場や立体駐車場を示します。
  • post_box は特定の郵便ポストを示します。
  • postal_town は、localitysublocality など、一部の国で郵送先住所に使用される地域グループを示します。
  • room は建物の部屋を示します。
  • street_number は正確な番地を示します。
  • bus_stationtrain_stationtransit_station は、バス、電車、または公共交通機関の停留所の場所を示します。
で確認できます。

ビューポートのバイアス設定

ジオコーディング リクエストでは、ジオコーディング サービスに、 (境界ボックスとして表現されます)。そうする bounds パラメータを設定してリクエスト URL 内に挿入します。

bounds パラメータは緯度と経度の座標を定義します パイプを使って、この境界ボックスの南西と北東の角を (|)文字を使用して座標を区切ることができます。

たとえば、「Washington」のジオコードでは通常、米国のワシントン州が返されます。

リクエスト:

https://maps.googleapis.com/maps/api/geocode/json?address=Washington&key=YOUR_API_KEY

対応:

{
   "results" : [
      {
         "address_components" : [
            {
               "long_name" : "Washington",
               "short_name" : "WA",
               "types" : [ "administrative_area_level_1", "political" ]
            },
            {
               "long_name" : "United States",
               "short_name" : "US",
               "types" : [ "country", "political" ]
            }
         ],
         "formatted_address" : "Washington, USA",
         "geometry" : {
            "bounds" : {
               "northeast" : {
                  "lat" : 49.0024442,
                  "lng" : -116.91558
               },
               "southwest" : {
                  "lat" : 45.543541,
                  "lng" : -124.8489739
               }
            },
            "location" : {
               "lat" : 47.7510741,
               "lng" : -120.7401385
            },
            "location_type" : "APPROXIMATE",
            "viewport" : {
               "northeast" : {
                  "lat" : 49.0024442,
                  "lng" : -116.91558
               },
               "southwest" : {
                  "lat" : 45.543541,
                  "lng" : -124.8489739
               }
            }
         },
         "place_id" : "ChIJ-bDD5__lhVQRuvNfbGh4QpQ",
         "types" : [ "administrative_area_level_1", "political" ]
      }
   ],
   "status" : "OK"
}

ただし、bounds 引数を追加して境界ボックスを定義すると、 このジオコーディングでは、米国の北東地区の ワシントン DC:

リクエスト:

https://maps.googleapis.com/maps/api/geocode/json?address=Washington&bounds=36.47,-84.72%7C43.39,-65.90&key=YOUR_API_KEY

対応:

{
   "results" : [
      {
         "address_components" : [
            {
               "long_name" : "Washington",
               "short_name" : "Washington",
               "types" : [ "locality", "political" ]
            },
            {
               "long_name" : "District of Columbia",
               "short_name" : "District of Columbia",
               "types" : [ "administrative_area_level_2", "political" ]
            },
            {
               "long_name" : "District of Columbia",
               "short_name" : "DC",
               "types" : [ "administrative_area_level_1", "political" ]
            },
            {
               "long_name" : "United States",
               "short_name" : "US",
               "types" : [ "country", "political" ]
            }
         ],
         "formatted_address" : "Washington, DC, USA",
         "geometry" : {
            "bounds" : {
               "northeast" : {
                  "lat" : 38.9958641,
                  "lng" : -76.90939299999999
               },
               "southwest" : {
                  "lat" : 38.7916449,
                  "lng" : -77.119759
               }
            },
            "location" : {
               "lat" : 38.9071923,
               "lng" : -77.03687069999999
            },
            "location_type" : "APPROXIMATE",
            "viewport" : {
               "northeast" : {
                  "lat" : 38.9958641,
                  "lng" : -76.90939299999999
               },
               "southwest" : {
                  "lat" : 38.7916449,
                  "lng" : -77.119759
               }
            }
         },
         "place_id" : "ChIJW-T2Wt7Gt4kRKl2I1CJFUsI",
         "types" : [ "locality", "political" ]
      }
   ],
   "status" : "OK"
}

地域のバイアス

ジオコーディング リクエストで、region パラメータを使用して、ジオコーディング サービスが特定の地域を優先して結果を返すように指示できます。このパラメータは ccTLD(国コード トップレベル ドメイン)で指定します。 domain)引数を使用して、リージョンのバイアスを指定します。ほとんどの ccTLD コードは ISO 3166-1 コード。例: United States 王国の国別コード トップレベル ドメインは「uk」(.co.uk)。ISO 3166-1 コードは「gb」です。 (厳密には、「 北アイルランド」)

ジオコーディングの結果は、主要なドメインが Google マップ アプリが正式にリリースされました。なお バイアスの設定のみ 特定のドメインの検索結果を優先する場合より関連性の高い結果が存在する場合 ドメイン外の場合は、それらが含まれる場合があります。

たとえば、「Toledo」のジオコードはこの結果をデフォルトの ドメインは米国に設定されています。リクエスト:

https://maps.googleapis.com/maps/api/geocode/json?address=Toledo&key=YOUR_API_KEY

対応:

{
   "results" : [
      {
         "address_components" : [
            {
               "long_name" : "Toledo",
               "short_name" : "Toledo",
               "types" : [ "locality", "political" ]
            },
            {
               "long_name" : "Lucas County",
               "short_name" : "Lucas County",
               "types" : [ "administrative_area_level_2", "political" ]
            },
            {
               "long_name" : "Ohio",
               "short_name" : "OH",
               "types" : [ "administrative_area_level_1", "political" ]
            },
            {
               "long_name" : "United States",
               "short_name" : "US",
               "types" : [ "country", "political" ]
            }
         ],
         "formatted_address" : "Toledo, OH, USA",
         "geometry" : {
            "bounds" : {
               "northeast" : {
                  "lat" : 41.732844,
                  "lng" : -83.454229
               },
               "southwest" : {
                  "lat" : 41.580266,
                  "lng" : -83.69423700000002
               }
            },
            "location" : {
               "lat" : 41.6639383,
               "lng" : -83.55521200000001
            },
            "location_type" : "APPROXIMATE",
            "viewport" : {
               "northeast" : {
                  "lat" : 41.732844,
                  "lng" : -83.454229
               },
               "southwest" : {
                  "lat" : 41.580266,
                  "lng" : -83.69423700000002
               }
            }
         },
         "place_id" : "ChIJeU4e_C2HO4gRRcM6RZ_IPHw",
         "types" : [ "locality", "political" ]
      }
   ],
   "status" : "OK"
}

「Toledo」のジオコーディング リクエストregion=es(スペイン)の スペインの都市が返されます

リクエスト:

https://maps.googleapis.com/maps/api/geocode/json?address=Toledo&region=es&key=YOUR_API_KEY

対応:

{
   "results" : [
      {
         "address_components" : [
            {
               "long_name" : "Toledo",
               "short_name" : "Toledo",
               "types" : [ "locality", "political" ]
            },
            {
               "long_name" : "Toledo",
               "short_name" : "TO",
               "types" : [ "administrative_area_level_2", "political" ]
            },
            {
               "long_name" : "Castile-La Mancha",
               "short_name" : "CM",
               "types" : [ "administrative_area_level_1", "political" ]
            },
            {
               "long_name" : "Spain",
               "short_name" : "ES",
               "types" : [ "country", "political" ]
            }
         ],
         "formatted_address" : "Toledo, Spain",
         "geometry" : {
            "bounds" : {
               "northeast" : {
                  "lat" : 39.88605099999999,
                  "lng" : -3.9192423
               },
               "southwest" : {
                  "lat" : 39.8383676,
                  "lng" : -4.0796176
               }
            },
            "location" : {
               "lat" : 39.8628316,
               "lng" : -4.027323099999999
            },
            "location_type" : "APPROXIMATE",
            "viewport" : {
               "northeast" : {
                  "lat" : 39.88605099999999,
                  "lng" : -3.9192423
               },
               "southwest" : {
                  "lat" : 39.8383676,
                  "lng" : -4.0796176
               }
            }
         },
         "place_id" : "ChIJ8f21C60Lag0R_q11auhbf8Y",
         "types" : [ "locality", "political" ]
      }
   ],
   "status" : "OK"
}

コンポーネントのフィルタリング

Geocoding API は、ジオコーディングのレスポンスにおいて、特定のエリアに制限された住所の結果を返すことができます。制限を指定するには、 components フィルタ。フィルタは、パイプ(|)で区切った component:value ペアのリストです。フィルタの値は、スペル訂正や部分一致など、他のジオコーディングのリクエストと同じメソッドをサポートしています。ジオコーダによって、部分一致と コンポーネント フィルタを使用すると、レスポンスには partial_match フィールドが含まれます。

フィルタできる components は次のとおりです。

次の components は結果に影響を与える可能性がありますが、使用されることはありません 適用:

  • route は、道路の正式名または略称を照合します。
  • locality は、locality タイプと sublocality タイプで照合します。
  • administrative_area は、すべての administrative_area レベル。

コンポーネント フィルタリングに関する注意事項:

  • リクエストでこれらのコンポーネント フィルタを繰り返さないでください。繰り返さないでください。API から Invalid_request: countrypostal_coderoute
  • リクエストに重複するコンポーネント フィルタが含まれている場合、API はこれらのフィルタを OR ではなく AND として評価します。
  • 結果は Google マップと一致しているため、 予期しない ZERO_RESULTS レスポンス。Place Autocomplete を使用する ユースケースによってはより良い結果が得られる場合があります。詳しくは、 この よくある質問
  • 住所コンポーネントごとに、address components フィルタ内で使用できますが、両方は使用できません。指定 両方に同じ値を指定すると、ZERO_RESULTS が返される場合があります。

「High St, Hastings」のジオコード参加者: components=country:GB さん は、アメリカのヘイスティングス オン ハドソンではなく、イギリスのヘイスティングスで結果を返します。

リクエスト:

https://maps.googleapis.com/maps/api/geocode/json?address=high+st+hasting&components=country:GB&key=YOUR_API_KEY

対応:

{
   "results" : [
      {
         "address_components" : [
            {
               "long_name" : "High Street",
               "short_name" : "High St",
               "types" : [ "route" ]
            },
            {
               "long_name" : "Hastings",
               "short_name" : "Hastings",
               "types" : [ "postal_town" ]
            },
            {
               "long_name" : "East Sussex",
               "short_name" : "East Sussex",
               "types" : [ "administrative_area_level_2", "political" ]
            },
            {
               "long_name" : "England",
               "short_name" : "England",
               "types" : [ "administrative_area_level_1", "political" ]
            },
            {
               "long_name" : "United Kingdom",
               "short_name" : "GB",
               "types" : [ "country", "political" ]
            },
            {
               "long_name" : "TN34 3EY",
               "short_name" : "TN34 3EY",
               "types" : [ "postal_code" ]
            }
         ],
         "formatted_address" : "High St, Hastings TN34 3EY, UK",
         "geometry" : {
            "bounds" : {
               "northeast" : {
                  "lat" : 50.8601041,
                  "lng" : 0.5957329
               },
               "southwest" : {
                  "lat" : 50.8559061,
                  "lng" : 0.5906163
               }
            },
            "location" : {
               "lat" : 50.85830319999999,
               "lng" : 0.5924594
            },
            "location_type" : "GEOMETRIC_CENTER",
            "viewport" : {
               "northeast" : {
                  "lat" : 50.8601041,
                  "lng" : 0.5957329
               },
               "southwest" : {
                  "lat" : 50.8559061,
                  "lng" : 0.5906163
               }
            }
         },
         "partial_match" : true,
         "place_id" : "ChIJ-Ws929sa30cRKgsMNVkPyws",
         "types" : [ "route" ]
      }
   ],
   "status" : "OK"
}

components=country:ES を指定して「Santa Cruz」の地区のジオコーディング リクエストを実行すると、スペイン領カナリア諸島のサンタ・クルス・デ・テネリフェ島が返されます。

リクエスト:

https://maps.googleapis.com/maps/api/geocode/json?components=locality:santa+cruz|country:ES&key=YOUR_API_KEY

対応:

{
   "results" : [
      {
         "address_components" : [
            {
               "long_name" : "Santa Cruz de Tenerife",
               "short_name" : "Santa Cruz de Tenerife",
               "types" : [ "locality", "political" ]
            },
            {
               "long_name" : "Santa Cruz de Tenerife",
               "short_name" : "TF",
               "types" : [ "administrative_area_level_2", "political" ]
            },
            {
               "long_name" : "Canary Islands",
               "short_name" : "CN",
               "types" : [ "administrative_area_level_1", "political" ]
            },
            {
               "long_name" : "Spain",
               "short_name" : "ES",
               "types" : [ "country", "political" ]
            }
         ],
         "formatted_address" : "Santa Cruz de Tenerife, Spain",
         "geometry" : {
            "bounds" : {
               "northeast" : {
                  "lat" : 28.487616,
                  "lng" : -16.2356646
               },
               "southwest" : {
                  "lat" : 28.4280248,
                  "lng" : -16.3370045
               }
            },
            "location" : {
               "lat" : 28.4636296,
               "lng" : -16.2518467
            },
            "location_type" : "APPROXIMATE",
            "viewport" : {
               "northeast" : {
                  "lat" : 28.487616,
                  "lng" : -16.2356646
               },
               "southwest" : {
                  "lat" : 28.4280248,
                  "lng" : -16.3370045
               }
            }
         },
         "place_id" : "ChIJcUElzOzMQQwRLuV30nMUEUM",
         "types" : [ "locality", "political" ]
      }
   ],
   "status" : "OK"
}

コンポーネントのフィルタリングが ZERO_RESULTS レスポンスを返す 相互に除外フィルタを指定した場合のみ有効です

リクエスト:

https://maps.googleapis.com/maps/api/geocode/json?components=administrative_area:TX|country:FR&key=YOUR_API_KEY

対応:

{
   "results" : [],
   "status" : "ZERO_RESULTS"
}

components フィルタを使用すると、address パラメータなしで有効なクエリを実行できます。(住所全体をジオコーディングする際、 リクエストに次の要素が含まれている場合、address パラメータは必須です。 建物の数など)。

リクエスト:

https://maps.googleapis.com/maps/api/geocode/json?components=route:Annankatu|administrative_area:Helsinki|country:Finland&key=YOUR_API_KEY

対応:

{
   "results" : [
      {
         "address_components" : [
            {
               "long_name" : "Annankatu",
               "short_name" : "Annankatu",
               "types" : [ "route" ]
            },
            {
               "long_name" : "Helsinki",
               "short_name" : "HKI",
               "types" : [ "locality", "political" ]
            },
            {
               "long_name" : "Finland",
               "short_name" : "FI",
               "types" : [ "country", "political" ]
            },
            {
               "long_name" : "00101",
               "short_name" : "00101",
               "types" : [ "postal_code" ]
            }
         ],
         "formatted_address" : "Annankatu, 00101 Helsinki, Finland",
         "geometry" : {
            "bounds" : {
               "northeast" : {
                  "lat" : 60.168997,
                  "lng" : 24.9433353
               },
               "southwest" : {
                  "lat" : 60.16226160000001,
                  "lng" : 24.9332897
               }
            },
            "location" : {
               "lat" : 60.1657808,
               "lng" : 24.938451
            },
            "location_type" : "GEOMETRIC_CENTER",
            "viewport" : {
               "northeast" : {
                  "lat" : 60.168997,
                  "lng" : 24.9433353
               },
               "southwest" : {
                  "lat" : 60.16226160000001,
                  "lng" : 24.9332897
               }
            }
         },
         "place_id" : "ChIJARW7C8sLkkYRgl4je4-RPUM",
         "types" : [ "route" ]
      }
   ],
   "status" : "OK"
}