利用地图网址，您可以构建一个跨平台通用网址，以启动Google 地图、执行搜索、获取路线和导航，以及显示地图视图和全景图片。无论使用哪个平台，网址语法都是相同的。

　　作为 Android 应用、iOS 应用或网站的开发者，您可以构建一个通用网址，无论打开地图时所用的平台如何，该网址都会打开 Google 地图并执行请求的操作。

　　如果已安装并启用Android 版 Google 地图应用，该网址会在 Google 地图应用中启动 Google 地图并执行请求的操作。

　　如果 Google 地图应用未安装或已停用，该网址会在浏览器中启动 Google 地图并执行请求的操作。

　　如果已安装iOS 版 Google 地图应用，该网址会在 Google 地图应用中启动 Google 地图，并执行请求的操作。

　　如果未安装 Google 地图应用，该网址会在浏览器中启动 Google 地图并执行请求的操作。

　　建议您使用跨平台网址从应用或网站启动 Google 地图，因为无论使用哪个平台，您都可以通过这些通用网址更广泛地处理地图请求。对于可能仅在移动平台上可用的功能（例如精细导航），您可能更倾向于使用适用于 Android 或 iOS 的平台专用选项。请参阅以下文档：

　　如需启动 Google 地图并视需要执行某项受支持的功能，请根据请求的操作使用以下某种形式的网址架构：

　　重要提示：参数api=1用于标识此网址适用的 Google 地图网址版本。每个请求中都必须包含此参数。唯一的有效值为 1。如果网址中不存在api=1，系统会忽略所有参数，并在浏览器或 Google 地图移动应用中启动默认的 Google 地图应用（具体取决于所使用的平台，例如）。

　　例如，某些参数使用竖线字符 () 作为分隔符，您必须在最终到达网址中将其编码为%7C。其他参数使用逗号分隔的值，例如经纬度坐标或城市、州。您必须将英文逗号编码为%2C。使用%20对空格进行编码，或将其替换为加号 (+)。

　　可用的地图操作包括：搜索、路线查询、显示地图和显示街景全景图片。您可以在请求网址中指定操作，以及必需和可选参数。与网址的标准一样，您可以使用“与”符号 (&) 分隔参数。对于每个操作，搜索参数部分会列出参数及其可能的值。

　　搜索操作会显示对可见地图区域进行搜索的结果。搜索特定地点时，生成的地图会在指定位置放置图钉，并显示可用地点详情。

　　您可以通过地点名称、地址或以英文逗号分隔的经纬度坐标来指定位置。字符串应采用网址编码，因此“City Hall, New York, NY”等地址应转换为

　　。如果您尝试明确关联到特定的场所，地点 ID 是确保您关联到正确地点的最佳方式。此外，建议您在使用纬度/经度坐标查询特定地理位置时提交

　　在位置搜索中，您可以使用地点名称、地址或以英文逗号分隔的经纬度坐标搜索特定位置，而生成的地图会在该位置显示图钉。以下三个示例展示了使用不同地点值搜索同一地点的情况。

　　示例 2：仅使用纬度/经度坐标搜索 Lumen Field 会得到以下地图。请注意，地图上有图钉，但地图或侧边栏中未提供其他地点信息：

　　如需以编程方式检索地点 ID，您可以使用Places API：文本搜索（仅返回 ID）功能。 这是获取地点 ID 的免费方法。详细了解地点 IDPlace API（新版）请求。

　　当用户点击或点按地图上的地图注点时，也可以检索地点 ID。详细了解可点击的地图注点图标 (JavaScriptAndroidiOS)

　　在分类搜索中，您传递一个常规搜索字词，Google 地图会尝试在您指定的地点附近查找符合您条件的商家信息。 如果未指定位置，Google 地图会尝试查找您当前位置附近的商家信息。如果您想为分类搜索提供地理位置，请在一般搜索字符串（例如pizza+seattle+wa）中添加地理位置。

　　：定义用于显示路线的起始点。默认为最相关的起始位置，例如设备位置信息（如果可用）。如果没有，生成的地图可能会提供一个空白表单，以便用户输入起点。此值可以是地点名称、地址，也可以是逗号分隔的纬度/经度坐标。字符串应进行网址编码，因此“City Hall, New York, NY”等地址应转换为

　　注意：除非您在网址中指定了origin_place_id，否则此参数为可选参数。如果您选择指定origin_place_id，则还必须在网址中添加origin。

　　（可选）：地点 ID是用于唯一标识地点的文本标识符。如果您尝试明确指定某个商家，使用地点 ID 是确保您关联到正确地点的最佳方式。使用此参数的网址还必须包含

　　：定义方向的终点。如果没有，生成的地图可能会提供一个空白表单，以便用户输入目的地。此值可以是地点名称、地址，也可以是逗号分隔的纬度/经度坐标。字符串应进行网址编码，因此“City Hall, New York, NY”等地址应转换为

