{
  "spec_version": "0.2",
  "namespace": "WW_Yang",
  "app_name": "google-maps-leads",
  "app_id": "app_776d2cef0d4a",
  "status": "published",
  "open_to": "public",
  "accepting_runs": true,
  "source_locale": "zh-CN",
  "identity": {
    "app_name": "google-maps-leads",
    "name": "谷歌地图商家线索采集",
    "summary": "给一个谷歌地图搜索页链接，返回该页商家的名称、地址、经纬度、官网、评分与详情链接等线索信息",
    "type": "data",
    "version": "0.1.1"
  },
  "discovery": {
    "capability": "data-acquisition",
    "keywords": [
      "谷歌地图",
      "商家线索",
      "本地商家",
      "地址",
      "经纬度"
    ],
    "boundary": "单次任务处理 1 个谷歌地图搜索或列表页链接，采集条数上限默认 3 条、可上调（越大耗时与费用越高）；仅覆盖页面公开展示的商家信息，部分商家缺少官网或附加信息。"
  },
  "input": {
    "schema": {
      "type": "object",
      "properties": {
        "map_url": {
          "type": "string",
          "title": "地图搜索页链接",
          "description": "要采集的谷歌地图搜索或列表页完整链接，例如 https://www.google.com/maps/search/restaurants+in+new+york/ ；请填写真实可访问的链接",
          "pattern": "^https://",
          "prefill": "https://www.google.com/maps/search/restaurants+in+new+ycork/@40.7376352,-74.0376034,13z/data=!3m1!4b1!4m4!2m3!5m1!4e9!6e5?entry=ttu&g_ep=EgoyMDI2MDUxMy4wIKXMDSoASAFQAw%3D%3D"
        },
        "page_turns": {
          "type": "integer",
          "title": "翻页次数",
          "description": "在首个列表页之外继续向下翻页的次数，不填默认 1 次；次数越多耗时和费用越高",
          "default": 1,
          "minimum": 1
        },
        "max_collected_rows": {
          "type": "integer",
          "title": "采集条数上限",
          "description": "本次任务最多采集多少条商家线索，不填默认 3 条，数值越大耗时和费用越高",
          "default": 3,
          "minimum": 1
        }
      },
      "required": [
        "map_url"
      ],
      "additionalProperties": false
    }
  },
  "output": {
    "id_field": "place_id",
    "schema": {
      "type": "object",
      "properties": {
        "title": {
          "type": "string",
          "title": "商家名称",
          "description": "商家在地图上展示的名称",
          "prefill": "The Landing"
        },
        "address": {
          "type": "string",
          "title": "地址",
          "description": "商家的完整街道地址",
          "prefill": "1 Pennsylvania Plaza, New York, NY 10119"
        },
        "city": {
          "type": "string",
          "title": "城市",
          "description": "商家所在城市",
          "prefill": "New York"
        },
        "state": {
          "type": "string",
          "title": "州/省",
          "description": "商家所在的州或省级行政区",
          "prefill": "New York"
        },
        "country": {
          "type": "string",
          "title": "国家",
          "description": "商家所在国家或地区的代码",
          "prefill": "US"
        },
        "rating": {
          "type": "string",
          "title": "评分",
          "description": "商家在地图上展示的评分，5 分制",
          "prefill": "4.6"
        },
        "website": {
          "type": "string",
          "title": "官网",
          "description": "商家官网链接，部分商家没有",
          "prefill": "https://www.thelanding.nyc/"
        },
        "detail_url": {
          "type": "string",
          "title": "详情链接",
          "description": "该商家在地图上的详情页链接",
          "prefill": "https://www.google.com/maps/place/The+Landing/data=!4m5!3m4!1s0x89c259bfc3e29bd5:0x71e84703e2c37e4c!8m2!3d40.7511917!4d-73.9921436?authuser=0&hl=en-US&rclk=1"
        },
        "place_id": {
          "type": "string",
          "title": "地点 ID",
          "description": "商家在地图上的唯一地点标识",
          "prefill": "ChIJ1Zviw79ZwokRTH7D4gNH6HE"
        },
        "google_id": {
          "type": "string",
          "title": "Google ID",
          "description": "商家在地图上的另一标识，十六进制键值对形式",
          "prefill": "0x89c259bfc3e29bd5:0x71e84703e2c37e4c"
        },
        "attributes": {
          "type": "string",
          "title": "附加信息",
          "description": "商家页展示的属性标签，多个以逗号并列，部分商家没有",
          "prefill": "LGBTQ+ friendly"
        },
        "latitude": {
          "type": "string",
          "title": "纬度",
          "description": "商家所在地点的纬度",
          "prefill": "40.7511917"
        },
        "longitude": {
          "type": "string",
          "title": "经度",
          "description": "商家所在地点的经度",
          "prefill": "-73.9921436"
        },
        "main_image": {
          "type": "string",
          "title": "主图",
          "description": "商家在地图上展示的主图链接",
          "prefill": "https://lh3.googleusercontent.com/gps-cs-s/AHRPTWmX6zX6PT4GLeY9-rc6qFYSa8YMzYLFvGp7wYM1nVcihcPQDNsjTRl4pV_sqfi9JJTFSZOmecMwiRS_gnRNr9VYKex3DWC85tC0r8otGF3RkEKizfkvs5FeCoBRb6zxAhXeRklu=w408-h272-k-no"
        },
        "source_url": {
          "type": "string",
          "title": "来源链接",
          "description": "该商家所属的地图搜索页链接",
          "prefill": "https://www.google.com/maps/search/restaurants+in+new+ycork/@40.7376352,-74.0376034,13z/data=!3m1!4b1!4m4!2m3!5m1!4e9!6e5?entry=ttu&g_ep=EgoyMDI2MDUxMy4wIKXMDSoASAFQAw%3D%3D&hl=en"
        }
      },
      "required": [],
      "additionalProperties": false
    }
  },
  "execution": {
    "mode": "async",
    "timeout_seconds": 2100,
    "cancel_notify": false,
    "recovers_partial_on_cancel": false
  },
  "knowledge": {
    "when_to_use": [
      "需要按地图搜索页链接批量获取某个地区某类商家的线索清单时",
      "需要商家的名称、地址、经纬度、官网与详情链接做本地化拓客或门店盘点时"
    ],
    "when_not_to_use": [
      "需要商家的电话、营业时间、评价条数等本应用不提供的字段时——改用相应的商家详情类应用",
      "需要秒级返回结果时——本应用在后台执行采集，完成时间取决于商家数量与页数"
    ],
    "failure_handling": [
      "部分数据获取是异步返回的：参数较大或商家较多时，采集会耗时较长、无法立即返回；请耐心等待抓取完成，任务状态显示「运行中」表示仍在采集，并非异常",
      "任务失败属可重试错误，可原样重新提交",
      "返回空结果通常是链接不是谷歌地图的搜索或列表页，或该页当前无可采集商家，请核对链接后重试"
    ]
  },
  "pricing": {
    "events": [
      {
        "event": "record",
        "label": "返回一条商家线索",
        "unit_price": 0.002,
        "qty_from": "",
        "unit_size": 1
      },
      {
        "event": "start",
        "label": "提交一次任务",
        "unit_price": 0.001,
        "qty_from": "",
        "unit_size": null
      }
    ]
  },
  "examples": [
    {
      "id": "basic",
      "goal": "采集纽约市区「restaurants in new york」搜索页的餐厅线索，最多 3 条",
      "input": {
        "map_url": "https://www.google.com/maps/search/restaurants+in+new+ycork/@40.7376352,-74.0376034,13z/data=!3m1!4b1!4m4!2m3!5m1!4e9!6e5?entry=ttu&g_ep=EgoyMDI2MDUxMy4wIKXMDSoASAFQAw%3D%3D",
        "page_turns": 1,
        "max_collected_rows": 3
      },
      "use_as_test": true
    }
  ],
  "published_at": "2026-09-16T09:48:07.274509+00:00",
  "publisher": {
    "id": "WW_Yang",
    "name": "WW_Yang"
  },
  "maintainers": [
    {
      "id": "WW_Yang",
      "name": "WW_Yang"
    }
  ],
  "trust_tier": "community",
  "readme": "想快速拿到某个地区某类商家的名单吗？给它一条谷歌地图的搜索页链接，它会把该页展示的商家的名称、地址、城市、州省、国家、经纬度、评分、官网与详情链接整理成一份线索清单，可以直接导出成表格，接进表格或你自己的客户系统里。\n\n做本地化拓客、门店盘点或竞品摸底时，最费时的往往是\"一家家点开地图、把名称地址抄下来\"。这份数据把这个地区搜索结果页上的商家一次性取回，每条都带可点开的详情链接和经纬度，适合当作线索清洗、区域覆盖分析和地图标注的原始底表。\n\n## 数据说明\n\n商家清单取自谷歌地图的公开搜索结果页，按该页原有的展示顺序返回，不做二次排序或去重。评分是商家在地图上展示的评分，满分 5 分。经纬度是商家所在地点的坐标，可用于地图标注或距离计算。官网与附加信息只在商家页展示时才有，部分商家没有这两项。只覆盖公开可见的商家，需要登录才能看到的或已关停的商家不在其中。数据为取数当时页面展示的快照，评分和商家信息会随时间变化。本应用只提供商家的基础档案信息，不含电话、营业时间与逐条评价。\n\n## 结果长什么样\n\n每条记录是一个商家：\n\n| 商家名称 | 城市 | 地址 | 评分 | 国家 |\n|---|---|---|---|---|\n| The Landing | New York | 1 Pennsylvania Plaza, New York, NY 10119 | 4.6 | US |\n| La Grande Boucherie | New York | 145 W 53rd St, New York, NY 10019 | 4.6 | US |\n\n另有「州/省」「经纬度」「官网」「详情链接」「附加信息」「主图」等字段。\n\n## 应用场景\n\n- 做本地化拓客时，按「城市」「州/省」「国家」筛出目标区域的商家，再用「官网」和「详情链接」逐家联系或调研。\n- 做区域覆盖分析时，把「纬度」「经度」投到地图上看商家分布疏密，判断哪片区域还是空白。\n- 做线索清洗时，用「地点 ID」或「详情链接」给商家去重，避免同一家店重复入库。\n- 做竞品摸底时，用「评分」横向对比同类商家的口碑高低，优先挑出评分领先的对手深看。\n",
  "favorite_count": 0,
  "labels": {
    "industry": [
      {
        "slug": "local_services",
        "label": "本地生活"
      },
      {
        "slug": "general",
        "label": "通用"
      }
    ],
    "platform": [
      {
        "slug": "google_maps",
        "label": "Google Maps"
      }
    ],
    "content": []
  },
  "display_locale": "zh-CN",
  "translation_origin": null,
  "version": "0.1.1"
}