按商家名称和地点查找 Google 地图上的公开资料，查看可用的联系方式、评分和营业时间，并核对结果是不是要找的商家。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
DataForSEO
按商家名称和地点查找 Google 地图上的公开资料，查看可用的联系方式、评分和营业时间，并核对结果是不是要找的商家。
获得返回的商家资料及其中可用的信息，例如类别、地址、电话、网站、评分和营业时间。Agent 可以在联系商家或前往之前帮你整理这些信息。先核对返回的名称和地址，确认对应的是你想找的地点。
请在 Google 地图上查找位于 [New York, United States] 的 [RustyBrick, Inc.]，使用 [英语] 查询。整理可查到的地址、电话、网站、评分和营业时间，并列出返回的名称和地址，方便我确认是否找对商家。
名称查询可能匹配到其他商家或分店，部分信息也可能缺失。此工具只读取公开资料，无法认领、验证或编辑商家资料。列出的营业时间不能保证商家此刻正在营业。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
商家查询请求request | object | 必填 | 必填对象，包含 keyword、language_code 和 location_name。三项均须填写，即使 keyword 使用已知的 CID 或 Place ID。
|
商家名称或标识request.keyword | string | 必填 | 必填字符串，长度为 1–256 个字符。可填写本地商家名称，或 cid:194604053573767737、place_id:GhIJQWDl0CIeQUARxks3icF8U8A 这样的标识。供应商会解码百分号转义，并将 + 解码为空格；字面百分号请写成 %25。
|
搜索语言代码request.language_code | string | 必填 | 必填且受支持的语言代码，例如 en 表示英语。长度为 1–256 个字符。填写代码而非语言名称；页面显示语言不会自动设置此输入。
|
搜索地区名称request.location_name | string | 必填 | 必填且受支持的完整搜索地区名称，例如 New York,New York,United States 或 London,England,United Kingdom。长度为 1–256 个字符；使用 CID 或 Place ID 仍须填写此项。
|
{
"type": "object",
"required": [
"request"
],
"properties": {
"request": {
"type": "object",
"required": [
"language_code",
"location_name",
"keyword"
],
"properties": {
"keyword": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"language_code": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"location_name": {
"type": "string",
"maxLength": 256,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}暂未配置返回字段说明。
返回信息保留搜索地区、语言、结果接收时间及可用的商家条目。联系方式、预约页面和网站链接可另行打开查看；获取这些链接不会联系商家或完成预约。具体含义见 DataForSEO 端点说明。
提供商家名称、城市和国家/地区，以及希望使用的语言。例如：[RustyBrick, Inc.]、[New York, United States]、[英语]。若有多个同名分店，可补充街区或街道。
请在 Google 地图上查找位于 [New York, United States] 的 [RustyBrick, Inc.]，使用 [英语] 查询。整理可查到的地址、电话、网站、评分和营业时间，并列出返回的名称和地址，方便我确认是否找对商家。
先核对返回的商家名称和地址；同名分店不一定是你要找的地点。营业时间等信息可能变化，出发前请向商家确认。
将返回的名称、地址及可用的 CID 或 Place ID 与目标商家核对。商家或分店可能同名或名称相近，应检查每个可用条目，不能只看名称。匹配结果也不等于独立的身份核验。
返回的 is_claimed 标记反映 Google 地图是否显示该商家已由所有者验证。本查询只读取这项信息，不能完成验证、识别账户所有者或授予管理商家资料的权限。
结合可用的评分值、评分类型或量表以及评价数量来理解，分值可能含小数。评价总数或一至五星的分布统计的是评分，不是独立顾客人数；结果也不提供全部评论正文或服务质量认证。
结果时间表示 DataForSEO 收到结果的 UTC 时间，不是每项商家资料的更新时间。营业时间使用二十四小时制的小时和分钟，但此端点没有明确其时区。应将营业时间和状态作为返回的资料看待；时间敏感时，请再向商家确认。
没有返回商家条目不等于商家不存在，信息可能暂不可用，查询也可能未匹配到目标资料。区分字段缺失、null 与实际为零或 false 的值，不要猜测缺失的电话、评分或营业时刻表。