按名称搜索餐厅所在地与餐饮场所

查看 Tripadvisor 猫途鹰酒店、民宿与旅行数据 的全部接口 →

根据用户输入的名称,通过必填的 query 字符串参数查询餐饮地点建议。传入城市、区域名称,或餐厅名称的一部分,即可读取返回的地点记录,方便餐厅类界面让用户选定目标位置。该参数的文档说明是餐厅所在地点的名称。此操作只返回建议记录:不返回餐厅详情、菜单、营业时间、评价或预订信息,也不接受筛选、语言或分页输入。 该操作没有提供已观测的探测响应,响应说明来自被截断的源示例,尚未经过验证。以查询词 mumbai 为例,示例中的 data 数组由地点对象组成,字段包括 documentId、locationId、isGeo、localizedName、placeType、latitude、longitude、localizedAdditionalNames.longOnlyHierarchy、locationV2(含 names.longOnlyHierarchyTypeaheadV2、placeType,以及要么是带 url 的对象、要么为 null 的 vacationRentalsRoute)、streetAddress.street1,以及 thumbnail.photoSizeDynamic 对象(含 maxHeight、maxWidth 和带有 {width}、{height} 占位符的 urlTemplate)。第一条示例记录是城市 Mumbai,isGeo 为 true、placeType 为 CITY;其余可见记录的 isGeo 为 false、placeType 为 EATERY,例如印度尼西亚的 Mumbai Kitchen 和西班牙的多家 Mumbai Masala 分店,因此一次响应里可能同时混有地区记录和单个餐厅记录。示例在中途被截断,完整的结果数量、排序方式、data 之外的外层字段以及错误行为均无法确定。请把名称标签当作展示文本,使用任何字段之前先检查实际返回结果,并且不要想当然地认为 locationId 或 documentId 可以直接作为 restaurantsId 传给其他操作,务必先查阅那个操作自身的输入文档。

API 功能

单一必填名称查询 只需一个必填的 query 字符串即可发起查询,文档示例为 mumbai。没有日期、筛选、语言或分页输入,请求体量很小,适合做输入框的实时联想。
一次响应同时含城市与餐厅 源示例先返回 isGeo 为 true 的 CITY 记录,随后是 isGeo 为 false 的 EATERY 记录,因此一次调用就能同时为区域建议和餐厅建议提供数据。
用层级标签区分同名地点 每条示例记录都带有 localizedAdditionalNames.longOnlyHierarchy 和 locationV2.names.longOnlyHierarchyTypeaheadV2,有助于分辨印度的 Mumbai、巴厘岛的 Mumbai Kitchen 和兰萨罗特岛的 Mumbai Masala。
经纬度与街道行 示例记录带有 latitude、longitude 和 streetAddress.street1,足以在建议项下方显示地图标记和一行地址。请先在实际响应中确认这些字段确实存在。
餐厅缩略图 URL 模板 示例中的每个 thumbnail.photoSizeDynamic 都列出 maxWidth、maxHeight 以及带 {width}、{height} 占位符的 urlTemplate,调用方按所需缩略图尺寸自行填入即可。
只做地点建议,不含餐厅内容 该操作只负责解析地点和场所。菜单、营业时间、评价和预订数据都不在文档记载的响应里,因此适合作为调用餐厅详情请求之前的第一步。

在线 API 演示

GET /api/project/tripadvisor-data/search-restaurant-location

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/search-restaurant-location?key=<API_KEY>&query=<query>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

query 参数应该传什么?

传入餐厅所在地点的名称,例如 mumbai 这样的城市名。该参数是必填字符串。此操作没有其他输入,因此不支持筛选、语言、结果数量限制和分页。

这个接口返回的是餐厅,还是只有城市?

针对 mumbai 的源示例两者都有。第一条记录是城市 Mumbai(placeType 为 CITY,isGeo 为 true),其余可见记录是餐厅(placeType 为 EATERY,isGeo 为 false),名称如 Mumbai Kitchen。由于示例被截断且没有提供探测响应,其他查询词的具体构成无法确定,请在代码中根据 placeType 和 isGeo 分支处理。

文档记载了哪些响应字段?

被截断的源示例显示 data 数组,其中的对象包含 documentId、locationId、isGeo、localizedName、placeType、latitude、longitude、localizedAdditionalNames.longOnlyHierarchy、locationV2、streetAddress.street1 和 thumbnail.photoSizeDynamic。由于没有提供已观测的探测响应,这些字段尚未验证,示例在可见记录之后也被截断。

返回的 locationId 能直接当作 restaurantsId 用于餐厅详情操作吗?

不要想当然。餐厅详情类操作的文档确实把 restaurantsId 列为输入,但现有证据并没有表明这里返回的 locationId 或 documentId 会被它们接受,也没有说明应采用什么形式。在围绕它搭建流程之前,请查阅目标操作的输入文档,并用一个真实返回值实际测试。

如何把缩略图的 urlTemplate 变成可用的图片地址?

示例中的 urlTemplate 含有字面的 {width} 和 {height} 占位符。请把它们替换成适合版式的像素尺寸,并保持在模板旁 maxWidth 与 maxHeight 的范围内。生成的地址只是展示内容,请兼容没有缩略图的记录。

这个接口会返回菜单、营业时间或评价吗?

不会。它只是地点和场所的建议查询。文档记载的响应字段只涉及名称、层级标签、经纬度、街道行和缩略图模板。如需更丰富的餐厅内容,请使用专门的餐厅详情操作,并查看它自己的输入和响应说明。

相关接口

相关指南

查看订阅方案 →