新的地点详情 API、附近搜索 API 和文本搜索 API 的响应格式与现有 API 的格式已更改。主要区别在于每种方法返回的 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 |
新的 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 |
|
资源名称 | name 字段,格式为 places/PLACE_ID |
在现有 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 对象 |
|
地点详情 | 包含现有 Place 对象的 result |
新的Place对象 | |
请求的状态 | status |
已移到标准 HTTP 响应(HTTP 响应代码和消息) | |
任何信息类消息 | info_messages |
已移到标准 HTTP 响应(HTTP 响应代码和消息) |