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?" |
| 非公式の名前または vanity name |
"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 で最適に機能します。通常、establishment
point_of_interest、premise、street_address、subpremise などのタイプのプレイス ID が
サポートされています。住所範囲（「10-20 Main St」など）、特定の番号のないルートのセクション、プラスコードなど、個別の場所を表さないプレイス 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 オブジェクト（primary、containingPlaces 内のアイテム、landmarks など）は、フィールドを使用して場所のタイプを示します。
types: 場所のタイプを示す文字列の配列。primaryType: 場所のプライマリ タイプを示す文字列。
types と primaryType の両方に使用できる文字列値は、表 A と表 B（プレイスタイプ（新規）ページ）から取得されます。
このセクションでは、主要なレスポンス フィールドについて説明します。すべてのレスポンス フィールドの詳細については、API リファレンスをご覧ください。
primary
リクエストのクエリで識別されたメインの場所。
containingPlaces
プライマリ デスティネーションが属するより大きなエンティティ（店舗を含むモールなど）。
subDestinations
プライマリ デスティネーション内のより具体的な場所（建物内のアパートなど）。
entrances
entrances[] 配列内のオブジェクトには、次のフィールドがあります。
location場所への出入り口の位置を定義する単一の緯度と経度の座標ペア。
entrance_tags[]入り口の特徴を表す入り口タグの配列。 次の値がサポートされています。
"PREFERRED"
この入り口から、返された 場所への物理的なアクセスが可能であることを示します。1 つの場所に複数の優先入り口を設定できます。入り口にこのタグがない場合、入り口は物理的に同じ建物にありますが、必ずしもその場所へのアクセスを提供しているとは限りません。
たとえば、返された場所がストリップ モール内のレストランの場合、
"PREFERRED"の入り口はレストラン 自体に通じる入り口であり、返された他の入り口は、ストリップ モール内の他のレストランへの入り口など、建物の他の入り口になります。返された場所が建物自体の場合、
"PREFERRED"の入り口は 建物の「メイン」部分に通じる入り口になります。たとえば、ショッピング センターでは、"PREFERRED"の入り口はメインのロビーエリアにアクセスできる入り口ですが、建物の側面にあるストアにのみアクセスできる入り口は、"PREFERRED"の入り口ではありません。streetViewThumbnailとstreetViewAnnotationストリートビュー Static API のパラメータ。これらの場所に関連する画像を表示できます。これらの フィールドの詳細についてはこちらをご覧ください。
structureType
この場所が表す構造物のタイプ。
POINTポイントの場所。
SECTION建物のサブセクション。
BUILDING建物。
GROUNDS通常、大学のキャンパス、アパート、ショッピング モールなど、複数の建物を含む広いエリア。
navigationPoints
Geocoding レスポンス内の navigationPoints フィールドには、その場所への移動に役立つポイントのリストが含まれています。具体的には、その場所から、またはその場所への道路網でのルート設定の開始点または終了点として使用する必要があります。
各ナビゲーション ポイントには次の値が含まれます。
navigationPointTokenは、navigationPointsフィールドのコンテキスト情報を含むトークンです。このトークンをルーティング API と ナビゲーション API に送信して、アプリのルーティングと河川の操作性を向上させることができます。詳細については、 ナビゲーション ポイント トークンを使用したルート設定をご覧ください。locationには、ナビゲーション ポイントの緯度と経度の値が含まれます。 この場所は常に道路網に非常に近く、その場所への移動の理想的な停止点または出発地となります。このポイントは、その場所がある道路の側を明確に示すために、道路の中心線から意図的にわずかにオフセットされています。travelModesは、ナビゲーション ポイントにアクセスできる移動手段のリストです。"DRIVE"は、運転ルートに対応する移動手段です。"WALK"は、徒歩経路に対応する移動手段です。
usagesは、ナビゲーション ポイントでサポートされている用途のリストです。用途は次のとおりです。"DROPOFF""PICKUP""PARKING"
送迎の場合は、移動手段が DRIVE で、用途が PICKUP または DROPOFF のナビゲーション ポイントを使用します。送迎ポイントが利用できない場合は、上位の運転ナビゲーション ポイントを使用します。
streetViewThumbnailとentranceAnnotationは、 ストリートビュー Static API のパラメータを提供し、 これらの場所に関連する画像を表示できます。これらの フィールドの詳細についてはこちらをご覧ください。
altitude_metersには、WGS-84 楕円体に対するナビゲーション ポイントの高度（メートル単位）が含まれます。道路セグメントが垂直方向に積み重ねられている場合は、altitude_metersフィールドを使用して、システムが移動する最適な道路セグメントを選択します。
landmarks
ユーザーが目的地の周辺を把握するのに役立つ、近くの注目すべき場所。
arrivalSummary
到着を支援する AI を活用した分析情報。AI を活用した サマリーをご覧ください。
parkingOptions
詳細な駐車場情報。
回答の形式
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 つのパラメータのうち 1 つを含める必要があります。このパラメータは、目的地を検索する住所、場所、または位置情報を指定します。
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 - 建物の分離: