借助地图网址,您可以构建一个跨平台通用网址,以启动 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)查询参数。 - 开始使用:设置地图网址
地图网址:相关产品
- 通常与以下 API 搭配使用:Places API(新版)
地图网址:常见错误
- 问题:
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。