地点详情（新）

您可以通过使用地点 ID 并发出“地点详情（新）”请求，请求有关特定场所或地图注点的更多详细信息。地点详情（新）会返回有关指定地点的更全面信息，如完整地址、电话号码、用户评分和评价。

获取地点 ID 的方式有多种。您可以使用：

• 文本搜索（新）
• 附近搜索（新功能）
• 自动补全（新）

注意 ：地点详情（新）在 Places SDK for Android 3.3.0 及更高版本中提供。如需了解详情，请参阅选择 SDK 版本。

“地点详情（新）”请求

您可以通过调用 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);

您可以使用 CancellationToken 尝试取消对任何请求类（例如 FetchPlaceRequest）的请求。系统会尽最大努力取消。发出取消请求后，不会返回任何响应。发出取消令牌并不能保证特定请求会被取消，即使未返回响应，您仍可能需要为请求付费。

“地点详情（新）”响应

地点详情（新）以 Place 对象的形式返回数据，其中仅包含您使用字段列表请求的字段。地点数据结果不得为空，因此系统仅会返回包含数据的地点结果（例如，如果请求的地点没有照片，结果中将不会显示照片字段）。

如需访问数据字段，请调用相应的方法。例如，如需访问地点名称，请调用 getName()。

必需参数

FetchPlaceRequest 的必需参数为：

• 地点 ID

  用于唯一标识地点的文本标识符，从文本搜索（新）、附近搜索（新）或自动补全（新）返回。 如需详细了解地点 ID，请参阅地点 ID 概览。

• 字段列表

  请求地点时，您必须指定要返回的地点数据。为此，请传递 Place.Field 值的列表，指定要返回的数据。响应中没有默认的返回字段列表。

  字段列表是一种很好的设计做法，可确保您不会请求不必要的数据，这有助于避免不必要的处理时间和结算费用。此列表会影响每个请求的费用，因此是一项重要的考虑因素。如需了解详情，请参阅使用量和结算。

  指定以下一个或多个字段：

  • 以下字段会触发地点详情（仅 ID）SKU：

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

  • 以下字段会触发地点详情（仅限位置）SKU：

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

  • 以下字段会触发地点详情（基本）SKU：

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

  • 以下字段会触发地点详情（高级）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

  • 以下字段会触发地点详情（首选）SKU:：

    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

可选参数

FetchPlaceRequest 的可选参数 为：

• 区域代码

  用于设置响应格式的地区代码，以 双字符 CLDR 代码值的形式指定。没有默认值。

  如果响应中 Place.Field.ADDRESS 字段的国家/地区名称与 regionCode 匹配，则 Place.Field.ADDRESS 中省略国家/地区代码。

  除了某些明显的例外情况之外，大多数 CLDR 代码都与 ISO 3166-1 代码相同。例如，英国的 ccTLD 为“uk”(.co.uk)，而其 ISO 3166-1 代码为“gb”（专指“大不列颠及北爱尔兰联合王国”）。 该参数可能会影响根据适用法律的结果。

  如需设置地区代码参数，请在构建 FetchPlaceRequest 对象时调用 setRegionCode() 方法。

• 会话令牌

  会话令牌是用户生成的字符串，可将自动补全（新）调用作为“会话”进行跟踪。自动补全（新）使用会话令牌将用户自动补全搜索的查询和地点选择阶段归入不同的会话，以便进行结算。会话令牌会传递到“自动补全（新）”调用之后的“地点详情（新）”调用中。如需了解详情，请参阅会话令牌。

  如需设置会话令牌参数，请在构建 FetchPlaceRequest 对象时调用 setSessionToken() 方法。

地点详情示例

以下示例请求了纽约市帝国大厦的 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);