地点详情（新）

请选择平台： Android iOS JavaScript 网络服务

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

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

“地点详情（新）”请求

您可以通过调用 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 对象的形式返回数据，其中仅包含您使用字段列表请求的字段。地点数据结果不能为空，因此系统只会返回包含数据的地点结果（例如，如果请求的地点没有照片，则结果中不会显示“照片”字段）。

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

必需参数

FetchPlaceRequest 的必需参数如下：

可选参数

FetchPlaceRequest 的可选参数如下：

  • 区域代码

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

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

    除了某些明显的例外情况之外，大多数 CLDR 代码都与 ISO 3166-1 代码完全一致。例如，英国的 ccTLD 为“uk”（.co.uk），但其 ISO 3166-1 代码为“gb”（从技术层面来说，适用于“大不列颠及北爱尔兰联合王国”实体）。 此参数可能会根据适用法律影响结果。

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

  • 会话令牌

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

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

地点详情示例

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