迁移 Places API 响应

欧洲经济区 (EEA) 开发者

简介

地点详情（新）、附近搜索（新）和文本搜索（新） 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 响应代码和消息）