简介
地点详情（新）、附近搜索（新）和文本搜索（新）API 的响应格式已从旧版 API 的格式更改。主要区别在于每种方法返回的 Place 对象的格式，如对响应 Place 对象的更改中所述。
此外，每个 API 的响应对象的顶级字段也发生了变化。请参阅：
对响应 Place 对象的更改
下表显示了“地点详情（新）”“附近搜索（新）”和“文本搜索（新）”响应中新
Place 对象与旧
Place 对象相比的变化。
新的响应对象对字段名称使用驼峰式命名法，包含新字段，并重命名了一些旧字段。
| 字段 | Places API（旧版）对象 | Places API（新）对象 | 备注 |
|---|---|---|---|
| 地址组成部分 | address_components |
addressComponents |
|
| 地点微格式地址 | adr_address |
adrFormatAddress |
|
| 商家状态 | business_status |
businessStatus |
|
| 下周的营业时间 | current_opening_hours |
currentOpeningHours |
|
| 编辑摘要 | editorial_summary |
editorialSummary |
|
| 设置了格式的地址 | formatted_address |
formattedAddress |
|
| 国内电话号码 | formatted_phone_number |
nationalPhoneNumber |
|
| 位置 | geometry.location |
location |
|
| 视口 | geometry.viewport |
viewport |
|
| 地点提供方信息 | html_attributions |
attributions |
旧版 API 中响应的顶级字段 |
| 图标网址 | icon |
已移除。请使用 iconMaskBaseUri 和 iconBackgroundColor。如需了解详情，请参阅地点图标。 |
|
| 图标背景颜色 | icon_background_color |
iconBackgroundColor |
|
| 图标遮罩网址 | icon_mask_base_uri |
iconMaskBaseUri |
|
| 国际电话号码 | international_phone_number |
internationalPhoneNumber |
|
| 文本地名 | name |
displayName |
现在，文本地点名称可通过 displayName.text 访问，language 可通过 displayName.languageCode 访问 |
| 营业时间 | opening_hours |
regularOpeningHours |
|
| 相册 | photos |
photos |
新 Place 对象中的 photos 格式已发生变化。如需了解详情，请参阅对照片参考的更改。 |
| 地点 ID | place_id |
id |
|
| Plus Code | plus_code |
plusCode |
|
| 价格水平 | price_level |
priceLevel |
|
| 评分 | rating |
rating |
|
| 评价 | reviews |
reviews |
|
| 从今天开始的下周的次要营业时间，包括例外情况和所有其他数据 | secondary_opening_hours |
currentSecondaryOpeningHours |
|
| 地点类型 | types |
types |
|
| 相应地点的 Google 地图网址 | url |
googleMapsUri |
|
| 用户评分数量 | user_ratings_total |
userRatingCount |
|
| 世界协调时间 (UTC) 偏移量 | utc_offset |
utcOffsetMinutes |
|
| 地址的简写形式，包括街道名称和城镇 | vicinity |
shortFormattedAddress |
|
| 地点的网站 | website |
websiteUri |
|
| 轮椅无障碍设施信息 | wheelchair_accessible_entrance |
accessibilityOptions |
wheelchair_accessible_entrance现已在accessibilityOptions.wheelchairAccessibleEntrance上架 |
| 地点属性 | takeout, delivery, dine_in, curbside_pickup, reservable,
serves_breakfast, serves_lunch, serves_dinner, serves_beer, serves_wine,
serves_brunch, serves_vegetarian_food |
takeout, delivery, dineIn, curbsidePickup, reservable,
servesBreakfast, servesLunch, servesDinner, servesBeer, servesWine,
servesBrunch, servesVegetarianFood |
|
| 资源名称 | 格式为 places/PLACE_ID 的 name 字段 |
在旧版 API 中，name 字段包含地点名称（以文本字符串形式）。在新版 API 中，该信息位于 displayName 中。 |
|
| 放置主要类型 | primaryTypeName |
新 | |
| 将主要类型放置为文本字符串 | primaryTypeDisplayName |
新 | |
| 常规每周次要营业时间，包括例外情况和所有其他数据 | regularSecondaryOpeningHours |
新 | |
| 相应场所接受的付款方式 | paymentOptions |
新 | |
| 放置停车选项 | parkingOptions |
新 | |
| 与相应地点相关的子目的地列表 | subDestinations |
新 | |
| 加油站中有关燃油选项的最新信息 | fuelOptions |
新 | |
| 地点的电动车辆充电信息 | evChargeOptions |
新 | |
| 地点属性 | outdoorSeating, liveMusic, menuForChildren, servesCocktails,
servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom,
goodForGroups, goodForWatchingSports |
新 |
“文本搜索”响应更改
下表显示了文本搜索（旧版）的响应对象和文本搜索（新）的响应对象的顶级字段的变化。对于新版 API，响应中唯一的顶级字段是 places 数组。
| 字段 | 文本搜索（旧版） | 文本搜索（新） | 备注 |
|---|---|---|---|
| 地点提供方信息 | html_attributions |
已移至每个地点的新的 Place 对象中，作为 place.attributions |
|
| 地点数组 | 旧版 Place 对象的 results 数组 |
新 Place 对象的 places 数组 |
|
| 请求的状态 | status |
已移至标准 HTTP 响应（HTTP 响应代码和消息） | |
| 所有错误消息 | error_message |
已移至标准 HTTP 响应（HTTP 响应代码和消息） | |
| 任何信息类消息 | info_messages |
已移除 | |
| 页面令牌 | next_page_token |
已移除 |
“附近搜索”响应更改
下表显示了“附近搜索（旧版）”的响应对象的顶层字段和“附近搜索（新）”的响应对象的顶层字段的变化。对于新版 API，响应中唯一的顶级字段是 places 数组。
| 字段 | 附近搜索（旧版） | 附近搜索（新） | 备注 |
|---|---|---|---|
| 地点提供方信息 | html_attributions |
已移至每个地点的新 Place 对象中，作为 place.attributions |
|
| 地点数组 | 旧版 Place 对象的 results 数组 |
新 Place 对象的 places 数组 |
|
| 请求的状态 | status |
已移至标准 HTTP 响应（HTTP 响应代码和消息） | |
| 所有错误消息 | error_message |
已移至标准 HTTP 响应（HTTP 响应代码和消息） | |
| 任何信息类消息 | info_messages |
已移除 | |
| 页面令牌 | next_page_token |
已移除 |
“地点详情（新）”响应变更
下表显示了“地点详情（旧版）”的响应对象的顶级字段和“地点详情（新）”的响应对象的顶级字段的变化。对于新版 API，响应中唯一的顶级字段是 places 数组。
| 字段 | 地点详情（旧版） | 地点详情（新） | 备注 |
|---|---|---|---|
| 地点提供方信息 | html_attributions |
已移至新的 Place 对象中，作为 attributions |
|
| 地点详情（新） | 包含旧版 Place 对象的 result |
新的 Place 对象 | |
| 请求的状态 | status |
已移至标准 HTTP 响应（HTTP 响应代码和消息） | |
| 任何信息类消息 | info_messages |
已移至标准 HTTP 响应（HTTP 响应代码和消息） |