Nearby Search（新規）リクエストは、検索する地域を円で指定します。円は、円の中心点の緯度と経度の座標、および半径（メートル単位）で定義されます。リクエストは、指定された検索エリア内の一致する場所のリストを返します。各場所は
Place
オブジェクトで表されます。
デフォルトでは、レスポンスには検索エリア内のすべてのタイプの場所が含まれます。 必要に応じて、レスポンスに明示的に含めるか除外する場所タイプのリストを指定して、レスポンスをフィルタできます。たとえば、レスポンスに「レストラン」、「パン屋」、「カフェ」タイプの場所のみを含めるように指定したり、「学校」タイプの場所をすべて除外したりできます。
Nearby Search（新規）リクエスト
`PlacesClient.searchNearby` を呼び出して Nearby Search（新規）リクエストを作成し、
PlacesClient.searchNearbyを渡します。SearchNearbyRequest
SearchNearbyRequest オブジェクトは、リクエストに必要なパラメータとオプション パラメータをすべて指定します。必須パラメータは次のとおりです。
Placeオブジェクトで返されるフィールドのリスト。フィールド マスクとも呼ばれます。フィールド リストで 1 つ以上のフィールドを指定しない場合、またはフィールド リストを省略した場合、呼び出しはエラーを返します。- 検索エリアのロケーション制限。緯度と経度のペアと半径の値（メートル単位）で定義されます。
この Nearby Search リクエストの例では、レスポンス Place オブジェクト
に、場所フィールド Place.Field.ID と Place.Field.DISPLAY_NAME が検索結果の各 Place オブジェクトに
含まれるように指定しています。また、レスポンスをフィルタして、「レストラン」と「カフェ」タイプの場所のみを返し、「ピザ レストラン」と「アメリカ料理レストラン」タイプの場所を除外します。
// Define a list of fields to include in the response for each returned place. final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.DISPLAY_NAME); // Define the search area as a 1000 meter diameter circle in New York, NY. LatLng center = new LatLng(40.7580, -73.9855); CircularBounds circle = CircularBounds.newInstance(center, /* radius = */ 1000); // Define a list of types to include. final List<String> includedTypes = Arrays.asList("restaurant", "cafe"); // Define a list of types to exclude. final List<String> excludedTypes = Arrays.asList("pizza_restaurant", "american_restaurant"); // Use the builder to create a SearchNearbyRequest object. final SearchNearbyRequest searchNearbyRequest = SearchNearbyRequest.builder(/* location restriction = */ circle, placeFields) .setIncludedTypes(includedTypes) .setExcludedTypes(excludedTypes) .setMaxResultCount(10) .build()); // Call placesClient.searchNearby() to perform the search. // Define a response handler to process the returned List of Place objects. placesClient.searchNearby(searchNearbyRequest) .addOnSuccessListener(response -> { List<Place> places = response.getPlaces(); });
Nearby Search（新規）レスポンス
The
SearchNearbyResponse
クラスは、検索リクエストからのレスポンスを表します。SearchNearbyResponse オブジェクトには次のものが含まれます。
- 一致するすべての場所を表す
Placeオブジェクトのリスト。一致する場所ごとに 1 つのPlaceオブジェクトがあります。 - 各
Placeオブジェクトには、リクエストで渡されたフィールド リスト で定義されたフィールドのみが含まれます。
たとえば、リクエストでフィールド リストを次のように定義したとします。
// Define a list of fields to include in the response for each returned place. final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME);
このフィールド リストは、レスポンス内の各 Place オブジェクトに、一致する各場所のプレイス ID と名前のみが含まれることを意味します。その後、Place.getId()
メソッドと Place.getName() メソッドを使用して、各 Place オブジェクトのこれらのフィールドにアクセスできます。
Place オブジェクトのデータにアクセスするその他の例については、Place
オブジェクトのデータ フィールドにアクセスするをご覧ください。
必須パラメータ
SearchNearbyRequest
オブジェクトを使用して、検索に必要なパラメータを指定します。
フィールド リスト
Place Details をリクエストする場合は、場所の
Placeオブジェクトで返すデータをフィールド マスクとして指定する必要があります。フィールド マスクを定義するには、Place.Fieldの値の配列をSearchNearbyRequestオブジェクトに渡します。フィールド マスキングは、不要なデータをリクエストしないようにするための優れた設計手法です。これにより、不要な処理時間や課金が発生するのを防ぐことができます。次のフィールドを 1 つ以上指定します。
次のフィールドは、Nearby Search Pro SKU をトリガーします。
Place.Field.ADDRESS_COMPONENTS
Place.Field.BUSINESS_STATUS
Place.Field.ADDRESS
Place.Field.DISPLAY_NAME>*
* 非推奨のPlace.Field.NAMEの代わりに使用します。
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL*
* 非推奨のPlace.Field.ICON_URLの代わりに使用します。
Place.Field.ID
Place.Field.LAT_LNG
Place.Field.PHOTO_METADATAS
Place.Field.PLUS_CODE
Place.Field.PRIMARY_TYPE
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
Place.Field.RESOURCE_NAME
Place.Field.TYPES
Place.Field.UTC_OFFSET
Place.Field.VIEWPORT
Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCEフィールドとそれに関連付けられた SKU の完全なリストについては、Place Data Fields（新規）をご覧ください。
次のフィールドは、Nearby Search Enterprise SKU をトリガーします。
Place.Field.CURRENT_OPENING_HOURS
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER*
* 非推奨のPlace.Field.PHONE_NUMBERの代わりに使用します。
Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
Place.Field.PRICE_LEVEL
Place.Field.RATING
Place.Field.SECONDARY_OPENING_HOURS
Place.Field.USER_RATING_COUNT*
* 非推奨のPlace.Field.USER_RATINGS_TOTALの代わりに使用します。
Place.Field.WEBSITE_URIフィールドとそれに関連付けられた SKU の完全なリストについては、Place Data Fields（新規）をご覧ください。
次のフィールドは、Nearby Search Enterprise Plus SKU をトリガーします。
Place.Field.ALLOWS_DOGS
Place.Field.CURBSIDE_PICKUP
Place.Field.DELIVERY
Place.Field.DINE_IN
Place.Field.EDITORIAL_SUMMARY
Place.Field.EV_CHARGE_OPTIONS
Place.Field.FUEL_OPTIONS
Place.Field.GOOD_FOR_CHILDREN
Place.Field.GOOD_FOR_GROUPS
Place.Field.GOOD_FOR_WATCHING_SPORTS
Place.Field.LIVE_MUSIC
Place.Field.MENU_FOR_CHILDREN
Place.Field.OUTDOOR_SEATING
Place.Field.PARKING_OPTIONS
Place.Field.PAYMENT_OPTIONS
Place.Field.RESERVABLE
Place.Field.RESTROOM
Place.Field.REVIEWS
Place.Field.SERVES_BEER
Place.Field.SERVES_BREAKFAST
Place.Field.SERVES_BRUNCH
Place.Field.SERVES_COCKTAILS
Place.Field.SERVES_COFFEE
Place.Field.SERVES_DESSERT
Place.Field.SERVES_DINNER
Place.Field.SERVES_LUNCH
Place.Field.SERVES_VEGETARIAN_FOOD
Place.Field.SERVES_WINE
Place.Field.TAKEOUTフィールドとそれに関連付けられた SKU の完全なリストについては、Place Data Fields（新規）をご覧ください。
フィールド リスト パラメータを設定するには、
setPlaceFields()メソッドをSearchNearbyRequestオブジェクトを作成するときに呼び出します。次の例では、リクエストによって返される
PlaceオブジェクトにPlace.Field.IDとPlace.Field.DISPLAY_NAMEフィールドが含まれるように指定する、2 つのフィールド値のリストを定義しています。
// Define a list of fields to include in the response for each returned place. final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.DISPLAY_NAME);
ロケーションの制限
検索する地域を定義する
LocationRestrictionオブジェクト。円で指定され、 中心点と半径（メートル単位）で定義されます。半径は 0.0 より大きく 50000.0 以下にする必要があります。半径が小さすぎると、レスポンスとしてZERO_RESULTSが返されます。ロケーション制限パラメータを設定するには、
setLocationRestriction()メソッドをSearchNearbyRequestオブジェクトを作成するときに呼び出します。
オプション パラメータ
SearchNearbyRequest
オブジェクトを使用して、検索のオプション パラメータを指定します。
-
タイプとプライマリ タイプ
タイプ テーブル 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 = Arrays.asList("restaurant")とexcludedPrimaryTypes = Arrays.asList("steak_house")を指定した場合、返される場所は"restaurant"関連のサービスを提供しますが、主に"steak_house"として運営されていません。includedTypesとexcludedTypesの使用方法の例については、 Nearby Search（新規）リクエストをご覧ください。含まれるタイプ
検索するタイプ テーブル A の場所タイプのリスト。 このパラメータを省略すると、すべてのタイプの場所が返されます。
含まれるタイプ パラメータを設定するには、
setIncludedTypes()メソッドをSearchNearbyRequestオブジェクトを作成するときに呼び出します。除外されるタイプ
検索から除外するタイプ テーブル A の場所タイプのリスト。
リクエストで
includedTypes（"school"など）とexcludedTypes（"primary_school"など）の両方を指定すると、レスポンスには"school"として分類されるが"primary_school"として分類されない場所が含まれます。レスポンスには、少なくとも 1 つ のincludedTypesに一致し、いずれにも 一致しないexcludedTypesが含まれます。`
includedTypes` と `excludedTypes` の両方にタイプが表示されるなど、競合するタイプがある場合は、`INVALID_REQUEST` エラーが返されます。除外されるタイプ パラメータを設定するには、
setExcludedTypes()メソッドを呼び出すときにSearchNearbyRequestオブジェクトを作成します。含まれるプライマリ タイプ
検索に含めるタイプ テーブル A のプライマリ場所タイプのリスト。
含まれるプライマリ タイプ パラメータを設定するには、
setIncludedPrimaryTypes()メソッドをSearchNearbyRequestオブジェクトを作成するときに呼び出します。除外されるプライマリ タイプ
検索から除外するタイプ テーブル A のプライマリ場所タイプのリスト。
`
includedPrimaryTypes` と `excludedPrimaryTypes` の両方にタイプが表示されるなど、競合するプライマリ タイプがある場合は、`INVALID_ARGUMENT` エラーが返されます。除外されるプライマリ タイプ パラメータを設定するには、
setExcludedPrimaryTypes()メソッドをSearchNearbyRequestオブジェクトを作成するときに呼び出します。 -
最大結果数
返す場所の結果の最大数を指定します。1 ～ 20（デフォルト）の範囲で指定する必要があります。
最大結果数パラメータを設定するには、
setMaxResultCount()メソッドをSearchNearbyRequestオブジェクトを作成するときに呼び出します。 -
ランクの設定
使用するランキングのタイプ。このパラメータを省略すると、結果は人気度順にランク付けされます。 次のいずれかになります。
POPULARITY（デフォルト）人気度に基づいて結果を並べ替えます。DISTANCE指定された場所からの距離に応じて結果を昇順で並べ替えます。
ランクの設定パラメータを設定するには、
setRankPreference()メソッドを呼び出すときにSearchNearbyRequestオブジェクトを作成します。 -
地域コード
レスポンスのフォーマットに使用する地域コード。 2 文字の CLDR コード値として指定します。デフォルト値はありません。
レスポンスの
FORMATTED_ADDRESSフィールドの国名がregionCodeと一致する場合、FORMATTED_ADDRESSから国コードが省略されます。ほとんどの CLDR コードは ISO 3166-1 コードと同一ですが、 いくつか注意が必要な例外もあります。たとえば、イギリスの ccTLD は 「uk」（.co.uk）ですが、ISO 3166-1 コードは「gb」（厳密には 「グレートブリテンおよび北アイルランド連合王国」のエンティティ）です。 このパラメータは、適用される法律に基づいて結果に影響を与える可能性があります。
地域コード パラメータを設定するには、
setRegionCode()メソッドを呼び出すときにSearchNearbyRequestオブジェクトを作成します。
アプリに属性を表示する
アプリで
PlacesClientから取得した情報（写真やクチコミなど）を表示する場合は、必要な属性も表示する必要があります。
詳細については、Places SDK for Android のポリシーをご覧ください。