迁移 Places API 响应

地点详情 附近搜索、 和 文本搜索 现有 API 的格式已更改。主要区别在于 每个方法返回的 Place 对象的格式,如 对响应 Place 对象的更改

此外,每个 API 的响应对象的顶级字段也已更改。请参阅:

响应地点对象的更改

下表显示了“地点详情(新)”“附近搜索(新)”和“文本搜索(新)”响应中 Place 对象现有 Place 对象的变化。

新响应对象使用驼峰命名法为字段命名,包含新字段,并重命名了一些现有字段。

字段 现有 Place 对象 新建 Place 对象 备注
地址组成部分 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 已移除。使用 iconMaskBaseUriiconBackgroundColor。请参阅 放置图标
图标背景颜色 icon_background_color iconBackgroundColor
图标遮罩网址 icon_mask_base_uri iconMaskBaseUri
国际电话号码 international_phone_number internationalPhoneNumber
文本地点名称 name displayName 文本地点名称现在可以通过 displayName.textlanguage饰演displayName.languageCode
营业时间 opening_hours regularOpeningHours
照片 photos photos Place 对象中的 photos 格式已更改。如需了解详情,请参阅更改照片引用
地点 ID place_id id
Plus Code plus_code plusCode
价格水平 price_level priceLevel
Rating 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_IDname 字段 在现有 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.attributions 移入每个地点的新 Place 对象
地点数组 现有 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 作为 attributions 移入了新的地点对象
地点详情 result,包含现有 Place 对象 新的 Place 对象
请求的状态 status 改用标准 HTTP 响应(HTTP 响应代码和消息)
任何信息类消息 info_messages 改用标准 HTTP 响应(HTTP 响应代码和消息)