GMB创建地点报PIN_DROP_REQUIRED错误 如何通过UI完成pin drop设置

报错说明 #

在Google Auth Playground环境调用GMB地点创建接口时返回400错误，错误码对应INVALID_ARGUMENT，错误原因PIN_DROP_REQUIRED，关联字段storefront_address，完整返回如下：

{
  "error": {
    "status": "INVALID_ARGUMENT",
    "message": "Request contains an invalid argument.",
    "code": 400,
    "details": [
      {
        "reason": "PIN_DROP_REQUIRED",
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "domain": "mybusinessbusinessinformation.googleapis.com",
        "metadata": {
          "field_mask": "storefront_address"
        }
      }
    ]
  }
}

触发逻辑：提交的门店地址无法被GMB地理编码服务自动匹配到唯一精确坐标，系统要求必须手动标记门店实际位置（即Pin Drop）才能通过地址合法性校验。

UI端完成Pin Drop标记的操作步骤 #

• 登录对应GMB账号的管理后台，进入地点管理列表，新建地点或者找到之前提交失败的对应草稿地点
• 打开地址编辑栏，填写之前接口提交的完整storefront_address信息，等待页面加载地图预览组件
• 此时地图上会出现红色定位图钉，如果系统自动定位的位置和门店实际位置有偏差，直接按住图钉拖动，把它放到门店实际所在的精确点位：
  • 图钉要对准门店的实际入口位置，不要放在道路中线、园区大门、公共地标这类非门店点位上
  • 拖动图钉过程中不要修改已经填好的标准地址文本，否则会触发重新地理编码，之前的标记会失效
• 确认点位无误后点击保存，等待系统完成地址校验，校验通过后该地点就会绑定手动标记的坐标
• 等待1-2分钟后台数据同步完成，再回到接口侧操作：要么直接调用接口关联这个已经完成标记的地点ID，要么在创建请求的地址参数里带上标记点位对应的经纬度值，就不会再触发该报错

避坑提示 #

• 不要尝试通过接口传参绕过Pin Drop校验，GMB对门店坐标准确性有强制审核规则，未手动标记点位的地址就算临时提交成功，后续也会被判定为地址无效，直接导致地点下线
• 批量创建地点时，所有地址匹配度不足的条目都需要单独完成Pin标记，目前没有批量标记的快捷操作入口
• 如果标记后调用接口依然报相同错误，先清空浏览器缓存重新登录后台确认点位是否真的保存成功，部分网络延迟场景下会出现保存失败无提示的问题

内容的提问来源于stack exchange，提问作者DEV