目的地を検索する

欧州経済領域(EEA)のデベロッパー

A Destination は、ユーザーが到達またはナビゲートしようとしている重要なスポットまたは特定の場所を指します。Destination には、ナビゲーション ポイント、ランドマーク、入り口、建物の輪郭などの情報を含めることができます。

Geocoding API の SearchDestinations メソッドを使用すると、住所、プレイス ID、または 緯度と経度の座標など、さまざまな入力条件に基づいて、さまざまな 目的地に関する詳細情報を取得できます。

目的地検索リクエスト

目的地検索 リクエスト は、次の形式の URL への HTTP POST リクエストです。

https://geocode.googleapis.com/v4/geocode/destinations

すべてのパラメータを JSON リクエスト本文またはヘッダーに POST リクエストの一部として渡します。次に例を示します。

curl -X POST -d '{
  "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

目的地を検索する場所は、次の 3 つの方法で指定できます。

  • 住所
  • プレイス ID
  • 緯度と経度の座標

住所で目的地を検索する

住所は非構造化文字列として指定できます。住所のジオコーディングでは、緯度と経度の座標や、住所を表さないその他の非構造化文字列は解決されません。このような文字列を使用するリクエストはサポートされておらず、エラー レスポンスや未指定の動作につながる可能性があります。サポートされていないクエリの例を次に示します。

