Google Places API:核验商家经营情况

Google Places API 字段可用于核验商家信息

处理申请时,征信机构和登记信息查询可能仍无法回答一个实际问题:商家是否出现在申报地址?Text Search (New) 根据商家名称和申报地址搜索,并返回匹配的地点。

在请求的字段掩码中指定所需字段。查询结果会为申请补充地点记录,而不是公司记录:它不会将地点与注册编号、董事或账目关联起来,因此决策流中仍需保留登记信息和征信机构查询。

Text Search 的字段分为四个计费层级。下表列出各字段及其信息:

Text Search 层级字段及其包含的信息
Essentials (IDs Only)
  • id:场所 ID。
  • movedPlaceId:场所搬迁后的新 ID。
  • consumerAlert:Google 针对可疑评价活动或违规行为发出的提醒。
Pro
  • types[]:场所类型标签。
  • formattedAddress:便于阅读的地址。
  • addressComponents:按地方行政区划层级拆分的地址信息。
  • location:场所位置。
  • businessStatus:场所营业状态。
  • openingDate:未来开业日期。
  • primaryType:场所的主要类型。
  • displayName:本地化的场所名称。
  • pureServiceAreaBusiness:商家是否上门服务或向客户送货。
Enterprise
  • rating:1.0 到 5.0 的评分。
  • userRatingCount:评价总数。
  • regularOpeningHours:常规营业时间。
  • currentOpeningHours:接下来七天的营业时间,含特殊日期。
  • websiteUri:该场所的官方网站。
  • nationalPhoneNumber:该场所使用国家格式的电话号码。
  • internationalPhoneNumber:该场所使用国际格式的电话号码。
Enterprise + Atmosphere
  • reviews:按相关性排序的评价,最多五条。
  • reviewSummary:评价摘要。

每次请求按适用的最高 SKU 计费,因此所选字段决定该请求所属的计费层级。

Places Text Search 请求头将 API key 对应到 places_api_key,字段掩码指定 name、address、status、types 和 ratings
Google Places 查询 Bar Italia,地址为 22 Frith Street。结果显示该地点仍在营业,地址为 22 Frith St,评分为 4.2。
Google 地图

小微企业贷款:核验商家是否仍在经营

审核小微企业申请时,可将申报的商家名称和地址与 Google 地点信息对照,判断商家是否在该地址经营。Google 数据中的 OPERATIONAL 表示商家在此经营,但不代表查询时正在营业。CLOSED_PERMANENTLY 则需要核实商家是否仍在申请地址经营。如果返回了 movedPlaceId,应查询该 ID 对应的地点。将这些信息与登记信息和征信机构查询结果一并判断。

判断地点描述是否与申请相符时,可将申报行业与 primaryType 和 types 对照。申报为餐厅,匹配类型为 restaurant,两者相符。申报为批发商,却匹配到服装店类型,或地点没有主要类型,都应转人工复核。对照结果可作为转交复核的依据,不能据此自动认定商家情况。

对于申报为零售商户的场所,可将 regularOpeningHours 与零售商通常的营业时间进行比较。没有营业时间记录,或记录的时间不符合零售商的常见营业安排,都需要进一步审核。全天 24 小时营业的场所,记录为从第 0 天 0 时开始的一个时段。判断商户的公开活跃度时,userRatingCount 是评价数量,rating 是评价者对场所的评分,范围为 1.0 到 5.0。只有三条评价时,放贷机构能参考的公开信息有限。评价有八百条时,无论评分高低,都有更多公众评价可供参考。

BNPL 商家入驻前核验门店状态

在商家门店开通 BNPL 前,可根据地点状态区分正在经营、尚未开业或暂停营业的门店。不同状态对应不同的入驻处理方式:

场所状态状态说明开户处理
OPERATIONAL门店正在营业继续处理
FUTURE_OPENING,且有 openingDate门店尚未开业,字段显示开业日期等待开业日期
CLOSED_TEMPORARILY门店暂停营业暂缓处理申请

如果设置了 consumerAlert,说明 Google 检测到商家存在可疑评价活动或违反政策的情况。解读门店评分时应考虑这一信息。

