提供支持的 Google Maps 链接或已知地点 ID，采集所选地点可访问的评价，再让 Agent 整理反馈、评分及可用的商家回复，并保留来源与语言区别。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
提供支持的 Google Maps 链接或已知地点 ID，采集所选地点可访问的评价，再让 Agent 整理反馈、评分及可用的商家回复，并保留来源与语言区别。
评价记录可能包含原文、来源可提供的译文、评分、发布时间和商家回复，也可能附带地点资料及整体评分、评价数量。这些整体数字反映地点的评价范围，不是仅由本次采集的子集计算。评价者资料和评价链接取决于个人资料设置。Agent 可以归纳实际反馈，同时区分原文、译文和评价来源。
请从[Google Maps 地点或评价链接]获取[最多 20 条最新评价]，结果使用[英语]，并省略[评价者姓名和个人主页链接]。概括实际返回的评价正文、星级、日期和商家回复；如有译文，请与原文分开显示。
请求上限与排序不保证完整覆盖、固定条数或最新评价。译文可能缺失，其他来源的评分也可能采用不同量表。星级与评价者背景不独立验证质量或身份；关闭个人资料不保证完全匿名，媒体链接也不等于交付文件。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
地点评价请求body | object | 选填 | 可选请求对象，包含 Maps 目标与评价设置。要取得有用结果，需提供至少一个支持的 Maps 链接或地点 ID；输入字段本身均为可选。 |
结果语言body.language | string | 选填 | 可从 74 个语言代码选择，默认 en。请求本地化结果与来源可提供的译文，不是只筛选该语言的评价，也不保证每条均有译文。
|
已知地点 IDbody.placeIds | array | 选填 | 可选已知 Google 地点 ID 列表。服务支持以 ChIJ 或 GhIJ 开头的 27 字符 ID；示例只是格式展示，不是已确认目标。 |
地点 ID 条目body.placeIds[] | string | — | 以字符串提交的一个地点 ID。使用已知且支持的 ID，不要把示意占位内容当作真实地点。
|
支持的 Maps 链接body.startUrls | array | 选填 | 可选请求列表，每项通过 url 属性提供链接。支持 Maps 搜索、地点、评价详情及 CID 链接；需提供支持的链接，而不是商家搜索文字。黄石预填内容只是示例。 |
每个地点评价上限body.maxReviews | integer | 选填 | 可选整数，至少为 1，按每个地点限制请求数量。默认 10,000,000，预填 100 不是默认值；可按任务明确选择较小上限。访问和筛选可能使返回更少，不保证完整覆盖。
|
评价排序body.reviewsSort | string | 选填 | 可选 newest（默认、最新）、mostRelevant（最相关）、highestRanking（最高评分）或 lowestRanking（最低评分）。高低指评价分数，不是商家搜索排名；使用 reviewsStartDate 时需明确选 newest。
|
评价者资料与评价链接body.personalData | boolean | 选填 | 可选，默认 true，控制评价者 ID、姓名、账号和照片链接，以及评价链接。关闭后仍保留评价标识，不保证正文或媒体完全匿名。
|
评价来源body.reviewsOrigin | string | 选填 | 可选 all（默认），包含可取得的 Google 与第三方评价，或 google，只选 Google 自身评价。不同来源可能采用不同评分量表；all 可能提供较少 Google 评价，尤其是酒店，两种选择都不保证完整覆盖。
|
较新评价时间范围body.reviewsStartDate | string | 选填 | 可选发布时间界限，使用按 UTC 解释的 YYYY-MM-DD 或 ISO 日期时间，也可指定分钟、小时、天、周、月或年的相对范围。需明确选择 newest，采集遇到第一条较旧评价就停止。示例日期不是默认值，此设置不会自动改变排序。
|
评价关键词body.reviewsFilterString | string | 选填 | 可选文字，请求包含给定关键词的评价；默认空白，不使用关键词筛选。Google 将筛选内容限制为 500 字节，非拉丁文字可用字符数可能更少。
|
{
"type": "object",
"required": [],
"properties": {
"body": {
"type": "object",
"title": "Google Maps Reviews Scraper",
"properties": {
"language": {
"enum": [
"en",
"af",
"az",
"id",
"ms",
"bs",
"ca",
"cs",
"da",
"de",
"et",
"es",
"es-419",
"eu",
"fil",
"fr",
"gl",
"hr",
"zu",
"is",
"it",
"sw",
"lv",
"lt",
"hu",
"nl",
"no",
"uz",
"pl",
"pt-BR",
"pt-PT",
"ro",
"sq",
"sk",
"sl",
"fi",
"sv",
"vi",
"tr",
"el",
"bg",
"ky",
"kk",
"mk",
"mn",
"ru",
"sr",
"uk",
"ka",
"hy",
"iw",
"ur",
"ar",
"fa",
"am",
"ne",
"hi",
"mr",
"bn",
"pa",
"gu",
"ta",
"te",
"kn",
"ml",
"si",
"th",
"lo",
"my",
"km",
"ko",
"ja",
"zh-CN",
"zh-TW"
],
"type": "string",
"title": "Language",
"editor": "select",
"default": "en",
"example": "en",
"prefill": "en",
"enumTitles": [
"English",
"Afrikaans",
"azərbaycan",
"BahasaIndonesia",
"BahasaMelayu",
"bosanski",
"català",
"Čeština",
"Dansk",
"Deutsch (Deutschland)",
"eesti",
"Español (España)",
"Español (Latinoamérica)",
"euskara",
"Filipino",
"Français (France)",
"galego",
"Hrvatski",
"isiZulu",
"íslenska",
"Italiano",
"Kiswahili",
"latviešu",
"lietuvių",
"magyar",
"Nederlands",
"norsk",
"oʻzbekcha",
"polski",
"Português (Brasil)",
"Português (Portugal)",
"română",
"shqip",
"Slovenčina",
"slovenščina",
"Suomi",
"Svenska",
"TiếngViệt",
"Türkçe",
"Ελληνικά",
"български",
"кыргызча",
"қазақтілі",
"македонски",
"монгол",
"Русский",
"српски (ћирилица)",
"Українська",
"ქართული",
"հայերեն",
"עברית",
"اردو",
"العربية",
"فارسی",
"አማርኛ",
"नेपाली",
"हिन्दी",
"मराठी",
"বাংলা",
"ਪੰਜਾਬੀ",
"ગુજરાતી",
"தமிழ்",
"తెలుగు",
"ಕನ್ನಡ",
"മലയാളം",
"සිංහල",
"ไทย",
"ລາວ",
"ဗမာ",
"ខ្មែរ",
"한국어",
"日本語",
"简体中文",
"繁體中文"
],
"description": "可从 74 个语言代码选择，默认 en。请求本地化结果与来源可提供的译文，不是只筛选该语言的评价，也不保证每条均有译文。"
},
"placeIds": {
"type": "array",
"items": {
"type": "string",
"pattern": "\\S+"
},
"title": "🗃 Place IDs",
"editor": "stringList",
"example": [
"ChIJabcdEFGHijklMNOPqrstUVWX"
],
"description": "可选已知 Google 地点 ID 列表。服务支持以 ChIJ 或 GhIJ 开头的 27 字符 ID；示例只是格式展示，不是已确认目标。"
},
"startUrls": {
"type": "array",
"title": "Google Maps place URLs",
"editor": "requestListSources",
"example": [
{
"url": "https://www.google.com/maps/place/Yellowstone+National+Park/@44.5857951,-110.5140571,9z/data=!3m1!4b1!4m5!3m4!1s0x5351e55555555555:0xaca8f930348fe1bb!8m2!3d44.427963!4d-110.588455?hl=en-GB"
}
],
"prefill": [
{
"url": "https://www.google.com/maps/place/Yellowstone+National+Park/@44.5857951,-110.5140571,9z/data=!3m1!4b1!4m5!3m4!1s0x5351e55555555555:0xaca8f930348fe1bb!8m2!3d44.427963!4d-110.588455?hl=en-GB"
}
],
"description": "可选请求列表，每项通过 url 属性提供链接。支持 Maps 搜索、地点、评价详情及 CID 链接；需提供支持的链接，而不是商家搜索文字。黄石预填内容只是示例。"
},
"maxReviews": {
"type": "integer",
"unit": "reviews per place",
"title": "Number of reviews",
"default": 10000000,
"example": 100,
"minimum": 1,
"prefill": 100,
"description": "可选整数，至少为 1，按每个地点限制请求数量。默认 10,000,000，预填 100 不是默认值；可按任务明确选择较小上限。访问和筛选可能使返回更少，不保证完整覆盖。"
},
"reviewsSort": {
"enum": [
"newest",
"mostRelevant",
"highestRanking",
"lowestRanking"
],
"type": "string",
"title": "Sort reviews by",
"editor": "select",
"default": "newest",
"example": "newest",
"enumTitles": [
"Newest",
"Most relevant",
"Highest ranking",
"Lowest ranking"
],
"description": "可选 newest（默认、最新）、mostRelevant（最相关）、highestRanking（最高评分）或 lowestRanking（最低评分）。高低指评价分数，不是商家搜索排名；使用 reviewsStartDate 时需明确选 newest。"
},
"personalData": {
"type": "boolean",
"title": "Personal data",
"default": true,
"example": true,
"description": "可选，默认 true，控制评价者 ID、姓名、账号和照片链接，以及评价链接。关闭后仍保留评价标识，不保证正文或媒体完全匿名。"
},
"reviewsOrigin": {
"enum": [
"all",
"google"
],
"type": "string",
"title": "Reviews origin",
"editor": "select",
"default": "all",
"example": "all",
"enumTitles": [
"All reviews",
"Google"
],
"description": "可选 all（默认），包含可取得的 Google 与第三方评价，或 google，只选 Google 自身评价。不同来源可能采用不同评分量表；all 可能提供较少 Google 评价，尤其是酒店，两种选择都不保证完整覆盖。"
},
"reviewsStartDate": {
"type": "string",
"title": "Only scrape reviews newer than [date]",
"editor": "datepicker",
"example": "2024-01-01",
"pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])(T[0-2]\\d:[0-5]\\d(:[0-5]\\d)?(\\.\\d+)?Z?)?$|^(\\d+)\\s*(minute|hour|day|week|month|year)s?$",
"dateType": "absoluteOrRelative",
"description": "可选发布时间界限，使用按 UTC 解释的 YYYY-MM-DD 或 ISO 日期时间，也可指定分钟、小时、天、周、月或年的相对范围。需明确选择 newest，采集遇到第一条较旧评价就停止。示例日期不是默认值，此设置不会自动改变排序。"
},
"reviewsFilterString": {
"type": "string",
"title": "Filter reviews by keywords",
"editor": "textarea",
"default": "",
"example": "",
"description": "可选文字，请求包含给定关键词的评价；默认空白，不使用关键词筛选。Google 将筛选内容限制为 500 字节，非拉丁文字可用字符数可能更少。"
}
},
"description": "可选请求对象，包含 Maps 目标与评价设置。要取得有用结果，需提供至少一个支持的 Maps 链接或地点 ID；输入字段本身均为可选。",
"schemaVersion": 1
}
},
"additionalProperties": false
}暂未配置返回字段说明。
评价发布时间、来源报告的到访日期和商家回复日期描述不同事件。Agent 整理的主题是对实际返回意见的解读，不是独立的情绪分析或质量判断。
粘贴[想查看评价的 Google Maps 地点或评价链接]，再请求[最多 20 条最新评价]和[英语结果]，并要求[省略评价者姓名和个人主页链接]。
请从[Google Maps 地点或评价链接]获取[最多 20 条最新评价]，结果使用[英语]，并省略[评价者姓名和个人主页链接]。概括实际返回的评价正文、星级、日期和商家回复；如有译文，请与原文分开显示。
查看实际返回的评价正文、星级、日期和商家回复。如有译文，请与原文分开；地点整体评价数量也要与本次采集到的评价分开看。
它关闭指定的评价者身份、账号资料字段及评价链接，仍保留评价标识。正文、照片或其他背景可能含识别信息，因此不保证完全匿名，也不验证任何人的身份。
不会。语言设置请求本地化结果及来源可提供的译文，不是只选原本以英语写作的评价；译文可能缺失。原文与译文应分别标记，这也不是另一次由 Agent 翻译的任务。
设置评价发布时间界限时，要明确选择 newest。采集遇到第一条较旧评价就停止，其他排序可能过早遇到旧记录，漏掉你想取得的评价。服务不会自动修正排序；即使选最新，也不证明完整覆盖或数据一定最新。