Place Details（新規）

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

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

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

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（新規）レスポンス

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

データフィールドにアクセスするには、対応するメソッドを呼び出します。たとえば、地名にアクセスするには、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」です（技術的には「グレート ブリテンおよび北アイルランド連合王国」のエンティティ用）。このパラメータは、適用される法律に基づいて結果に影響する可能性があります。

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

  • セッション トークン

    セッション トークンは、Autocomplete（新規）呼び出しを「セッション」として追跡するユーザー作成の文字列です。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);