迁移到地点详情(新)

Places SDK for Android 支持现有的 地点详情。 如果您熟悉现有的 Places SDK for Android, 新版“地点详情” 进行以下更改:

以下部分介绍了其他更改。

访问新的地点类型

每个地点可以有一个或多个关联的 type 值。通过 Places SDK for Android 3.3.0 及更高版本新增了许多类型, 值。如需查看完整列表,请参阅 展开的地点类型

Place.getPlaceTypes() 方法将类型值作为字符串值列表返回。返回的值 取决于您的 Places SDK for Android 版本:

  • Places SDK for Android(新):返回由 地点类型(新)页面中显示的表 A 和表 B,包括 版本 3.3.0 中添加的新增地点类型

  • Places SDK for Android:返回由 Place.Types,其中不包括版本 3.3.0 中添加的新类型 及之后的版本。

查看地点评价

Places SDK for Android(新)添加了 Review 类,其中包含对地点的评论。Place 对象最多可包含 共 5 条评价。

Review 类还可以包含提供方说明和作者提供方说明。如果 在应用中显示评价时,还必须显示提供方说明 或作者署名。有关详情,请参阅显示 审核

有关详情,请参阅 归因

访问地点名称语言代码

现有的 Place.getName() 方法会返回包含地点名称的文本字符串。要填充 Place 对象,您必须将 Place.Field.NAME 添加到 地点详情请求的字段列表。

Place 对象现在包含名称字符串的语言代码。接收者 使用语言代码填充 Place 对象,您必须执行以下操作:

  1. 在请求的字段列表中添加 Place.Field.NAME。此值 将响应配置为在 Place 对象。

  2. 调用 PlacesClient.fetchPlace()。 “PlacesClient.findCurrentPlace()”不支持语言代码字段。

  3. 使用 Place.getNameLanguageCode() 方法,用于访问 Place 对象中的语言代码字段。

设置地区代码

Places SDK for Android(新)将地区代码请求参数添加到 地点详情。地区代码用于确定响应的格式,该响应指定为 两个字符的 CLDR 代码 值。此参数还会影响搜索结果。那里 没有默认值。您必须启用新 SDK 才能设置地区代码。

如果响应中地址字段的国家/地区名称与区域匹配 代码,则地址中会忽略国家/地区代码。

除某些明显不同之外,大多数 CLDR 代码与 ISO 3166-1 代码完全相同。 例如,英国的 ccTLD 为“uk”(.co.uk) 同时获得 ISO 3166-1 认证, 代码为“gb”(技术上适用于“大不列颠联合王国”实体 和北爱尔兰”)。该参数可能会影响结果 法律。

示例请求

有关完整示例,请参阅 地点详情(新)