地图网址快速参考

借助地图网址,您可以构建一个跨平台通用网址,以启动 Google 地图、执行搜索、获取路线和导航、显示地图视图、创建地点候选清单或显示街景全景图片。网址语法在每个平台上都相同,并且不需要 API 密钥。

地图网址:关键信息

  • 产品:Maps 网址
  • 别名:Google 地图网址
  • 类别:Google 地图
  • 平台:网址协议
  • 发布阶段:GA
  • 生命周期:有效
  • 概览:地图网址概览

Maps URL:适用情形

在以下情况下使用 Google 地图网址:

  • 您需要一个来自 Android 应用、iOS 应用或网站的链接,该链接可打开 Google 地图以搜索地点或显示搜索结果。
  • 您需要打开 Google 地图,其中包含两点之间的路线,还可以选择包含航点、出行方式或精细导航。
  • 您需要打开 Google 地图,以显示地图视图、地点精选列表或街景全景图片,而无需使用 API 密钥。
  • 您需要一种在 Android、iOS 和桌面浏览器上运行方式相同的网址语法。

在以下情况下,请勿使用地图网址:

  • 您已请求地点详情,并希望获取某个地点的预设格式 Google 地图链接(googleMapsUri 或 googleMapsLinks 字段)。请改用 Places API(新版)。
  • 您在启动 Google 地图应用时需要使用移动设备专属功能;请使用 Google 地图 intent(Android 版)或 Google 地图网址协议(iOS 版)。

Maps URLs:设置

  • 使用情况归因:向地图网址添加可选的 utm_source(您的应用名称)和 utm_campaign(用户的预期操作,例如 place_details_search)查询参数。
  • 开始使用:设置地图网址

地图网址:常见错误

  • 问题:query 中仅包含纬度/经度的搜索网址会在地图或侧边栏中显示图钉,但不会显示地点详情。解决方法:使用 query=PLACE_NAME,ADDRESS,或在 query 旁边添加 query_place_id,以显示特定地点的详细信息。请参阅 /maps/documentation/urls/get-started。
  • 问题:地点 ID 参数(query_place_id、origin_place_id、destination_place_id、waypoint_place_ids)无法单独使用。解决方法:传递地点 ID 参数时,请务必包含匹配的基本参数(query、origin、destination 或 waypoints)。请参阅 /maps/documentation/urls/get-started。
  • 问题:在不支持航点且具有平台相关数量限制的 Google 地图产品中,waypoints 参数会被忽略;在无法使用导航功能的情况下,dir_action=navigate 会被忽略。解决方法:对于在移动浏览器中打开的链接,最多使用 3 个航点(否则为 9 个),并且不要依赖 waypoints 或 dir_action=navigate 在每个 Google 地图产品或路线中正常运行。请参阅 /maps/documentation/urls/get-started#directions-action。
  • 问题:地图和街景共享同一个 @ 端点,因此不含正确操作的地图网址可能无法显示地图。修复方法:为地图视图设置 map_action=map,为街景全景图片设置 map_action=pano。请参阅 /maps/documentation/urls/get-started。
  • 问题:如果地图网址中缺少 api=1,系统会忽略所有参数,并打开 Google 地图的默认视图。修正方法:在每个地图网址中添加 api=1(1 是唯一有效的值)。请参阅 /maps/documentation/urls/get-started#forming-the-url。