Place Details(新規)

特定の施設やスポットに関する詳細情報をリクエストするには、プレイス ID を使用し、Place Details(New)リクエストを作成します。Place Details(New)は、完全な住所、電話番号、ユーザーの評価、クチコミなど、指定された場所に関するより包括的な情報を返します。

プレイス ID はさまざまな方法で取得できます。次を使用できます。

Place Details(New)リクエスト

Place Details をリクエストするには、PlacesClient.fetchPlace() を呼び出し、プレイス IDフィールド リストを含む FetchPlaceRequest オブジェクトのほか、任意のパラメータを渡します。

// Define a place ID.
final String placeId = "INSERT_PLACE_ID_HERE";

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList("INSERT_PLACE_FIELDS_HERE");

// Construct a request object, passing the place ID and field list.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);

// Pass the request object and make the request
Task<FetchPlaceResponse> placeTask = placesClient.fetchPlace(request);

Place Details(New)レスポンス

Place Details(New)は、Place オブジェクトの形式でデータを返します。このオブジェクトには、フィールド リストを使用してリクエストしたフィールドのみが含まれています。プレイスデータの結果は空にできないため、データを含むプレイスの結果のみが返されます(たとえば、リクエストされた場所に写真がない場合、写真フィールドは結果に含まれません)。

データ フィールドにアクセスするには、対応するメソッドを呼び出します。たとえば、場所の名前にアクセスするには、getName() を呼び出します。

必須パラメータ

FetchPlaceRequest の必須パラメータは次のとおりです。

省略可能なパラメータ

FetchPlaceRequestオプション パラメータ は次のとおりです。

  • 地域コード

    レスポンスのフォーマットに使用するリージョン コード。 2 文字の CLDR コード値で指定します。デフォルト値はありません。

    レスポンスの Place.Field.ADDRESS フィールドの国名が regionCode と一致する場合、Place.Field.ADDRESS から国コードが省略されます。

    ほとんどの CLDR コードは ISO 3166-1 コードと同一ですが、いくつか注意が必要な例外もあります。たとえば、英国の ccTLD は「uk」(.co.uk)ですが、ISO 3166-1 コードは「gb」(厳密には「グレート ブリテンおよび北アイルランド連合王国」の法人を意味します)です。パラメータは、適用される法律に基づいて結果に影響を与える可能性があります。

    地域コード パラメータを設定するには、FetchPlaceRequest オブジェクトの作成時に setRegionCode() メソッドを呼び出します。

  • セッション トークン

    セッション トークンは、オートコンプリート(新機能)の呼び出しを「セッション」としてトラッキングする、ユーザー生成の文字列です。Autocomplete(新機能)は、セッション トークンを使用して、ユーザーによるオートコンプリート検索におけるクエリと場所の選択フェーズを個別のセッションにグループ化し、請求処理に使用します。セッション トークンは、Autocomplete(New)呼び出しに続く Place Details(New)呼び出しに渡されます。詳細については、セッション トークンをご覧ください。

    セッション トークン パラメータを設定するには、FetchPlaceRequest オブジェクトの作成時に setSessionToken() メソッドを呼び出します。

Place Details の例

次の例では、ニューヨーク市のエンパイア ステート ビルの ID フィールド、NAME フィールド、ADDRESS フィールドをリクエストします。

// Define a place ID.
final String placeId = "ChIJaXQRs6lZwokRY6EFpJnhNNE";

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME, Place.Field.ADDRESS);

// Construct a request object, passing the place ID and field list.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);

// Pass the request object and make the request
Task<FetchPlaceResponse> placeTask = placesClient.fetchPlace(request);