Render - Get Map Static Image

string

Azure Maps API 的版本号。 当前版本为 2024-04-01。

number[]

边界框由表示地球上矩形区域的四边的两个纬度和两个经度定义。 格式：“minLon，minLat，maxLon，maxLat” (双) 。

注意：bbox 或 center 是必需参数。 它们是相互排斥的。 bbox 不应与高度或宽度一起使用。

Lat 和 Lon 允许的最大范围和最小范围是在此页顶部的表格中为每个缩放级别定义的。

number[]

中心点的坐标（以双精度表示）。 格式：“lon，lat”。 经度范围：-180 到 180。 纬度范围：-90 到 90。

注意：center 或 bbox 都是必需参数。 它们是相互排斥的。

integer

生成的图像的高度（以像素为单位）。 范围为 80 到 1500。 默认值为 512。 它不应与 bbox 一起使用。

string

返回搜索结果时应采用的语言。 应是受支持的 IETF 语言标记之一，不区分大小写。 当指定语言的数据不适用于特定字段时，将使用默认语言。

有关详细信息，请参阅 支持的语言 。

string[]

双) (路径样式和位置。 使用此参数可以选择向图像添加线条、多边形或圆。 路径样式描述线条和填充的外观。 (请确保正确对此参数的值进行 URL 编码，因为它将包含保留字符，例如管道和标点符号.)

从 S1 开始，Azure Maps 帐户 SKU 支持 Path 参数。 路径参数的多个实例允许指定多个几何图形及其样式。 每个请求的参数数限制为 10 个，每个路径的位置数限制为 100 个。

若要使用默认样式呈现半径为 100 米且中心点位于纬度 45°N 和经度 122°W 的圆，请添加 querystring 参数

path=ra100||-122 45

请注意，经度在纬度之前。 URL 编码后，如下所示

path=ra100%7C%7C-122+45

为清楚起见，此处的所有示例都演示了不带 URL 编码的路径参数。

若要呈现线条，请使用管道字符分隔每个位置。 例如，使用

path=||-122 45|-119.5 43.2|-121.67 47.12

使用封闭路径指定多边形，其中第一个点和最后一个点相等。 例如，使用

path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45

线条和多边形位置的经度值可以介于 -360 到 360 之间，以便呈现穿越反子午线的几何图形。

样式修饰符

可以通过添加样式修饰符来修改路径的外观。 这些位置在位置之前添加。 每个样式修饰符都有一个双字母名称。 这些缩写名称用于帮助减少 URL 的长度。

若要更改轮廓的颜色，请使用“lc”样式修饰符，并使用 HTML/CSS RGB 颜色格式指定颜色，该格式为六位数十六进制数， (三位数格式不受支持) 。 例如，若要使用在 CSS 中指定为 #FF1493 的深粉色，请使用

path=lcFF1493||-122 45|-119.5 43.2

可以组合多个样式修饰符来创建更复杂的视觉样式。

lc0000FF|lw3|la0.60|fa0.50||-122.2 47.6|-122.2 47.7|-122.3 47.7|-122.3 47.6|-122.2 47.6

样式修饰符摘要

string[]

图钉样式和实例。 使用此参数可以选择性地将图钉添加到映像。 图钉样式描述图钉的外观，实例以双) 和每个图钉的可选标签指定 (图钉的坐标。 (请确保对此参数的值正确进行 URL 编码，因为它将包含保留字符，如管道和标点符号.)

Azure Maps 帐户 S0 SKU 仅支持 pins 参数的单个实例。 其他 SKU 允许 pins 参数的多个实例指定多个图钉样式。

若要使用默认的内置图钉样式在纬度 45°N 和经度 122°W 呈现图钉，请添加 querystring 参数

pins=default||-122 45

请注意，经度在纬度之前。 URL 编码后，如下所示

pins=default%7C%7C-122+45

为清楚起见，此处的所有示例都显示了不带 URL 编码的 pins 参数。

若要在多个位置呈现图钉，请使用管道字符分隔每个位置。 例如，使用

pins=default||-122 45|-119.5 43.2|-121.67 47.12

S0 Azure Maps 帐户 SKU 仅允许五个图钉。 其他帐户 SKU 没有此限制。

样式修饰符

可以通过添加样式修饰符来修改图钉的外观。 它们添加到样式之后，但在位置和标签之前。 每个样式修饰符都有一个两个字母的名称。 这些缩写名称用于帮助缩短 URL 的长度。

若要更改图钉的颜色，请使用“co”样式修饰符，并使用 HTML/CSS RGB 颜色格式指定颜色，该格式为六位数十六进制数 (三位数格式) 不受支持。 例如，若要使用在 CSS 中指定为 #FF1493 的深粉色，请使用

pins=default|coFF1493||-122 45

图钉标签

若要向图钉添加标签，请将标签放在坐标前的单引号中。 避免在标签中使用特殊字符，如 | 或 || 。 例如，若要使用值“1”、“2”和“3”标记三个引脚，请使用

pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12

有一个名为“none”的内置图钉样式，它不显示图钉图像。 如果要显示不带任何固定图像的标签，可以使用此选项。 例如，

pins=none||'A'-122 45|'B'-119.5 43.2

若要更改图钉标签的颜色，请使用“lc”标签颜色样式修饰符。 例如，若要使用带有黑色标签的粉红色图钉，请使用

pins=default|coFF1493|lc000000||-122 45

若要更改标签的大小，请使用“ls”标签大小样式修饰符。 标签大小表示标签文本的大致高度（以像素为单位）。 例如，若要将标签大小增加到 12，请使用

pins=default|ls12||'A'-122 45|'B'-119 43

标签以图钉“标签定位点”为中心。 定位点位置为内置图钉预定义，位于自定义图钉的顶部中心， (请参阅下面的) 。 若要替代标签定位点，请使用“la”样式修饰符并为定位点提供 X 和 Y 像素坐标。 这些坐标相对于图钉图像的左上角。 正 X 值将定位点向右移动，正 Y 值将定位点向下移动。 例如，若要将标签定位点置于图钉图像左上角 10 像素和 4 像素上方，请使用

pins=default|la10 -4||'A'-122 45|'B'-119 43

自定义图钉

若要使用自定义图钉图像，请使用单词“custom”作为固定样式名称，然后在位置和标签信息后指定 URL。 自定义标签图像允许的最大大小为 65,536 像素。 使用两个管道字符指示你已完成指定位置并正在启动 URL。 例如，

pins=custom||-122 45||http://contoso.com/pushpins/red.png

URL 编码后，如下所示

pins=custom%7C%7C-122+45%7C%7Chttp%3A%2F%2Fcontoso.com%2Fpushpins%2Fred.png

默认情况下，自定义图钉图像以固定坐标居中绘制。 这通常并不理想，因为它会遮盖你尝试突出显示的位置。 若要替代固定图像的定位点位置，请使用“an”样式修饰符。 这使用与“la”标签定位点样式修饰符相同的格式。 例如，如果自定义固定图像的图钉尖位于图像的左上角，则可以使用 将定位点设置为该点

pins=custom|an0 0||-122 45||http://contoso.com/pushpins/red.png

注意：如果将“co”颜色修饰符用于自定义图钉图像，则指定的颜色将替换图像中像素的 RGB 通道，但将 alpha (不透明度) 通道保持不变。 这通常只能使用纯色自定义图像来完成。

缩放、旋转和不透明度

可以使用“sc”缩放样式修改器使图钉及其标签变得更大或更小。 这是一个大于零的值。 值为 1 即为标准比例。 大于 1 的值将使图钉变大，而小于 1 的值将使图钉变小。 例如，若要绘制比平时大 50% 的图钉，请使用

pins=default|sc1.5||-122 45

可以使用“ro”旋转样式修饰符旋转图钉及其标签。 这是顺时针旋转的多个度数。 使用负数逆时针旋转。 例如，若要将图钉顺时针旋转 90 度并增加其大小，请使用

pins=default|ro90|sc2||-122 45

可以通过指定“al”alpha 样式修饰符，使图钉及其标签部分透明。 这是一个介于 0 和 1 之间的数字，表示图钉的不透明度。 0 使它们 (完全透明，) 不可见，1 使它们完全不透明 (这是默认) 。 例如，若要使图钉及其标签仅 67% 不透明，请使用

pins=default|al.67||-122 45

样式修饰符摘要

• X 和 Y 坐标可以是固定图像中的任何位置，也可以是其周围的边距。 边距大小是引脚宽度和高度的最小值。

TilesetId

要返回的地图样式。 可能的值为 microsoft.base.road、microsoft.base.darkgrey 和 microsoft.imagery。 默认值设置为 microsoft.base.road。 有关详细信息，请参阅 Render TilesetId。

TrafficTilesetId

可选值，指示图像结果上没有覆盖任何流量流。 可能的值为 microsoft.traffic.relative.main 和 none。 默认值为 none，表示未返回任何流量流。 如果提供了与流量相关的 tilesetId， 将返回具有相应流量层的地图图像。 有关详细信息，请参阅 Render TilesetId。

LocalizedMapView

View 参数 (也称为“用户区域”参数) 允许你为地缘政治争议区域显示特定国家/地区的正确地图。 不同的国家/地区对此类区域有不同的视图，并且 View 参数允许应用程序符合应用程序将服务的国家/地区所需的视图。 默认情况下，View 参数设置为“Unified”，即使尚未在请求中定义它。 由你负责确定用户的位置，然后为该位置正确设置 View 参数。 或者，可以选择设置“View=Auto”，这将基于请求的 IP 地址返回地图数据。 Azure Maps 中的 View 参数的使用必须符合适用的法律，包括有关地图、图像和其他数据以及你有权通过 Azure Maps 访问的第三方内容的国家/地区的法律。 示例：view=IN。

有关详细信息和可用的 视图 ，请参阅支持的视图。

integer

生成的图像的宽度（以像素为单位）。 范围为 80 到 2000。 默认值为 512。 它不应与 bbox 一起使用。

integer

所需的地图缩放级别。 对于 tilesetId 为 microsoft.base.road 或 microsoft.base.darkgrey，支持从 0 到 20 (（含 0 到 20 个）的缩放值（包括) ）。 支持将 tilesetId 设置为 microsoft.imagery 的缩放值范围为 0-19 (非独占) 。 默认值为 12。

有关详细信息，请参阅 缩放级别和平铺网格。