はじめに
Nearby Search（新版） リクエストは、1 つ以上の場所タイプを受け取り、指定された地域内の一致する場所のリストを返します。1 つ以上のデータタイプを指定するフィールド マスクが必要です。Nearby Search（新版）は POST リクエストのみをサポートしています。
API Explorer を使用すると、ライブ リクエストを作成して、API と API オプションに慣れることができます。
インタラクティブな デモを試して、地図に表示される Nearby Search（新版）の結果を確認してください。
Nearby Search（新版）リクエスト
Nearby Search（新版）リクエストは、次の形式の URL への HTTP POST リクエストです。
https://places.googleapis.com/v1/places:searchNearby
すべてのパラメータを JSON リクエスト本文またはヘッダーで POST リクエストの一部として渡します。次に例を示します。
curl -X POST -d '{
"includedTypes": ["restaurant"],
"maxResultCount": 10,
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965},
"radius": 500.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName" \
https://places.googleapis.com/v1/places:searchNearby
Nearby Search（新版）レスポンス
Nearby Search（新版）は、レスポンスとして JSON オブジェクトを返します。レスポンスの説明:
places配列には、一致するすべての場所が含まれます。- 配列内の各場所は
Placeオブジェクトで表されます。Placeオブジェクトには、1 つの 場所に関する詳細情報が含まれます。 - リクエストで渡された FieldMask は、
Placeオブジェクトで返されるフィールドのリストを指定します。
完全な JSON オブジェクトは次の形式です。
{
"places": [
{
object (Place)
}
]
}必須パラメータ
-
FieldMask
レスポンス フィールド マスクを作成して、レスポンスで返すフィールドのリストを指定します。 レスポンス フィールド マスクを メソッドに渡すには、URL パラメータ
$fieldsまたはfieldsを使用するか、HTTP ヘッダーX-Goog-FieldMaskを使用します。レスポンスで返されるフィールドのデフォルトのリストはありません。 フィールド マスクを省略すると、メソッドからエラーが返されます。フィールド マスキングは、不要なデータをリクエストしないようにするための優れた設計手法です。これにより、不要な処理時間や 請求を回避できます。
返す場所のデータタイプのカンマ区切りのリストを指定します。たとえば、 場所の表示名と住所を取得する場合などです。
X-Goog-FieldMask: places.displayName,places.formattedAddress
*を使用してすべてのフィールドを取得します。X-Goog-FieldMask: *
次のフィールドを 1 つ以上指定します。
次のフィールドは、Nearby Search Pro SKU をトリガーします。
places.accessibilityOptions
places.addressComponents
places.addressDescriptor*
places.adrFormatAddress
places.attributions
places.businessStatus
places.consumerAlert
places.containingPlaces
places.displayName
places.formattedAddress
places.googleMapsLinks
places.googleMapsTypeLabel
places.googleMapsUri
places.iconBackgroundColor
places.iconMaskBaseUri
places.id
places.location
places.name**
places.movedPlace
places.movedPlaceId
places.openingDate
places.photos
places.plusCode
places.postalAddress
places.primaryType
places.primaryTypeDisplayName
places.pureServiceAreaBusiness
places.shortFormattedAddress
places.subDestinations
places.timeZone
places.types
places.utcOffsetMinutes
places.viewport
* 住所記述子は、インドのお客様は一般的にご利用いただけますが、他の地域では試験運用版です。
**places.nameフィールドには、場所の リソース名 がplaces/PLACE_IDの形式で含まれます。places.displayNameを使用して、場所のテキスト名にアクセスします。フィールドとそれに関連付けられた SKU の完全なリストについては、場所のデータフィールド（新版）をご覧ください。
次のフィールドは、Nearby Search Enterprise SKU をトリガーします。
places.currentOpeningHours
places.currentSecondaryOpeningHours
places.internationalPhoneNumber
places.nationalPhoneNumber
places.priceLevel
places.priceRange
places.rating
places.regularOpeningHours
places.regularSecondaryOpeningHours
places.transitStation
places.userRatingCount
places.websiteUriフィールドとそれに関連付けられた SKU の完全なリストについては、場所のデータフィールド（新版）をご覧ください。
次のフィールドは、Nearby Search Enterprise + Atmosphere SKU をトリガーします。
places.allowsDogs
places.curbsidePickup
places.delivery
places.dineIn
places.editorialSummary
places.evChargeAmenitySummary
places.evChargeOptions
places.fuelOptions
places.generativeSummary
places.goodForChildren
places.goodForGroups
places.goodForWatchingSports
places.liveMusic
places.menuForChildren
places.neighborhoodSummary
places.parkingOptions
places.paymentOptions
places.outdoorSeating
places.reservable
places.restroom
places.reviews
places.reviewSummary
routingSummaries*
places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
* テキスト検索 と Nearby Search のみフィールドとそれに関連付けられた SKU の完全なリストについては、場所のデータフィールド（新版）をご覧ください。
-
locationRestriction
検索する地域を円で指定します。円は中心点と半径（メートル単位）で定義されます。 半径は 0.0 ～ 50000.0 の範囲で指定してください。デフォルトの半径は 0.0 です。リクエストで 0.0 より大きい値に設定する必要があります。
次に例を示します。
"locationRestriction": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } }
オプション パラメータ
-
includeFutureOpeningBusinesses
trueの場合、今後オープンする予定のビジネスを返します。デフォルトはfalseです。
ビジネスのステータスを取得するには、リクエスト フィールド マスクにplaces.businessStatusを含めます。ビジネスの開業予定日を取得するには、リクエスト フィールド マスクにplaces.openingDateを含めます。 -
includedTypes/excludedTypes、includedPrimaryTypes/excludedPrimaryTypes
検索結果のフィルタに使用するタイプ テーブル A のタイプのリストを指定できます。タイプ制限カテゴリごとに最大 50 個のタイプを指定できます。
1 つの場所に関連付けることができるタイプ テーブル A のプライマリ タイプは 1 つのみ です。たとえば、プライマリ タイプは
"mexican_restaurant"や"steak_house"になります。includedPrimaryTypesとexcludedPrimaryTypesを使用して、場所のプライマリ タイプで結果をフィルタします。1 つの場所に関連付けることができるタイプ テーブル A のタイプ値は複数 になります。たとえば、レストランには次のタイプがあります:
"seafood_restaurant","restaurant","food","point_of_interest","establishment".includedTypesとexcludedTypesを使用して、場所に関連付けられたタイプのリストで結果をフィルタします。一般的なプライマリ タイプ (たとえば
"restaurant"や"hotel") を指定すると、レスポンスには指定したプライマリ タイプよりも具体的なプライマリ タイプを持つ場所が含まれることがあります。たとえば、プライマリ タイプ"restaurant"を含めるように指定します。レスポンスには、プライマリ タイプが"restaurant"の場所が含まれるだけでなく、より具体的な プライマリ タイプを持つ場所も含まれることがあります。たとえば、"chinese_restaurant"や"seafood_restaurant"などです。複数のタイプ制限を指定して検索した場合、すべての制限を満たす場所 のみが返されます。たとえば、
{"includedTypes": ["restaurant"], "excludedPrimaryTypes": ["steak_house"]}を指定した場合、 返される場所は"restaurant"関連のサービスを提供しますが、主に"steak_house"として営業していません。includedTypes
検索する場所タイプのカンマ区切りのリスト テーブル A。このパラメータを省略すると、すべてのタイプの場所が返されます。
excludedTypes
検索から除外するタイプ テーブル A の場所タイプのカンマ区切りのリスト。
リクエストで
includedTypes（"school"など）とexcludedTypes（"primary_school"など）の両方を指定すると、レスポンスには"school"として分類されるが"primary_school"として分類されない場所が含まれます。レスポンスには、少なくとも 1 つ のincludedTypesに一致し、いずれにも一致しないexcludedTypes場所が含まれます。`
includedTypes` と `excludedTypes` の両方にタイプが表示されるなど、競合するタイプがある場合は、`INVALID_REQUEST` エラーが返されます。includedPrimaryTypes
検索に含める テーブル A のプライマリ場所タイプのカンマ区切りのリスト。
excludedPrimaryTypes
検索から除外するタイプ テーブル A のプライマリ場所タイプのカンマ区切りのリスト
`
includedPrimaryTypes` と `excludedPrimaryTypes` の両方にタイプが表示されるなど、競合するプライマリ タイプがある場合は、`INVALID_ARGUMENT` エラーが返されます。 -
languageCode
結果を返す言語。
- サポートされている言語の一覧をご覧ください。サポート対象の言語は頻繁に更新されるため、このリストで網羅されていない場合があります。
languageCodeが指定されていない場合、API はデフォルトでenになります。無効な言語コードを指定すると、API からINVALID_ARGUMENTエラーが返されます。- API は、ユーザーと 地域住民の両方が読める番地を提供できるよう最善を尽くします。そのために、優先言語を遵守し、必要に応じて、ユーザーが読めるスクリプトに音訳した番地を現地の言語で返します。その他の住所はすべて優先言語で返されます。住所の構成要素は すべて同じ言語で返されます。この言語は最初の構成要素から選択されます。
- 優先言語で名前を表示できない場合、API は最も近い言語を使用します。
- 優先言語は、API が返す結果のセットと、結果が返される順序にわずかな影響を与えます。ジオコーダは、言語によって略語 の解釈が異なります。たとえば、道路の種類の略語や、ある言語では有効でも別の言語では有効でない同義語 などです。
-
maxResultCount
返す場所の結果の最大数を指定します。1 ～ 20（デフォルト）の範囲で指定してください。
-
rankPreference
使用するランキングのタイプ。このパラメータを省略すると、結果は人気度順にランク付けされます。 次のいずれかになります。
POPULARITY（デフォルト）結果を人気度に基づいて並べ替えます。DISTANCE指定された場所からの距離の昇順で結果を並べ替えます。
-
regionCode
レスポンスのフォーマットに使用する地域コード。 2 文字の CLDR コード値として指定します。デフォルト値はありません。
レスポンスの
formattedAddressフィールドの国名がregionCodeと一致する場合、formattedAddressから国コードが省略されます。 このパラメータは、常に国名を含むadrFormatAddressと、国名を含まないshortFormattedAddressには影響しません。ほとんどの CLDR コードは ISO 3166-1 コードと同一ですが、 いくつか注意が必要な例外もあります。たとえば、英国の ccTLD は 「uk」（.co.uk）ですが、ISO 3166-1 コードは「gb」（厳密には「グレートブリテンおよび北アイルランド連合王国」のエンティティ用）です。 このパラメータは、適用される法律に基づいて結果に影響を与える可能性があります。
Nearby Search（新版）の例
1 つのタイプの場所を検索する
次の例は、circle で定義された半径 500 メートル以内のすべてのレストランの表示名に対する Nearby Search（新版）リクエストを示しています。
curl -X POST -d '{
"includedTypes": ["restaurant"],
"maxResultCount": 10,
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965},
"radius": 500.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName" \
https://places.googleapis.com/v1/places:searchNearby
X-Goog-FieldMask ヘッダーは、レスポンスに places.displayName というデータフィールドが含まれることを指定します。レスポンス
は次の形式になります。
{ "places": [ { "displayName": { "text": "La Mar Cocina Peruana", "languageCode": "en" } }, { "displayName": { "text": "Kokkari Estiatorio", "languageCode": "en" } }, { "displayName": { "text": "Harborview Restaurant & Bar", "languageCode": "en" } }, ... }
追加情報を返すには、フィールド マスクにデータタイプを追加します。
たとえば、places.formattedAddress,places.types,places.websiteUri を追加して、レストランの住所、タイプ、ウェブアドレスをレスポンスに含めます。
curl -X POST -d '{
"includedTypes": ["restaurant"],
"maxResultCount": 10,
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965},
"radius": 500.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.formattedAddress,places.types,places.websiteUri" \
https://places.googleapis.com/v1/places:searchNearby
応答 は次の形式になります。
{ "places": [ { "types": [ "seafood_restaurant", "restaurant", "food", "point_of_interest", "establishment" ], "formattedAddress": "PIER 1 1/2 The Embarcadero N, San Francisco, CA 94105, USA", "websiteUri": "http://lamarsf.com/", "displayName": { "text": "La Mar Cocina Peruana", "languageCode": "en" } }, { "types": [ "greek_restaurant", "meal_takeaway", "restaurant", "food", "point_of_interest", "establishment" ], "formattedAddress": "200 Jackson St, San Francisco, CA 94111, USA", "websiteUri": "https://kokkari.com/", "displayName": { "text": "Kokkari Estiatorio", "languageCode": "en" } }, ... }
複数のタイプの場所を検索する
次の例は、指定された circle の半径 1,000 メートル以内のすべてのコンビニエンス ストアと酒屋の表示名に対する Nearby Search（新版）リクエストを示しています。
curl -X POST -d '{
"includedTypes": ["liquor_store", "convenience_store"],
"maxResultCount": 10,
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965
},
"radius": 1000.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.primaryType,places.types" \
https://places.googleapis.com/v1/places:searchNearby
places.primaryType と places.types をフィールド マスクに追加して、レスポンスに各場所のタイプ情報を含めることで、結果から適切な場所を選択しやすくしています。
検索から場所タイプを除外する
次の例は、タイプが "school" のすべての場所に対する Nearby Search（新版）リクエストを示しています。タイプが "primary_school" の場所はすべて除外され、結果は距離順にランク付けされます。
curl -X POST -d '{
"includedTypes": ["school"],
"excludedTypes": ["primary_school"],
"maxResultCount": 10,
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965
},
"radius": 1000.0
}
},
"rankPreference": "DISTANCE"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName" \
https://places.googleapis.com/v1/places:searchNearby
地域周辺のすべての場所を検索し、距離順にランク付けする
次の例は、サンフランシスコのダウンタウンのポイント周辺の場所に対する Nearby Search（新版）リクエストを示しています。この例では、rankPreference パラメータを含めて、結果を距離順にランク付けします。
curl -X POST -d '{
"maxResultCount": 10,
"rankPreference": "DISTANCE",
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965
},
"radius": 1000.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName" \
https://places.googleapis.com/v1/places:searchNearby
住所記述子を取得する
住所記述子は、近くの ランドマークや含まれる地域など、場所の位置に関するリレーショナル情報を提供します。
次の例は、サンノゼのショッピング モール周辺の場所に対する Nearby Search（新版）リクエストを示しています。この例では、フィールド マスクに addressDescriptors
を含めます。
curl -X POST -d '{
"maxResultCount": 5,
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.321328,
"longitude": -121.946275
},"radius": 1000
}
},
"includedTypes": ["restaurant", "cafe"],
"excludedTypes": [],
"rankPreference":"POPULARITY"
}' \
-H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.addressDescriptor" \
https://places.googleapis.com/v1/places:searchNearby
レスポンスには、リクエストで指定された場所、近くのランドマークとその場所からの 距離のリスト、地域とその場所との 包含関係のリストが含まれます。
{ "places": [ { "displayName": { "text": "Westfield Valley Fair", "languageCode": "en" }, "addressDescriptor": { "landmarks": [ { "name": "places/ChIJ62_oCR7Lj4AR_MGWkSPotD4", "placeId": "ChIJ62_oCR7Lj4AR_MGWkSPotD4", "displayName": { "text": "Nordstrom", "languageCode": "en" }, "types": [ "clothing_store", "department_store", "establishment", "point_of_interest", "shoe_store", "store" ], "straightLineDistanceMeters": 114.76984, "travelDistanceMeters": 114.261856 }, { "name": "places/ChIJgexMlR_Lj4ARiKCKuhNnjn0", "placeId": "ChIJgexMlR_Lj4ARiKCKuhNnjn0", "displayName": { "text": "Valley Fair Mall Eyexam of CA", "languageCode": "en" }, "types": [ "establishment", "health", "point_of_interest" ], "straightLineDistanceMeters": 131.62566, "travelDistanceMeters": 237.33253 }, { "name": "places/ChIJWWIlNx7Lj4ARpe1E0ob-_GI", "placeId": "ChIJWWIlNx7Lj4ARpe1E0ob-_GI", "displayName": { "text": "Din Tai Fung", "languageCode": "en" }, "types": [ "establishment", "food", "point_of_interest", "restaurant" ], "straightLineDistanceMeters": 110.0775, "travelDistanceMeters": 171.41951 }, { "name": "places/ChIJwyfPQx7Lj4AR7bYI2A2Yc54", "placeId": "ChIJwyfPQx7Lj4AR7bYI2A2Yc54", "displayName": { "text": "Abercrombie & Fitch", "languageCode": "en" }, "types": [ "clothing_store", "establishment", "point_of_interest", "shoe_store", "store" ], "spatialRelationship": "DOWN_THE_ROAD", "straightLineDistanceMeters": 53.620117, "travelDistanceMeters": 2.4578214 }, { "name": "places/ChIJpycNQx7Lj4ARjhXw3PrM_kU", "placeId": "ChIJpycNQx7Lj4ARjhXw3PrM_kU", "displayName": { "text": "Hollister Co.", "languageCode": "en" }, "types": [ "clothing_store", "establishment", "point_of_interest", "shoe_store", "store" ], "spatialRelationship": "DOWN_THE_ROAD", "straightLineDistanceMeters": 56.53726, "travelDistanceMeters": 15.418246 } ], "areas": [ { "name": "places/ChIJb3F-EB7Lj4ARnHApQ_Hu1gI", "placeId": "ChIJb3F-EB7Lj4ARnHApQ_Hu1gI", "displayName": { "text": "Westfield Valley Fair", "languageCode": "en" }, "containment": "WITHIN" }, { "name": "places/ChIJXYuykB_Lj4AR1Ot8nU5q26Q", "placeId": "ChIJXYuykB_Lj4AR1Ot8nU5q26Q", "displayName": { "text": "Valley Fair", "languageCode": "en" }, "containment": "WITHIN" }, { "name": "places/ChIJtYoUX2DLj4ARKoKOb1G0CpM", "placeId": "ChIJtYoUX2DLj4ARKoKOb1G0CpM", "displayName": { "text": "Central San Jose", "languageCode": "en" }, "containment": "OUTSKIRTS" } ] } }, /.../ }
今後オープンするビジネスを探す
次の例は、アイダホ州ニューメドウズで今後オープンするビジネスに対する Nearby Search（新版）リクエストを示しています。
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.businessStatus,places.openingDate" \
-d '{
"includeFutureOpeningBusinesses": true,
"maxResultCount": 20,
"locationRestriction": {
"circle": {
"center": {"latitude": 44.9755100, "longitude": -116.2842180},
"radius": 20
}
},
"rankPreference": "DISTANCE"
}' \
"https://places.googleapis.com/v1/places:searchNearby"
レスポンスには、今後オープンするビジネスと、そのビジネスのステータス と開業予定日が含まれます。
{ "places": [ { "id": "ChIJp1-VoKWJplQRMz8g-7Wa3Do", "businessStatus": "FUTURE_OPENING", "displayName": { "text": "Roberts Greenhouse and Tree Farm", "languageCode": "en" }, "openingDate": { "year": 2026, "month": 4, "day": 15 } } ] }
交通機関の駅の情報を取得する
Nearby Search（新版）を使用すると、指定された場所から特定の半径内の交通機関の駅に関する情報を取得できます。レスポンスの本文には、駅名、提携する交通機関、駅に乗り入れている路線など、駅に関する情報が含まれます。また、レスポンスには、交通機関の駅の情報を表示するために使用できる車両アイコンと色が含まれます。
次の例は、マンハッタンのミッドタウンから 50 メートル以内の交通機関の駅に対するリクエストを示しています。
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.transitStation" \
-d '{
"includedTypes": ["transit_station"],
"locationRestriction": {
"circle": {
"center": {"latitude": 40.754851, "longitude": -73.984164},
"radius": 50.0
}
}
}' \
"https://places.googleapis.com/v1/places:searchNearby"
レスポンスの本文には、半径内の各駅の情報、駅に乗り入れている路線、その停留所で交通機関が発行したアラート、出発情報が含まれます。
{ "places": [ { "id": "ChIJH2EstKpZwokRCwZtYyMd5Fg", "displayName": { "text": "6 Av/W 41 St", "languageCode": "en" }, "transitStation": { "displayName": { "text": "6 Av/W 41 St", "languageCode": "en" }, "agencies": [ { "displayName": { "text": "ShortLine Hudson", "languageCode": "en" }, "url": "https://www.coachusa.com/", "lines": [ { "id": "ChIJSQlbzvPwwokRolrIA-Kuh6o", "vehicleType": "BUS", "displayName": { "text": "200 - Northern District – Nanuet", "languageCode": "en" }, "shortDisplayName": { "text": "ShortLine Hudson", "languageCode": "en" }, "textColor": "#000000", "backgroundColor": "#ED60A3", "vehicleIcon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/bus2.svg" } } ] }, { "displayName": { "text": "MTA New York City Transit", "languageCode": "en" }, "url": "http://www.mta.info/", "lines": [ { "id": "ChIJjUrj7PBewokR3O3S2JVpBrI", "vehicleType": "SUBWAY", "displayName": { "text": "E Train (8 Av Local)", "languageCode": "en" }, "shortDisplayName": { "text": "E Line", "languageCode": "en" }, "textColor": "#FFFFFF", "backgroundColor": "#0039A6", "url": "https://www.mta.info/schedules/subway/e-train", "icon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/E.svg", "nameIncluded": true }, "vehicleIcon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg" } }, ... ] }, "stops": [ { "id": "ChIJvRnquapZwokRdUOyVwNGbe8", "displayName": { "text": "6 Av/W 41 St", "languageCode": "en" }, "location": { "latitude": 40.754509, "longitude": -73.984216500000016 }, "wheelchairAccessibleEntrance": true } ], "departureBoards": [ { "displayType": "DIRECTION_CENTRIC", "rows": [ { "departures": [ { "timedDeparture": { "scheduledTime": "2026-05-15T22:29:51Z", "timingType": "SCHEDULED" }, "originallyScheduledStopId": "ChIJvRnquapZwokRdUOyVwNGbe8", "lineId": "ChIJA1aFyaZfwokRkO5869M6UXk" } ] }, { "departures": [ { "timedDeparture": { "scheduledTime": "2026-05-15T22:33:55Z", "timingType": "SCHEDULED" }, "originallyScheduledStopId": "ChIJvRnquapZwokRdUOyVwNGbe8", "lineId": "ChIJj3iCEwJfwokRZE2Qtnm4pPI" } ] }, ... ] } ] } }, ... { { "id": "ChIJPyq6TZBZwokRdGoiJ5Iq_hE", "vehicleType": "BUS", "displayName": { "text": "W 44 St - South Ferry", "languageCode": "en" }, "shortDisplayName": { "text": "M55", "languageCode": "en" }, "textColor": "#FFFFFF", "backgroundColor": "#1D59B3", "vehicleIcon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/bus2.svg" }, "alerts": [ { "effect": "OTHER", "texts": [ { "headline": { "text": "Information", "languageCode": "en" }, "summary": { "text": "Northbound M20 and M55 stop on State St at Bridge St is closed; use the temporary stop on State St before the intersection instead", "languageCode": "en" }, "fullDescription": { "text": "See a map of the new stop location. What's happening? Construction", "languageCode": "en" } } ], "detailsUrls": [ { "url": "https://www.mta.info/" } ], "cause": "OTHER_CAUSE", "startTime": "2025-04-02T04:00:00Z", "endTime": "2026-06-15T00:00:00Z", "attribution": { "link": { "text": "www.mta.info", "url": "https://www.mta.info/" } }, "createTime": "2026-05-15T22:32:00Z", "severityLevel": "INFO" } ] }, ... } ... }
入り口とナビゲーション ポイントを取得する
目的地の入り口とナビゲーション ポイントをリクエストできます。入り口は、場所の出入り口（空港やショッピング モールの異なるゲートなど）を定義します。ナビゲーション ポイントは、ナビゲーションを終了する道路沿いの場所を定義します。これは、ユーザーを道路の正しい側や特定の降車場所に誘導するのに役立ちます。
ナビゲーション ポイントは navigationPointToken を返します。このトークンを Navigation SDK（Android または iOS で利用可能）または Routes API に渡して、ドライバーを特定の場所に誘導できます。詳細については、ナビゲーション ポイント トークンをご覧ください。
次の例は、フィールド マスクに entrances と navigationPoints を含む Nearby Search（新版）リクエストを示しています。
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.entrances,places.navigationPoints" \
-d '{
"includedTypes": ["airport"],
"maxResultCount": 1,
"locationRestriction": {
"circle": {
"center": {"latitude": 37.6193, "longitude": -122.3816},
"radius": 1000.0
}
}
}' \
"https://places.googleapis.com/v1/places:searchNearby"
レスポンスには、場所の入り口とナビゲーション ポイントが含まれます。
{ "places": [ { "id": "ChIJVVVVVYx3j4ARP-3NGldc8qQ", "displayName": { "text": "San Francisco International Airport", "languageCode": "en" }, "entrances": [ { "location": { "latitude": 37.6172154, "longitude": -122.3839724 } }, { "location": { "latitude": 37.6174073, "longitude": -122.384196 } }, ... ], "navigationPoints": [ { "navigationPointToken": "ChIJoioBjMLOQkAR0A3yH_eYXsA...", "displayName": { "text": "International Terminal Departures Level", "languageCode": "en" }, "location": { "latitude": 37.6153121, "longitude": -122.3900833 }, "travelModes": ["WALK"] }, { "navigationPointToken": "ChIJy5JKws_OQkAROx0jNN2YXsA...", "displayName": { "text": "Domestic Garage - SFO Short Term Parking", "languageCode": "en" }, "location": { "latitude": 37.6157153, "longitude": -122.3885012 }, "travelModes": ["DRIVE", "WALK"], "usages": ["PARKING"] }, ... ] } ] }
試してみよう:
API Explorer を使用すると、サンプル リクエストを作成して、API と API オプションに慣れることができます。
ページの右側にある API アイコン api を選択します。
必要に応じて、リクエスト パラメータを編集します。
[実行] ボタンを選択します。ダイアログで、リクエストの送信に使用するアカウント を選択します。
API Explorer パネルで、全画面表示アイコン fullscreen を選択して、API Explorer ウィンドウを拡大します。