用途:该技能用于解析查询中的地点,并将返回的详情与来源链接进行比对,包含四个 Google Maps 实时端点。
主要能力:支持地点搜索、按 place_id 获取地点详情、获取评论样本和地点照片。搜索使用 POST,字段为扁平结构,keyword、language、country 均为必填;mapSearchOption 只是参数标签,不是 JSON 包装。相关时应在 keyword 中包含城市或街区。
使用方式:设置环境变量 CRAWLORA_API_KEY(来自 crawlora.net),在技能目录下运行 scripts/crawlora.sh,它会向 https://api.crawlora.net/api/v1 发送 x-api-key 并打印 JSON 响应。端点方法与参数见 reference/endpoints.md。示例: scripts/crawlora.sh -X POST /google/map/search '{"keyword":"coffee cambridge massachusetts","language":"en","country":"us"}'
工作流:按用户地理范围和类别搜索,使用返回的 place_id,不要凭名称或地址编造 ID;对需要最新详情的候选地点请求 /google/map/place/{place_id},合并记录前核对名称与地址,分店是独立地点;需要客户反馈时请求 /google/map/place/{place_id}/reviews,需要图库时请求 /photos,做视觉判断前应查看实际图片。报告时给出地点名称、地址、来源 URL、评分与评论数及检索时间;无法获取的电话、网站、营业时间等字段应留作未知。
限制:实时请求至少间隔一秒,辅助脚本不会自动限流;遇到 429 应退避,瞬时 5xx 可重试一次,401/403 应停止并报告访问问题。解释数据前需同时检查 JSON 信封的 code 与 HTTP 成功状态。rating 为 null 表示无聚合评分,而非零星。评论是地点页面的首批样本,通常约八条相关评论,没有评论游标;limit=0 表示所有已捕获评论,而非全部评论档案,不得声称是完整或代表性调查。纯照片评论的文本可能为空,评论可能被聚合,应保留来源;有 published_at 时用它表示日期,relative_time 是显示文本。评论照片与地点图库照片不同。搜索结果只是快照,不是某地理区域的完整普查;批量拓客可考虑索引式商家搜索。