クエリタイプ
緯度と経度の座標。代わりにロケーション クエリを使用してください。 "37.422131,-122.084801"
1 つのクエリに複数の場所、道路、都市の名前など、コンセプトや制約が多すぎる "Market Street San Francisco San Jose Airport"
Google マップに表示されない郵便住所要素 "C/O John Smith 123 Main Street"
"P.O. Box 13 San Francisco"
ビジネス、チェーン、カテゴリの名前と、これらのエンティティが利用できない場所の組み合わせ "Tesco near Dallas, Texas"
複数の解釈が可能な曖昧なクエリ "Charger drop-off"
現在使用されていない歴史的な名前 "Middlesex United Kingdom"
地理空間以外の要素またはインテント "How many boats are in Ventura Harbor?"
非公式の名前またはバニティ名 "The Jenga"
"The Helter Skelter"
大規模な政治的エンティティ(都市、州、国) "New York City"
"California"
"USA"
特定の住所のないルート "1st Ave., NYC, NY"
"I-95"
curl -X POST -d '{
  "addressQuery": {
    "addressQuery": "601 S Bernardo Ave, Sunnyvale, CA 94087, USA"
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

または postalAddressとして:

curl -X POST -d '{
  "addressQuery": {
    "address": {
      "addressLines": ["601 S Bernardo Ave"],
      "locality": "Sunnyvale",
      "postalCode": "94087",
      "administrativeArea": "CA",
      "regionCode": "US"
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

通常、postalAddress 形式は、HTML フォームでキャプチャされた住所コンポーネントを処理する場合に使用します。

プレイス ID で目的地を検索する

プレイス IDを指定して目的地を取得できます。

curl -X POST -d '{
  "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

サポートされているプレイス ID

目的地検索メソッドは、特定のナビゲーション可能な目的地を表すプレイス ID で最適に動作します。establishmentpoint_of_interestpremisestreet_addresssubpremise などのタイプのプレイス ID は通常 サポートされています。住所範囲(「10-20 Main St」など)から推測されるプレイス ID、特定の番号のないルートのセクション、プラスコードなど、個別の場所を表さないプレイス ID はサポートされていません。面積が広すぎる結果(「太平洋」など)のプレイス ID もサポートされていません。

Places API Autocomplete(新規)を目的地検索で使用する

互換性を確保するには、Places API Autocomplete (新規)を使用して、目的地検索で使用するプレイス ID を検索します。Autocomplete を使用する場合は、 結果をタイプでフィルタする必要があります。 includedPrimaryTypes パラメータを使用します。次の推奨フィルタを使用して Autocomplete によって返されるプレイス ID は、目的地検索でサポートされています。

"includedPrimaryTypes": [ "establishment", "point_of_interest", "premise", "street_address", "subpremise" ]

また、Autocomplete リクエストで フラグを include_pure_service_area_businesses に設定しないでください。true

場所で目的地を検索する

緯度と経度の座標を指定して目的地を検索できます。

curl -X POST -d '{
  "locationQuery": {
    "location": {
      "latitude": 37.37348780,
      "longitude": -122.05678064
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

OAuth を使用してリクエストを行う

Geocoding API v4 は、認証に OAuth 2.0 をサポートしています。Geocoding API で OAuth を使用するには、OAuth トークンに正しいスコープを割り当てる必要があります。 Geocoding API は、Destinations メソッドで使用する次のスコープをサポートしています。

  • https://www.googleapis.com/auth/maps-platform.geocode \- すべての Geocoding API メソッドで使用します。

また、すべての Geocoding API メソッドに汎用的な https://www.googleapis.com/auth/cloud-platform スコープを使用することもできます。このスコープは、すべてのメソッドへのアクセスを許可する汎用的なスコープであるため、開発時には便利ですが、本番環境では使用できません。

詳細と例については、Use OAuth を使用するをご覧ください。

目的地検索レスポンス

目的地検索レスポンスは、場所に関する豊富なハイパーローカル コンテキストを提供します。

目的地検索レスポンス内の PlaceView オブジェクト(primarycontainingPlaces のアイテム、landmarks など)は、フィールドを使用して場所のタイプを示します。

  • types: 場所のタイプを示す文字列の配列。
  • primaryType: 場所のプライマリ タイプを示す文字列。

typesprimaryType の両方に使用できる文字列値は、表 A と表 B が場所タイプ(新規)ページから取得されます。

このセクションでは、レスポンスの主要なフィールドについて説明します。すべてのレスポンス フィールドの詳細については、API リファレンスをご覧ください。

primary

リクエストのクエリで特定されたメインの場所。

containingPlaces

プライマリ デスティネーションが属するより大きなエンティティ(店舗を含むモールなど)。

subDestinations

プライマリ デスティネーション内のより具体的な場所(建物内のアパートなど)。

entrances

entrances[] 配列内のオブジェクトには次のフィールドがあります。

  • location

    場所への出入り口の位置を定義する単一の緯度と経度の座標ペア。

  • entrance_tags[]

    入り口の特徴を表す入り口タグの配列。 次の値がサポートされています。

    • "PREFERRED"

    この入り口から、返された 場所への物理的なアクセスが可能であることを示します。1 つの場所に複数の優先入り口を設定できます。入り口にこのタグがない場合、入り口は物理的に同じ建物にありますが、必ずしもその場所へのアクセスを提供しているとは限りません。

    たとえば、返された場所がストリップ モール内のレストランの場合、 "PREFERRED" の入り口はレストラン 自体に通じる入り口であり、返されたその他の入り口は、ストリップ モール内の他の入り口になります。 建物の入り口は、ストリップ モール内の他のレストランへの入り口などです。

    返された場所が建物自体の場合、"PREFERRED" の入り口は 建物の「メイン」部分に通じる入り口になります。たとえば、ショッピング センターでは、"PREFERRED" の入り口はメインのロビーエリアにアクセスできる入り口になりますが、建物の側面にあるストアにのみアクセスできる入り口は、"PREFERRED" の入り口にはなりません。

structureType

この場所が表す構造物のタイプ。

  • POINT

    ポイント ロケーション。

  • SECTION

    建物のサブセクション。

  • BUILDING

    建物。

  • GROUNDS

    大学のキャンパス、アパート、ショッピング モールなど、通常は複数の建物を含む広いエリア。

Geocoding レスポンスの navigationPoints フィールドには、その場所へのナビゲーションに役立つポイントのリストが含まれています。具体的には、その場所から、またはその場所への道路網でのルート設定の開始点または終了点として使用する必要があります。各ナビゲーション ポイントには次の値が含まれます。

  • navigationPointToken は、navigationPoints フィールドのコンテキスト情報を含むトークンです。このトークンをルーティング API と ナビゲーション API に送信して、アプリのルーティングと河川の操作性を向上させることができます。詳細については、 ナビゲーション ポイント トークンを使用したルート設定をご覧ください。
  • location には、ナビゲーション ポイントの緯度と経度の値が含まれます。 この場所は常に道路網に非常に近く、場所へのナビゲーションの理想的な停止点または出発地となります。このポイントは、その場所がある道路の側を明確に示すために、道路の中心線から意図的にわずかにオフセットされています。
  • travelModes は、ナビゲーション ポイントにアクセスできる移動手段のリストです。
    • "DRIVE" は、運転ルートに対応する移動手段です。
    • "WALK" は、徒歩経路に対応する移動手段です。
  • usages は、ナビゲーション ポイントでサポートされている使用方法のリストです。使用方法は次のとおりです。
    • "DROPOFF"
    • "PICKUP"
    • "PARKING"

arrivalSummary

到着を支援する AI による分析情報。AI による要約 をご覧ください

landmarks

ユーザーが目的地の周辺を把握するのに役立つ、近くの注目すべき場所。

回答の形式

SearchDestinations は、次の JSON 形式の SearchDestinationsResponse を返します。

{
  "destinations": [
    {
      "primary": {
        "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w",
        "displayName": {
          "text": "Arby's",
          "languageCode": "en"
        },
        "primaryType": "fast_food_restaurant",
        "types": [
          "fast_food_restaurant",
          "sandwich_shop",
          "deli",
          "meal_takeaway",
          "food_delivery",
          "american_restaurant",
          "restaurant",
          "food_store",
          "store",
          "food",
          "point_of_interest",
          "establishment"
        ],
        "formattedAddress": "Arby's, 601 S Bernardo Ave, Sunnyvale, CA 94087, USA",
        "postalAddress": {
          "regionCode": "US",
          "languageCode": "en",
          "postalCode": "94087",
          "administrativeArea": "CA",
          "locality": "Sunnyvale",
          "addressLines": [
            "601 S Bernardo Ave"
          ]
        },
        "structureType": "BUILDING",
        "location": {
          "latitude": 37.3734545,
          "longitude": -122.05693269999998
        },
        "displayPolygon": {
          "type": "Polygon",
          "coordinates": [
            [
              [
                -122.056930138027,
                37.3735253692531
              ],
              [
                -122.056960139391,
                37.3735372663597
              ],
              [
                -122.056994129366,
                37.3734828786847
              ],
              [
                -122.056969677395,
                37.3734731161089
              ],
              [
                -122.057061762447,
                37.3733261309656
              ],
              [
                -122.056979388817,
                37.3732935577128
              ],
              [
                -122.056798860285,
                37.3735818838642
              ],
              [
                -122.056875858081,
                37.3736121235316
              ],
              [
                -122.056930138027,
                37.3735253692531
              ]
            ]
          ]
        }
      },
      "containingPlaces": [
        {
          "place": "places/ChIJYfdAFum2j4ARIcL2tjME3Sw",
          "displayName": {
            "text": "Cherry Chase Shopping Center",
            "languageCode": "en"
          },
          "primaryType": "shopping_mall",
          "types": [
            "shopping_mall",
            "point_of_interest",
            "establishment"
          ],
          "formattedAddress": "Cherry Chase Shopping Center, 663 S Bernardo Ave, Sunnyvale, CA 94087, USA",
          "postalAddress": {
            "regionCode": "US",
            "languageCode": "en",
            "postalCode": "94087-1020",
            "administrativeArea": "CA",
            "locality": "Sunnyvale",
            "addressLines": [
              "663 S Bernardo Ave"
            ]
          },
          "structureType": "GROUNDS",
          "location": {
            "latitude": 37.3731231,
            "longitude": -122.0578211
          },
          "displayPolygon": {
            "type": "Polygon",
            "coordinates": [
              [
                [
                  -122.057112227103,
                  37.3714618008523
                ],
                [
                  -122.057076849821,
                  37.3715743611411
                ],
                [
                  -122.056963607756,
                  37.3719081793948
                ],
                [
                  -122.056865279559,
                  37.3722026053835
                ],
                [
                  -122.056687872374,
                  37.3727258358476
                ],
                [
                  -122.056580005889,
                  37.3730511370747
                ],
                [
                  -122.056498845827,
                  37.3732994782583
                ],
                [
                  -122.056338259713,
                  37.3737878663325
                ],
                [
                  -122.056618678291,
                  37.373887693582
                ],
                [
                  -122.056912102521,
                  37.3740010327191
                ],
                [
                  -122.057532418159,
                  37.3742476426462
                ],
                [
                  -122.057673926626,
                  37.3742441740031
                ],
                [
                  -122.057735663106,
                  37.3742328516943
                ],
                [
                  -122.057766531332,
                  37.3742220604378
                ],
                [
                  -122.057797572967,
                  37.37420520725
                ],
                [
                  -122.057828267759,
                  37.3741852342085
                ],
                [
                  -122.058060299297,
                  37.3740060842535
                ],
                [
                  -122.058199726081,
                  37.3737861673422
                ],
                [
                  -122.05836707267,
                  37.373524542556
                ],
                [
                  -122.058569622393,
                  37.3732018598683
                ],
                [
                  -122.0587638478,
                  37.3728890198039
                ],
                [
                  -122.058934661823,
                  37.3726036257774
                ],
                [
                  -122.059164956851,
                  37.3722498383629
                ],
                [
                  -122.058997784906,
                  37.3721804442035
                ],
                [
                  -122.057936479838,
                  37.3717605636234
                ],
                [
                  -122.057495827092,
                  37.3715860151634
                ],
                [
                  -122.057112227103,
                  37.3714618008523
                ]
              ]
            ]
          }
        }
      ],
      "landmarks": [
        {
          "place": {
            "place": "places/ChIJXXTe7Oi2j4ARoMTA-D6Hjpg",
            "displayName": {
              "text": "Chase Bank",
              "languageCode": "en"
            },
            "primaryType": "bank",
            "types": [
              "bank",
              "atm",
              "finance",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Chase Bank, 1234 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1234 W El Camino Real"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.373579,
              "longitude": -122.05752700000001
            }
          },
          "relationalDescription": {
            "text": "Near Chase Bank",
            "languageCode": "en"
          },
          "tags": [
            "ARRIVAL",
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 61.182193756103516,
          "travelDistanceMeters": 63.075645446777344
        },
        {
          "place": {
            "place": "places/ChIJteQ0Fum2j4ARGi3tqK4Zm14",
            "displayName": {
              "text": "Safeway",
              "languageCode": "en"
            },
            "primaryType": "grocery_store",
            "types": [
              "grocery_store",
              "butcher_shop",
              "florist",
              "deli",
              "supermarket",
              "bakery",
              "food_delivery",
              "market",
              "manufacturer",
              "food_store",
              "store",
              "food",
              "service",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Safeway, 639 S Bernardo Ave, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "639 S Bernardo Ave"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.3727912,
              "longitude": -122.0581172
            }
          },
          "relationalDescription": {
            "text": "Around the corner from Safeway",
            "languageCode": "en"
          },
          "tags": [
            "ARRIVAL",
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 158.65606689453125,
          "travelDistanceMeters": 131.1669921875
        },
        {
          "place": {
            "place": "places/ChIJu-PSYui2j4ARNiwOwBApGqk",
            "displayName": {
              "text": "Oil Changers",
              "languageCode": "en"
            },
            "types": [
              "car_repair",
              "service",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Oil Changers, 1240 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1240 W El Camino Real"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.3743054,
              "longitude": -122.0584272
            }
          },
          "relationalDescription": {
            "text": "Down the road from Oil Changers",
            "languageCode": "en"
          },
          "tags": [
            "ARRIVAL"
          ],
          "straightLineDistanceMeters": 140.52459716796875,
          "travelDistanceMeters": 143.24220275878906
        },
        {
          "place": {
            "place": "places/ChIJKRbl5oG3j4ARwuvPGUmtCj0",
            "displayName": {
              "text": "Apni Mandi Farmers Market Sunnyvale",
              "languageCode": "en"
            },
            "primaryType": "grocery_store",
            "types": [
              "grocery_store",
              "cake_shop",
              "supermarket",
              "asian_grocery_store",
              "indian_restaurant",
              "meal_takeaway",
              "bakery",
              "manufacturer",
              "wholesaler",
              "restaurant",
              "food_store",
              "store",
              "food",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Apni Mandi Farmers Market Sunnyvale, 1111 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087-1056",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1111 W El Camino Real"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.3737199,
              "longitude": -122.0522958
            }
          },
          "relationalDescription": {
            "text": "Near Apni Mandi Farmers Market Sunnyvale",
            "languageCode": "en"
          },
          "tags": [
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 410.37435913085938,
          "travelDistanceMeters": 479.49893188476562
        },
        {
          "place": {
            "place": "places/ChIJ8enMlui2j4AR2xXK5EHDhBs",
            "displayName": {
              "text": "Starbird Chicken",
              "languageCode": "en"
            },
            "primaryType": "chicken_restaurant",
            "types": [
              "chicken_restaurant",
              "fast_food_restaurant",
              "restaurant",
              "food",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Starbird Chicken, 1241 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087-1028",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1241 W El Camino Real"
              ]
            },
            "structureType": "BUILDING",
            "location": {
              "latitude": 37.3746764,
              "longitude": -122.05708860000001
            },
            "displayPolygon": {
              "coordinates": [
                [
                  [
                    -122.057003840785,
                    37.3747648209809
                  ],
                  [
                    -122.057136852459,
                    37.3747919153144
                  ],
                  [
                    -122.057205005705,
                    37.3745815131859
                  ],
                  [
                    -122.057071994114,
                    37.3745544186944
                  ],
                  [
                    -122.057003840785,
                    37.3747648209809
                  ]
                ]
              ],
              "type": "Polygon"
            }
          },
          "relationalDescription": {
            "text": "Near Starbird Chicken",
            "languageCode": "en"
          },
          "tags": [
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 87.348007202148438,
          "travelDistanceMeters": 214.08084106445312
        }
      ],
      "entrances": [
        {
          "location": {
            "latitude": 37.3735328,
            "longitude": -122.05694879999999
          },
          "tags": [
            "PREFERRED"
          ],
          "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
        }
      ],
      "navigationPoints": [
        {
          "navigationPointToken": "ChIJeMt61tqvQkARWT2716SDXsASEgljyy_n6LaPgBH9LoGUMNHjbBoSCWPLL-foto-AEf0ugZQw0eNsIhIJhf5y6ei2j4ARz7yBW5KAPI4",
          "location": {
            "latitude": 37.3738659,
            "longitude": -122.05693620000001
          },
          "travelModes": [
            "DRIVE",
            "WALK"
          ],
          "usages": [
            "PARKING"
          ]
        }
      ]
    }
  ]
}

必須パラメータ

  • API リクエストには、次の 3 つのパラメータのいずれかを含める必要があります。このパラメータは、目的地を検索する住所、場所、または場所を指定します。
    • addressQuery - 検索する住所。
    • place - 検索する場所のプレイス ID。
    • locationQuery - 検索する場所の緯度と経度の座標。
  • FieldMask

    レスポンス フィールド マスクを作成して、レスポンスで返すフィールドのリストを指定します。レスポンス フィールド マスクをメソッドに渡すには、URL パラメータ $fields または fields を使用するか、HTTP ヘッダー X-Goog-FieldMask を使用します。たとえば、次のリクエストでは、 プライマリ デスティネーションの入り口、ナビゲーション ポイント、プレイス ID のみが返されます。

      curl -X POST -d '{"place": "places/ChIJG3kh4hq6j4AR_XuFQnV0_t8"}' \
        -H "X-Goog-Api-Key: API_KEY" \
        -H "Content-Type: application/json" \
        -H "X-Goog-FieldMask: destinations.entrances,destinations.navigationPoints,destinations.primary.place" \
        https://geocode.googleapis.com/v4/geocode/destinations
      

    レスポンスで返されるフィールドのデフォルトのリストはありません。フィールド マスクを省略すると、メソッドからエラーが返されます。すべてのフィールドを返すには、フィールド マスクを * に設定します。詳細については、 返すフィールドの選択 をご覧ください。

オプション パラメータ

  • travelModes

    返す navigationPoints のタイプを指定します。 他の移動手段のナビゲーション ポイントは除外されます。` travelModes が設定されていない場合は、すべての移動手段のナビゲーション ポイントを返すことができます。

  • languageCode

    結果を返す言語。

    • サポートされている言語の 一覧をご覧ください。サポート対象の言語は頻繁に更新されるため、このリストで網羅されていない場合があります。
    • languageCode が指定されていない場合、API はデフォルトで en に設定されます。無効な言語コードを指定すると、API から INVALID_ARGUMENT エラーが返されます。
    • API は、ユーザーと地域住民の両方が読める住所を提供できるよう最善を尽くします。そのために、優先言語を遵守し、必要に応じて、ユーザーが読めるスクリプトに音訳された番地を返します。その他の 住所はすべて優先言語で返されます。住所コンポーネントは すべて同じ言語で返されます。この言語は最初の コンポーネントから選択されます。
    • 優先言語で名前が使用できない場合、API は最も近い一致を使用します。
    • 優先言語は、API が返す結果のセットと、結果が返される順序にわずかな影響を与えます。ジオコーダは、言語によって略語の解釈が異なります。 たとえば、道路の種類の略語や、ある言語では有効でも別の言語では有効でない同義語などです。
  • regionCode

    2 文字の CLDR コード値としての地域コード。デフォルト値はありません。ほとんどの CLDR コードは ISO 3166-1 コードと同じです。

    住所をジオコーディングする場合(順方向ジオコーディング)、このパラメータは、サービスから指定された地域への結果に影響を与える可能性がありますが、完全に制限するわけではありません。場所またはプレイスをジオコーディングする場合(リバース ジオコーディングまたはプレイス ジオコーディング)、このパラメータを使用して住所の形式を設定できます。いずれの場合も、このパラメータは適用される法律に基づいて結果に影響を与える可能性があります。

  • placeFilter

    検索の結果をフィルタして、建物である目的地のみを返す、明確な住所を持つ目的地のみを返すなど、要件を満たすことができます。locationQuery

    構造の粒度でフィルタする

    structureType フィルタを使用すると、クエリによって返される構造物の種類を指定できます。

    • 建物を分離する: "structureType": "BUILDING" を使用すると、地図上に建物の輪郭を表示したり、特定の構造物の詳細を取得したりできます。
    • 複合施設を理解する: "structureType": "GROUNDS" を使用すると、 プライマリ結果が敷地全体になります。これは、 大学のキャンパスやショッピング モールなどの広いエリアをクエリする場合に便利です。
    • ユニット/セクションに焦点を当てる: "structureType": "SECTION" を使用すると、建物内のセクションを特定できます。

    有用な住所を確保する

    すべての場所に明確な住所があるわけではありません。addressability フィルタ を使用すると、結果の住所の品質を管理できます。

    • 明確なプライマリ アドレスを必須にする: メインの目的地の結果に常に住所または名前が含まれるようにするには、"addressability": "PRIMARY" を使用します。これは、明確な 住所が不可欠なナビゲーションや表示に便利です。
    • サブデスティネーションの住所を許可する: プライマリ プレイスに住所がないが、そのユニットに住所がある場合(建物内のアパートなど)、"addressability": "WEAK" を使用すると、少なくともプライマリ プレイスまたはそのサブデスティネーションのいずれかに住所が含まれます。
    • 任意の結果: 住所の有無がユースケースに関係ない場合は、 "addressability": "ANY" を使用します。
    例: 住所指定可能な建物のフィルタリング
    curl -X POST -d '{
      "locationQuery": {
        "location": {
          "latitude": 37.37348780,
          "longitude": -122.05678064
        },
        "placeFilter": {
          "structureType": "BUILDING",
          "addressability": "PRIMARY"
        }
      },
      "languageCode": "en"
    }' \\
    -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \\
    -H "X-Goog-FieldMask: place" \\
    https://geocode.googleapis.com/v4/geocode/destinations