Places SDK for Android 支持现有的 地点详情。 如果您熟悉现有的 Places SDK for Android, 新版“地点详情” 进行以下更改:
使用新的价格模式。有关所有 API 的价格信息,请参阅 Places SDK for Android (新)。
您必须通过调用
Places.initializeWithNewPlacesApiEnabled()
方法。有关选择 Places API 服务的更多信息,请参阅 设置您的 Google Cloud 项目。必须选择字段遮盖。您必须指定要返回的字段 。没有返回字段的默认列表。如果省略 那么这些方法会返回错误。
以下部分介绍了其他更改。
访问新的地点类型
每个地点可以有一个或多个关联的 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
对象,您必须执行以下操作:
在请求的字段列表中添加
Place.Field.NAME
。此值 将响应配置为在Place
对象。调用
PlacesClient.fetchPlace()
。 “PlacesClient.findCurrentPlace()
”不支持语言代码字段。使用
Place.getNameLanguageCode()
方法,用于访问Place
对象中的语言代码字段。
设置地区代码
Places SDK for Android(新)将地区代码请求参数添加到 地点详情。地区代码用于确定响应的格式,该响应指定为 两个字符的 CLDR 代码 值。此参数还会影响搜索结果。那里 没有默认值。您必须启用新 SDK 才能设置地区代码。
如果响应中地址字段的国家/地区名称与区域匹配 代码,则地址中会忽略国家/地区代码。
除某些明显不同之外,大多数 CLDR 代码与 ISO 3166-1 代码完全相同。 例如,英国的 ccTLD 为“uk”(.co.uk) 同时获得 ISO 3166-1 认证, 代码为“gb”(技术上适用于“大不列颠联合王国”实体 和北爱尔兰”)。该参数可能会影响结果 法律。
示例请求
有关完整示例,请参阅 地点详情(新)。