与现有 API 的格式不同,新的地点详情、附近搜索和文本搜索 API 的响应格式已更改。主要区别在于每个方法返回的 Place
对象的格式,如响应 Place 对象的更改中所述。
此外,响应对象的顶级字段也针对每个 API 发生了变化。请参阅:
对响应 Place 对象的更改
下表显示了与现有
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 |
已移除。使用 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 |
photos 的格式在新的 Place 对象中已更改。如需了解详情,请参阅对照片引用的更改。 |
地点 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_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.attributions 移入每个地点的新 Place 对象 |
|
地点数组 | 现有 Place 对象的 results 数组 |
新 Place 对象的 places 数组 |
|
请求状态 | status |
已移至标准 HTTP 响应(HTTP 响应代码和消息) | |
所有错误消息 | error_message |
已移至标准 HTTP 响应(HTTP 响应代码和消息) | |
任何信息类消息 | info_messages |
移除内容 | |
页面令牌 | next_page_token |
移除内容 |
“附近搜索”响应更改
下表显示了对现有“附近搜索”(新)的响应对象和响应对象的顶级字段所做的更改。对于新 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 |
已作为 attributions 移至新的 Place 对象 |
|
地点详情 | result ,包含现有 Place 对象 |
新的 Place 对象 | |
请求状态 | status |
已移至标准 HTTP 响应(HTTP 响应代码和消息) | |
任何信息类消息 | info_messages |
已移至标准 HTTP 响应(HTTP 响应代码和消息) |