将门店的 websiteUri 和 nationalPhoneNumber 与商家入驻时填写的信息对照,判断提交的信息是否匹配,并据此衡量评价信息的参考价值。

欺诈和 KYB 核验:区分不同类型的商家地址

如果地址只返回 street_address、premise 或 subpremise 等地址类型,没有 establishment,Google 地点数据就没有显示商家在此经营。例外情况是商家上门为客户提供服务。对于申报为门店的商家,coworking_space、business_center 或 shipping_service 可能表示其使用虚拟办公室或邮箱服务。申报为门店,地址却显示为 apartment_building 或 housing_complex,则是住宅地址,存在另一类信息不匹配。欺诈复核时可参考地点记录。公司注册和所有权情况仍需通过登记信息及其他核查确认。

清洁服务商或水管工可能上门为客户服务,在 Google 地图上没有实体地点。设置 KYB 规则时,可将设置了 pureServiceAreaBusiness 的商家识别为服务区域型商家。转交没有 establishment 的地址进行复核前,先检查该字段,避免把不需要门店的服务区域型商家当作应有实体门店的商家处理。

将这些审核规则纳入决策流

制定信贷、反欺诈或催收规则,并用于实际决策。

催收核验:安排上门和监测贷款组合

监测贷款组合时,应保留商家入驻时取得的地点 ID,并用它重新查询商家的当前状态和是否已搬迁。批量处理可用于这一轮贷款组合检查,也用于客户贷款组合的预评分。查询结果反映当前情况,并不代表评分趋势。要分析趋势,必须保存过往评分,而服务条款不允许这样做。

对逾期商家安排上门前,应先核实商家是否仍在该地址经营,以及是否已经搬迁。businessStatus 可用于判断上门是否仍有必要,movedPlaceId 指向下一步要查询的地点,currentOpeningHours 则显示未来七天内可能有人在场的时间。如果 Places 规则无法确定案件情况,可转入案件管理,安排人工复核或外部数据查询任务。

下表是虚构的决策表,并非 Places 返回结果。表中的处理结果只是放贷机构可能设置的示例,不构成建议。规则按从上到下的顺序匹配,命中第一条后停止:

行条件放贷机构处理示例
1businessStatus 为 CLOSED_PERMANENTLYDecline
2businessStatus 为 CLOSED_TEMPORARILY 或 FUTURE_OPENINGRefer:暂停营业或尚未开业
3pureServiceAreaBusiness 为 trueContinue to next check
4未找到场所,或其 types 不含 establishmentRefer:该地址没有营业场所
5缺少 rating 或 userRatingCountRefer:Google 上没有公开活动信息
6userRatingCount 少于 10Refer:公开活动信息有限
7primaryType 与申报行业不符Refer:类型不匹配
8其他所有情况Continue to next check
Places 决策表:评分数或评论数缺失时,因没有公开活动而返回 refer,数量少于 10 时,因活动数据不足而返回 refer

缺失值行应排在按评价数量值进行审核的行之前,因为字段缺失可能是该字段未被请求、Google 没有返回数值,或调用超时。2026-10-03 的一次独立决策表引擎测试显示了其中的风险:一条批准债务收入比在 0 到 35 之间申请人的规则,也批准了一名没有提供债务收入比的申请人。这说明数值比较可能把缺失值当作零,进而让申请进入原本用于评价数较少情况的规则。第 3 行排在第 4 至第 7 行之前,这样没有店铺、也没有评价的水管工不会因为两项都没有而被判为 refer。

Places API (New) 的 Google Places API key

Google Places API key 是一串唯一的字母数字字符,用于将每个请求关联到 Google Cloud 项目及其结算账号。使用前,请为项目启用结算,并开启 Places API (New)。

  1. 使用已启用结算的 Google Cloud 项目。
  2. 在 Google Cloud 控制台中为项目启用 Places API (New),或运行 gcloud services enable "places.googleapis.com"。首次发送请求前,请等待几分钟。
  3. 在 Google Maps Platform Keys & Credentials 页面中选择 Create credentials,再选择 API key。在 API restrictions 中保留 Places API (New),并取消选择其他 API。在此处选择 API 并不会启用它。
  4. 添加应用限制,例如允许调用该 key 的服务器 IP 地址。不受限制的 key 可以调用任何 Google Maps Platform 服务,滥用产生的费用由账号所有者承担。
  5. 通过 HTTPS 在 X-Goog-Api-Key 请求头中发送 key,并在 X-Goog-FieldMask 中指定要返回的字段,如下方请求所示。
