Place Details（新規）

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

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

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

• テキスト検索（新版）
• Nearby Search（新版）
• 予測入力（新）

注: Place Details（新版）は Places SDK で利用できます 。詳しくは、SDK を選択する バージョンをご覧ください。

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

注: PlacesClient の初期化について詳しくは、以下をご覧ください。 Places API クライアントを初期化します。

CancellationToken を使用すると、 任意のリクエスト クラス（例: FetchPlaceRequest）。キャンセルはベスト エフォートで行われます。 キャンセル リクエストが発行されると、レスポンスは返されません。 キャンセル トークンを発行しても、特定のリクエストが リクエストがキャンセルされ、請求が行われなかった場合でも、 レスポンスが返されます。

Place Details（新）レスポンス

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

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

必須パラメータ

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

• プレイス ID

  場所を一意に識別するテキスト表記の ID。 テキスト検索（新版） Nearby Search（新版） 予測入力（新版）。 プレイス ID について詳しくは、 プレイス ID の概要をご覧ください。

• フィールド リスト

  場所をリクエストするときは、返す場所データを指定する必要があります。宛先 これを行うには、Place.Field 値のリストを渡します。 返すデータを指定します。デフォルトのリストはありません。 レスポンスで返されるフィールド。

  フィールド リストを設計することをおすすめします。これにより、 保存し、不要な処理時間を回避して、 表示することもできます。このリストは、 これは各リクエストの費用に影響するためです。詳細については、次をご覧ください: 用途 とお支払いをご覧ください。

  次のフィールドを 1 つ以上指定します。

  • 以下のフィールドで Place Details（ID のみ）SKU がトリガーされます。

    Place.Field.ID、Place.Field.NAME、Place.Field.PHOTO_METADATAS

  • 次のフィールドで Place Details（場所のみ）SKU がトリガーされます。

    Place.Field.ADDRESS_COMPONENTS, Place.Field.ADDRESS, Place.Field.LAT_LNG, Place.Field.PLUS_CODE, Place.Field.TYPES, Place.Field.VIEWPORT

  • 以下のフィールドで Place Details（Basic）SKU がトリガーされます。

    Place.Field.BUSINESS_STATUS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_URL, Place.Field.UTC_OFFSET, Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE

  • 以下のフィールドで Place Details（Advanced）SKU がトリガーされます。

    Place.Field.CURRENT_OPENING_HOURS, Place.Field.SECONDARY_OPENING_HOURS, Place.Field.PHONE_NUMBER, Place.Field.PRICE_LEVEL, Place.Field.RATING, Place.Field.OPENING_HOURS, Place.Field.USER_RATINGS_TOTAL, Place.Field.WEBSITE_URI

  • 以下のフィールドで Place Details（Preferred）SKU:

    <ph type="x-smartling-placeholder"></ph> Place.Field.CURBSIDE_PICKUP, Place.Field.DELIVERY, Place.Field.DINE_IN, Place.Field.EDITORIAL_SUMMARY, Place.Field.RESERVABLE, Place.Field.REVIEWS, Place.Field.SERVES_BEER, Place.Field.SERVES_BREAKFAST, Place.Field.SERVES_BRUNCH, Place.Field.SERVES_DINNER, Place.Field.SERVES_LUNCH, Place.Field.SERVES_VEGETARIAN_FOOD, Place.Field.SERVES_WINE, Place.Field.TAKEOUT

オプション パラメータ

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 の例

次の例では、リクエストの 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);