Place Details（新規）

プラットフォームを選択: Android iOS JavaScript ウェブサービス

特定の施設やスポットに関する詳細をリクエストするには、そのプレイス ID を使用して Place Details (New) リクエストを実行します。Place Details（新版）は、指定された場所に関する包括的な情報を返します。たとえば、完全な住所、電話番号、ユーザーの評価、レビューなどです。

プレイス ID を取得する方法はいくつかあります。次を使用できます。

Place Details (New) リクエスト

プレイス詳細をリクエストするには、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（新版）レスポンス

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

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

必須パラメータ

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

オプション パラメータ

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

  • 地域コード

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

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

    CLDR コードのほとんどは ISO 3166-1 コードと同一ですが、いくつか注意が必要な例外もあります。たとえば、英国の ccTLD は「uk」（.co.uk）ですが、その ISO 3166-1 コードは「gb」（厳密には「United Kingdom of Great Britain and Northern Ireland」のエンティティ）です。このパラメータは、適用される法律に基づいて結果に影響する可能性があります。

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

  • セッション トークン

    セッション トークンは、Autocomplete（新規）の呼び出しを「セッション」として追跡するユーザー作成の文字列です。Autocomplete（新規）は、セッション トークンを使用して、ユーザーのオートコンプリート検索のクエリと場所の選択フェーズを、請求処理のために個別のセッションにグループ化します。セッション トークンは、Autocomplete（新規）呼び出しに続く Place Details（新規）呼び出しに渡されます。詳細については、セッション トークンをご覧ください。

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

Place Details の例

次の例では、ニューヨーク市のエンパイア ステート ビルの ID、DISPLAY_NAME、FORMATTED_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.DISPLAY_NAME, Place.Field.FORMATTED_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);