

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 静态地图上的叠加
<a name="overlaying-static-map"></a>

本节介绍了如何使用 Amazon Location Service 将其他信息叠加到静态地图上。您可以通过添加各种地理特征（例如点、线和多边形）对静态地图进行自定义，以增强地图的可视化表示。Amazon Location Service 支持多种格式，包括 GeoJSON 和紧凑叠加层格式，以提供灵活高效的添加叠加层的方法。

欲了解更多信息，请参阅[GetStaticMap](https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetStaticMap.html)《*亚马逊定位服务 API 参考*》。

## 使用 GeoJSON
<a name="overlaying-static-map-geojson"></a>

GeoJSON 是一种多功能格式，支持在静态地图上叠加自定义数据。通过定义点、线和多边形等地理特征，您可以增强地图的可视化表示，为用户提供有价值的背景信息。GeoJSON 得到了广泛支持，在样式设置和自定义地图叠加层方面具有灵活性，因此是显示区域、绘制路线或展示空间关系的理想格式。

借助 Amazon Location Service，您可以利用 GeoJSON 将基于位置的动态功能直接添加到静态地图上。这样便可创建高度可定制的叠加层，这些叠加层可根据您的特定业务需求进行定制。GeoJSON 支持多种几何类型（包括 `Point`、`LineString`、`Polygon` 和 `MultiPolygon`），允许您显示从标记和路线到复杂区域表示等各种特征。

## 颜色
<a name="overlaying-static-map-geojson-colors"></a>

设置 GeoJSON 特征的样式时，您可以灵活地定义颜色。您可以使用不同的格式指定颜色，例如十六进制值（如 \$1ff0000 代表红色），或使用 alpha 透明度（如 \$1ff000080 表示半透明的红色）。这可确保您的叠加层在视觉上与地图样式保持一致。如果未指定颜色，则系统将应用所选地图样式的默认颜色。

## 绘制顺序
<a name="overlaying-static-map-drawing-order"></a>

自定义叠加层按特定顺序绘制，以保持清晰度，避免视觉混乱。在 Amazon Location Service 中，多边形、线和点等叠加特征将显示在底图上方，但在地图标签下方。绘制顺序优先考虑多边形，其次是线，然后是点或标记。

## 测量单位
<a name="overlaying-static-map-measurement-units"></a>

对于 `width` 和 `outline-width` 之类的属性，您可以使用不同的测量单位来指定大小，包括像素（px）、米（m）、公里（km）、英里（mi）和百分比（%）。百分比单位会根据默认值对属性进行调整，从而为叠加层的样式设置提供更大的灵活性。

## 几何类型
<a name="overlaying-static-map-geometry-types"></a>

Amazon Location Service 支持多种 GeoJSON 几何类型，例如 `Point`、`LineString`、`Polygon` 和 `MultiPolygon`。可以使用 GeoJSON 中的属性对象对每种几何类型进行样式设置和调整，从而可以对地图上的标记、路线和区域进行广泛自定义。

## 使用紧凑叠加层
<a name="overlaying-static-map-compact-overlay"></a>

**注意**  
紧凑叠加层支持以下几何类型：点、线和多边形。它不支持 `multiPoint`、`multiLine` 或 `multiPolgyon`。

借助紧凑叠加层选项，您可以使用单个查询参数在静态地图上高效地显示多个几何体。这种精简方法简化了请求格式并缩小了请求的大小，从而使传输叠加层数据更加方便。客户可以在一个查询参数中输入多种几何类型及其相应的样式属性，Amazon Location Service 将通过按指定方式解析和渲染叠加层来处理这项繁重的工作。

使用紧凑叠加层格式时，请注意，请求 URL 的大小存在限制。尽管 Amazon Location Service 优化了查询，但请确保您的请求保持在合理范围内，尤其是在处理多个几何体及其相关属性时。

## Format
<a name="overlaying-static-map-compact-overlay-format"></a>

紧凑叠加层格式的结构如下：`geometry_type:geometry;property_1=value_1;property_2=value_2|geometry_type:geometry;property_1=value_1...`

每种几何图形类型都与其样式属性一起定义。多个几何体通过管道运算符（\$1）进行分隔，每个几何体的各属性通过分号进行分隔。

## 支持的几何类型
<a name="overlaying-static-map-supported-geometry-types"></a>

Amazon Location Service 支持多种几何类型，包括 `Point`、`MultiPoint`、`LineString`、`Polygon` 和 `MultiPolygon`。这些几何类型可在同一查询参数中使用紧凑叠加层格式进行组合和样式设置。

## 样式属性
<a name="overlaying-static-map-styling-properties"></a>

每个几何体均可使用各种样式属性（如颜色、轮廓颜色、大小等）进行自定义。利用这些属性，您可以控制地图上每个几何体的外观，从而确保叠加层符合您的业务需求。