　　（可选）：地点 ID是用于唯一标识地点的文本标识符。如果您尝试明确指定某个商家，使用地点 ID 是确保您关联到正确地点的最佳方式。使用此参数的网址还必须包含

　　：优先使用双轮车道（如果有）。 “双轮机动车”是指双轮机动车辆，例如摩托车。如需了解详情，请参阅两轮车保修范围。

　　（可选）：根据起点是否可用，启动精细导航或指定目的地的路线预览。如果用户指定的起点距离用户的当前位置较远，或者当前设备位置不可用，地图会启动路线预览。 如果用户未指定起点（在这种情况下，起点默认为当前设备位置），或者起点靠近用户的当前位置，则地图会启动精细导航。请注意，导航功能并非适用于所有 Google 地图产品和/或所有目的地；在这种情况下，系统会忽略此参数。

　　），从而指定多个航点。允许的航点数量因打开链接的平台而异，移动浏览器最多支持 3 个航点，其他平台最多支持 9 个航点。 路点在地图上的显示顺序与其在网址中的列出顺序相同。 每个航点可以是地点名称、地址或以英文逗号分隔的纬度/经度坐标。字符串应进行网址编码，因此“Berlin,GermanyParis,France”等航点应转换为

　　以下示例会启动一个地图，其中包含从 Google 澳大利亚悉尼办事处到维多利亚女王大厦的步行路线。

　　（必需）：指定要显示的地图视图类型。Google 地图和 Google 街景使用相同的端点。为确保显示地图，必须将

　　（可选）：设置地图的初始缩放级别。 可接受的值为整数，范围介于 0（整个世界）到 21（单个建筑物）之间。上限可能会因所选地点提供的地图数据而异。默认值为 15。

　　借助全景图片操作，您可以启动查看器，以交互式全景图片的形式显示街景图片。每张街景全景图片都提供以单个位置为中心的 360 度全景视图。 图片包含 360 度的水平视图（完整环绕一周）和 180 度垂直视图（从直上至直下）。全景照片操作会启动一个查看器，以镜头为中心将生成的全景照片渲染为一个球面。您可以操纵摄像头来控制摄像头的缩放级别和朝向。

　　Google 街景提供整个覆盖区域内以指定地点为中心的全景视图。您还可以查看用户贡献的 360 度全景照片街景特别集合。

　　位置最近拍摄的全景图，该位置以逗号分隔的纬度/经度坐标指定（例如 46.414382,10.013988）。由于街景图像会定期刷新，并且每次拍摄照片的位置可能略有不同，因此当图像更新时，您的位置可能会跳转到其他全景图片。

　　，则系统不会显示任何全景图片。而是会以默认模式打开 Google 地图，显示以用户当前位置为中心的地图。

　　：指示相机的罗盘方向，以相对于正北方的度数（顺时针）表示。可接受的值介于 -180 到 360 度之间。如果省略，系统会根据查询的视点（如果已指定）和图片的实际位置选择默认标题。

　　：指定相机的向上或向下倾斜角度。 倾斜度以度为单位，范围为 -90 到 90。正值表示相机向上倾斜，负值表示相机向下倾斜。默认的俯仰角为 0，基于拍摄图片时相机的位置设置。因此，倾斜度为 0 通常（但并非总是）表示水平。例如，在小山上拍摄的图片的默认倾斜度多半并非水平。

　　：确定图片的水平视野范围。 视野范围以度为单位，范围为 10-100。默认值为 90。 处理固定大小的视口时，视野范围被视为缩放级别，数字越小表示缩放级别越高。

　　前两个示例显示了埃菲尔铁塔的全景图。示例 1 仅使用viewpoint作为位置，并设置可选的heading、pitch和fov参数。为了进行比较，第二个示例使用panoID 以及第一个示例中设置的相同参数。第三个示例显示了室内全景图片火箭加速器vpn。

　　示例 2：使用panoID 和viewpoint位置。panoID 的优先级高于viewpoint。 在此示例中，系统找到了全景图 ID，因此会忽略viewpoint。请注意，与仅使用viewpoint找到的图片相比，为panoID 显示的全景图片略有不同，并且更新。

　　以下路线示例会启动 Google 地图，并显示从法国巴黎到法国瑟堡的行车路线，路线会经过以下路点：

　　示例 3：将路点定义为城市、国家/地区，并为每个路点中的特定酒店提供waypoint_place_ids：

　　示例 4：将航点定义为城市、国家/地区，但与前面的示例相比，航点的列出顺序有所不同。演示地图会按网址中列出的顺序显示航点。

　　使用 FIFE 图片键作为panoID 显示街景全景图片。请注意，panoID 前面带有F:。

　　为了帮助 Google 更好地了解开发者如何集成 Google 地图网址，并确保最佳效果，我们建议您在构建网址时添加 UTM 跟踪参数。通过添加utm_source和utm_campaign参数，您可以提供有价值的数据，以便我们分析使用情况并改进 Google 地图网址产品。

　　如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据Apache 2.0 许可获得了许可。有关详情，请参阅Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。