curl -X POST -d '{
  "textQuery" : "Bar Italia, 22 Frith Street, London"
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.id,places.displayName,places.businessStatus,places.primaryType' \
'https://places.googleapis.com/v1/places:searchText'

2026年10月30日,不带 key 发送请求时,返回 HTTP 403,状态为 PERMISSION_DENIED:“Method doesn't allow unregistered callers (callers without established identity). Please use API Key or other form of API consumer identity to call this API.”请添加 key 请求头。使用过期 key 时,返回 HTTP 400,状态为 INVALID_ARGUMENT,原因是 API_KEY_INVALID:“API key expired. Please renew the API key.”

Places API (New) 与 Places API (Legacy) 是两个独立服务,因此需为项目启用 Places API (New),并将其加入 key 的限制设置中。如果应用同时使用两者,Google 建议分别使用不同的 key。Places API (New) 只返回 JSON,Text Search (New) 则必须指定字段掩码。

Google 服务条款对 Places API 的使用有所限制

Google Maps Platform 服务条款对地点信息的存储设定了一般限制,条款规定:

“除 Maps Service Specific Terms 明确允许的情况外,客户不得缓存 Google Maps 内容。”

服务专项条款允许保存地点 ID,并在最多连续 30 个日历日内临时缓存纬度和经度,之后必须删除坐标。条款还限制使用 Google Maps 内容改进机器学习或人工智能模型,也限制将 Places API 内容与非 Google 地图搭配使用。未搭配地图使用则不受此限。

另有一项信贷限制,适用于使用 Places Aggregate API 对个人作出决策的情形。Places Aggregate API 是另一款产品。该条款是否适用于您使用 Places API,建议由法律顾问评估。条款规定:

“直接或间接导致对个人作出任何与信贷有关的决定、评分或评估”

在 Decisimo 中,将 Places key 保存在 Credentials 中,并让数据源引用该 key。将 Text Search (New) 配置为带字段掩码的 JSON POST 数据源。首次调用可使用 Pro 字段,核验欺诈风险和商家是否存在。通过初步核验的申请,可进行第二次调用,请求 Enterprise 字段,并使用首次调用返回的地点 ID 查询详情。缓存默认关闭。如果为某个决策环节启用缓存,缓存目标必须由客户持有。同一决策环节中的数据源会并行运行,任何数据源超过 15 秒仍未返回时都会超时,决策引擎会继续运行。

AI Assistant 可以根据 API 描述提出数据源配置建议,并请求将 key 添加到 Credentials。由人工应用建议并填写表单后,配置不会自动保存。字段选择和缓存设置仍需符合服务条款。

放贷机构使用 Places API 核验商家时需要了解什么?

Google 是否公布商家状态、类型和营业时间的准确率?

Google 没有公布商家状态、类型或营业时间的国家级准确率或覆盖率数据,也没有说明商家停止营业后,businessStatus 多久会更新。现有信息无法证明评分、评价数量或附近竞争商家能够预测还款情况或损失。

类型不匹配时,是否应拒绝申请?

不应如此。类型不匹配应作为人工复核的理由,不能据此直接判断商家情况。

Google 没有返回主要类型时怎么办?

将类型缺失交由人工复核。地点可能没有受支持的主要类型,仅凭这一字段缺失不能决定如何处理申请。

评价数量能补充哪些评分信息?

评价数量反映评分背后有多少公开活动信息:三条评价得到 5.0 分,与八百条评价得到 4.2 分,依据的公开信息量差异很大。

将这些审核规则纳入决策流

制定信贷、反欺诈或催收规则,并用于实际决策。