Nearby Search (New) リクエストは、円として指定された検索対象の地域を入力として受け取ります。この地域は、円の中心点の緯度と経度の座標と、半径（メートル単位）で定義されます。このリクエストは、指定された検索エリア内の一致するプレイスのリストを返します。各プレイスは Place オブジェクトで表されます。
デフォルトでは、検索エリア内のすべてのタイプのプレイスがレスポンスに含まれます。必要に応じて、レスポンスに明示的に含める場所タイプまたは除外する場所タイプのリストを指定して、レスポンスをフィルタリングできます。たとえば、レスポンスに「レストラン」、「ベーカリー」、「カフェ」の種類の場所のみを含めるように指定したり、「学校」の種類の場所をすべて除外したりできます。
Nearby Search（新規）リクエスト
PlacesClient.searchNearby を呼び出し、リクエスト パラメータを定義する SearchNearbyRequest オブジェクトを渡して、Nearby Search（新規）リクエストを実行します。
SearchNearbyRequest オブジェクトには、リクエストの必須パラメータとオプション パラメータをすべて指定します。必須パラメータには次のものがあります。
Placeオブジェクトで返されるフィールドのリスト（フィールドマスクとも呼ばれます）。フィールドリストでフィールドを 1 つ以上指定しない場合、またはフィールドリストを省略した場合、呼び出しはエラーを返します。- 検索エリアの位置制限。緯度と経度のペアと半径値（メートル単位）で定義されます。
この近くの検索リクエストの例では、レスポンスの Place オブジェクトに、検索結果の各 Place オブジェクトの場所フィールド Place.Field.ID と Place.Field.DISPLAY_NAME が含まれるように指定しています。また、レスポンスが「restaurant」と「cafe」のタイプのみの場所を返すようにフィルタし、「pizza_restaurant」と「american_restaurant」のタイプの場所を除外します。
// 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（新版）のレスポンス
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オブジェクトで指定する必要があります。フィールド マスクを定義するには、Place.FieldからSearchNearbyRequestオブジェクトに値の配列を渡します。フィールド マスキングは、不要なデータをリクエストしないようにするための優れた設計手法です。これにより、不要な処理時間と課金が発生するのを防ぐことができます。次のフィールドを 1 つ以上指定します。
次のフィールドは、Nearby Search (Basic) SKU をトリガーします。
Place.Field.ADDRESS_COMPONENTS、Place.Field.BUSINESS_STATUS、Place.Field.ADDRESS、Place.Field.ICON_BACKGROUND_COLOR、Place.Field.ICON_URL、Place.Field.LAT_LNG、Place.Field.PHOTO_METADATAS、Place.Field.PLUS_CODE、Place.Field.PRIMARY_TYPE、Place.Field.PRIMARY_TYPE_DISPLAY_NAME、Place.Field.ID、Place.Field.NAME、Place.Field.TYPES、Place.Field.UTC_OFFSET、Place.Field.VIEWPORT、Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE次のフィールドは、Nearby Search (Advanced) SKU をトリガーします。
Place.Field.CURRENT_OPENING_HOURS、Place.Field.CURRENT_SECONDARY_OPENING_HOURS、Place.Field.INTERNATIONAL_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.WEBSITE_URI、
次のフィールドは、Nearby Search (Preferred) 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
フィールドリスト パラメータを設定するには、
SearchNearbyRequestオブジェクトを作成するときにsetPlaceFields()メソッドを呼び出します。次の例では、2 つのフィールド値のリストを定義して、リクエストから返された
PlaceオブジェクトにPlace.Field.IDフィールドとPlace.Field.DISPLAY_NAMEフィールドが含まれていることを指定します。
// 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 より大きく、50, 000.0 以下にする必要があります。半径が小さすぎると、レスポンスとしてZERO_RESULTSが返されます。位置情報の制限パラメータを設定するには、
SearchNearbyRequestオブジェクトを作成するときにsetLocationRestriction()メソッドを呼び出します。
オプション パラメータ
SearchNearbyRequest オブジェクトを使用して、検索のオプション パラメータを指定します。
-
タイプとプライマリ タイプ
検索結果のフィルタに使用するタイプ表 A のタイプから、タイプのリストを指定できます。各タイプの制限カテゴリで指定できるタイプは最大 50 個です。
プレイスには、関連付けられている 表 A のタイプから1 つのプライマリ タイプのみを指定できます。たとえば、プライマリ タイプは
"mexican_restaurant"または"steak_house"です。includedPrimaryTypesとexcludedPrimaryTypesを使用して、場所のメインタイプで結果をフィルタします。場所には、表 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 の検索対象の場所タイプのリスト。このパラメータを省略すると、すべてのタイプの場所が返されます。
含まれるタイプのパラメータを設定するには、
SearchNearbyRequestオブジェクトを作成するときにsetIncludedTypes()メソッドを呼び出します。除外されるタイプ
検索から除外する表 A の場所タイプのリスト。
リクエストで
includedTypes（"school"など）とexcludedTypes（"primary_school"など）の両方を指定すると、"school"に分類される場所がレスポンスに含まれますが、"primary_school"に分類される場所は含まれません。レスポンスには、includedTypesの少なくとも 1 つとexcludedTypesのいずれにも一致しない場所が含まれます。includedTypesとexcludedTypesの両方に出現する型など、競合する型がある場合、INVALID_REQUESTエラーが返されます。除外タイプ パラメータを設定するには、
SearchNearbyRequestオブジェクトを作成するときにsetExcludedTypes()メソッドを呼び出します。含まれるプライマリ タイプ
検索に含める表 A の主要なプレイスタイプのリスト。
含まれるプライマリ タイプ パラメータを設定するには、
SearchNearbyRequestオブジェクトを作成するときにsetIncludedPrimaryTypes()メソッドを呼び出します。除外されるプライマリ タイプ
検索から除外する表 A のプライマリ プレイスタイプのリスト。
includedPrimaryTypesとexcludedPrimaryTypesの両方に表示されるタイプなど、競合するプライマリ タイプがある場合、INVALID_ARGUMENTエラーが返されます。除外するプライマリ タイプ パラメータを設定するには、
SearchNearbyRequestオブジェクトを作成するときにsetExcludedPrimaryTypes()メソッドを呼び出します。 -
最大結果数
返される場所の結果の最大数を指定します。1 ～ 20（デフォルト）の値にする必要があります。
最大結果数パラメータを設定するには、
SearchNearbyRequestオブジェクトを作成するときにsetMaxResultCount()メソッドを呼び出します。 -
ランクの設定
使用するランキングのタイプ。このパラメータを省略すると、検索結果は人気度順にランク付けされます。次のいずれかになります。
POPULARITY（デフォルト）人気度に基づいて結果を並べ替えます。DISTANCE指定された場所からの距離が近い順に結果を昇順で並べ替えます。
ランクの優先度パラメータを設定するには、
SearchNearbyRequestオブジェクトを作成するときにsetRankPreference()メソッドを呼び出します。 -
地域コード
レスポンスのフォーマットに使用される地域コード。 2 文字の CLDR コード値で指定します。デフォルト値はありません。
レスポンスの
FORMATTED_ADDRESSフィールドの国名がregionCodeと一致する場合、国コードはFORMATTED_ADDRESSから省略されます。ほとんどの CLDR コードは ISO 3166-1 コードと同一ですが、いくつか注意が必要な例外もあります。たとえば、英国の ccTLD は「uk」（.co.uk）ですが、その ISO 3166-1 コードは「gb」（厳密には「United Kingdom of Great Britain and Northern Ireland」のエンティティ）です。このパラメータは、適用される法律に基づいて結果に影響する可能性があります。
地域コード パラメータを設定するには、
SearchNearbyRequestオブジェクトを作成するときにsetRegionCode()メソッドを呼び出します。
アプリに属性を表示する
アプリに PlacesClient から取得した情報（写真やクチコミなど）を表示する場合は、必要な帰属情報も表示する必要があります。
詳しくは、Places SDK for Android のポリシーをご覧ください。