Place Details(新規)

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

特定の施設や場所に関する詳細情報をリクエストできます 関心を ID を作成し、 Place Details (New) リクエスト。 Place Details(新版)では、より包括的に 指定された場所に関する情報(詳細な住所、電話番号など) レビューの数、ユーザーの評価、レビューです。

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

Place Details (New) リクエスト

場所の詳細をリクエストするには、 PlacesClient.fetchPlace() そして FetchPlaceRequest プレイス IDフィールド リストを含むオブジェクト、 任意のオプション パラメータとして:

// 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 次のとおりです。

オプション パラメータ

P-MAX の省略可能なパラメータ FetchPlaceRequest 次のとおりです。

  • 地域コード

    レスポンスのフォーマットに使用される地域コード。 <ph type="x-smartling-placeholder"></ph> 2 文字の CLDR コードの値。デフォルト値はありません。

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

    ほとんどの CLDR コードは ISO 3166-1 コードと同一です。 いくつか例外がありますたとえば、英国の ccTLD は 「uk」(.co.uk)、ISO 3166-1 コードは「gb」(技術的には、 「グレート ブリテンおよび北アイルランド連合王国」という当事者である必要があります)。 このパラメータは、適用される法律に基づき、結果に影響する場合があります。

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

  • セッション トークン

    セッション トークンはユーザーが生成した文字列で、 予測入力(新版)の通話は「セッション」として表示されます。予測入力(新版)ではセッション トークンを使用して ユーザーの予測入力検索のクエリと場所選択のフェーズを個別のセッションにグループ化する 請求に使用されます。セッション トークンが Place Details に渡される(新) 。詳細については、次をご覧ください: セッション トークン

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

Place Details の例

次の例では、リクエストの IDNAMEADDRESS の各フィールドを ニューヨーク市のエンパイア ステート ビル。

// 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);