本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 静态地图
**注意**
静态地图仅支持标准和卫星风格。有关更多信息，请参阅 [AWS 地图样式和功能](map-styles.md)。
静态地图提供地理数据的预渲染展示，您可以根据应用程序的需求，选择叠加标记（或图钉）、路线和多边形区域。静态地图允许您根据可自定义的参数和数据输入，生成静态（非交互式）地图图像。通过自定义叠加层、形状或应用自定义样式，静态地图使您能够创建满足特定需求的地图可视化效果，从而提升最终用户体验并有效地传达地理信息。服务器对请求的地图图像进行自定义，并将其以 JPEG 文件的形式发送给客户端。您可以通过编程方式请求并生成满足您特定要求的地图图像。
*GetStaticMap API* 根据指定参数（例如中心坐标、边界框或叠加层）生成地图的静态图像。该 API 允许对地图功能和样式进行自定义，以便在没有交互式地图功能的 Web 或移动应用程序中使用。
有关更多信息，请参阅[GetStaticMap](https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetStaticMap.html)《*亚马逊定位服务 API 参考*》。
有关此 API 的请求、响应、cURL 和 CLI 命令示例，请参阅[如何使用静态地图](https://docs.aws.amazon.com/location/latest/developerguide/static-maps-how-to.html)。
## 常见使用案例
+ **Web 或移动应用程序中的嵌入式地图：**静态地图图像能够有效嵌入 Web 或移动应用程序中，通过非交互式地图提供位置、路线或兴趣点的可视化效果，从而减少加载时间和数据使用量。例如，搜索引擎（例如雅虎）显示地图图像以及搜索结果 POIs。
+ **电子邮件中的位置详情：**静态地图图像可用于通过电子邮件共享位置信息，以帮助您的最终用户了解电子邮件的上下文。例如，送餐或拼车应用程序会使用静态地图图像在行程结束后的电子邮件或配送电子邮件中显示取货/送货（或上车/下车）地点、路线或周边区域，并在电子邮件中附上账单和明细。
+ **营销材料和印刷文档：**可以将自定义的静态地图图像整合到宣传册、传单或其他印刷材料中，从而以具有视觉吸引力的形式呈现与内容相关的地理信息。
## 了解请求
该请求包含可选的 URI 参数（例如 `BoundedPositions`、`BoundingBox` 和 `Center` 等），用于定义地图的可见区域和叠加层。`Height` 和 `Width` 是定义图像尺寸时的必需参数。要了解更多信息，请参阅 [自定义静态地图](customizing-static-maps.md) 和 [静态地图上的叠加](overlaying-static-map.md)。
+ `BoundedPositions`：要包含在图像中的坐标。
+ `BoundingBox`：定义地图西南边缘和东北边缘的坐标。
+ `Height`：指定图像的高度。
+ `Width`：指定图像的宽度。
+ `GeoJsonOverlay`：用于添加叠加层的有效 GeoJSON 对象。
## 了解响应
该响应包含 `CacheControl`、`ContentType` 和 `ETag` 之类的标头，并以 JPEG 或 PNG 格式的二进制 blob 形式返回静态地图。标头包含静态图像的缓存控制、内容类型和版本等元数据。
+ `CacheControl`：指定地图图像的缓存配置。
+ `ContentType`：表示地图图像的格式（JPEG 或 PNG）。
+ `ETag`：静态地图图像版本的标识符。
+ `Blob`：以 JPEG 或 PNG 格式呈现地图图像。
# 自定义静态地图
**注意**
静态地图仅支持卫星样式。有关更多信息，请参阅 [AWS 地图样式和功能](map-styles.md)。
本节概述了如何对使用 Amazon Location Service 生成的静态地图进行自定义。它涵盖了多种功能，例如调整地图的位置、大小、语言、比例尺、叠加层和属性，使您可以根据自身的具体要求定制地图。
欲了解更多信息，请参阅[GetStaticMap](https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetStaticMap.html)《*亚马逊定位服务 API 参考*》。
## 位置
位置支持定义地图的中心和边界。您可以通过设置中心坐标、边界框或使用缩放级别来控制地图的焦点，从而确定要显示的区域范围。要了解其工作原理，请参阅[如何获取特定位置的静态地图](get-static-map-specific-position.md)。
+ `Center`：使用经度和纬度坐标来确定地图的中心点。
+ `Radius`：指定将在静态地图上显示的半径（与中心的距离）。
+ `Bounding Box`：定义地图上的一个矩形区域，通过提供左上角和右下角的坐标进行设置。
+ `Zoom`：控制地图的缩放级别。较高缩放级别能在较小区域内显示较多细节，而较低缩放级别则在较大区域内显示较少细节。
## 尺寸和质量
您可以通过设定静态地图的尺寸（高度和宽度）和添加填充来对静态地图的大小和视觉质量进行自定义，从而更好地呈现标记和其他元素。要了解其工作原理，请参阅[如何获取特定尺寸的静态地图](get-static-map-specific-dimension.md)。
+ `Height and Width`：通过定义静态地图图像的高度和宽度（以像素为单位）来指定其大小。
+ `Padding`：在地图边缘周围添加额外空间，以便在放置标记、线条或形状时能有更好的可视化效果。
## 比例尺
比例尺能够控制地图的比例，并确定测量距离的单位（公里、英里）。这有助于准确呈现地图的大小和距离关系。要了解其工作原理，请参阅[如何为静态地图添加比例尺](add-scale-static-map.md)。
+ `Scale Unit`：定义地图比例尺的单位（例如，公里或英里），让用户能够准确测量地图上的距离。
## 叠加层
您可以添加标记、用于显示路线的线条、用于显示区域的多边形等。要了解其工作原理，请参阅[如何向静态地图添加标记](add-marker-static-map.md)、[如何向静态地图添加线条](how-to-add-line-static.md)或[如何向静态地图添加路线](how-to-add-route.md)。
# 静态地图上的叠加
本节介绍了如何使用 Amazon Location Service 将其他信息叠加到静态地图上。您可以通过添加各种地理特征（例如点、线和多边形）对静态地图进行自定义，以增强地图的可视化表示。Amazon Location Service 支持多种格式，包括 GeoJSON 和紧凑叠加层格式，以提供灵活高效的添加叠加层的方法。
欲了解更多信息，请参阅[GetStaticMap](https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetStaticMap.html)《*亚马逊定位服务 API 参考*》。
## 使用 GeoJSON
GeoJSON 是一种多功能格式，支持在静态地图上叠加自定义数据。通过定义点、线和多边形等地理特征，您可以增强地图的可视化表示，为用户提供有价值的背景信息。GeoJSON 得到了广泛支持，在样式设置和自定义地图叠加层方面具有灵活性，因此是显示区域、绘制路线或展示空间关系的理想格式。
借助 Amazon Location Service，您可以利用 GeoJSON 将基于位置的动态功能直接添加到静态地图上。这样便可创建高度可定制的叠加层，这些叠加层可根据您的特定业务需求进行定制。GeoJSON 支持多种几何类型（包括 `Point`、`LineString`、`Polygon` 和 `MultiPolygon`），允许您显示从标记和路线到复杂区域表示等各种特征。
## 颜色
设置 GeoJSON 特征的样式时，您可以灵活地定义颜色。您可以使用不同的格式指定颜色，例如十六进制值（如 \$1ff0000 代表红色），或使用 alpha 透明度（如 \$1ff000080 表示半透明的红色）。这可确保您的叠加层在视觉上与地图样式保持一致。如果未指定颜色，则系统将应用所选地图样式的默认颜色。
## 绘制顺序
自定义叠加层按特定顺序绘制，以保持清晰度，避免视觉混乱。在 Amazon Location Service 中，多边形、线和点等叠加特征将显示在底图上方，但在地图标签下方。绘制顺序优先考虑多边形，其次是线，然后是点或标记。
## 测量单位
对于 `width` 和 `outline-width` 之类的属性，您可以使用不同的测量单位来指定大小，包括像素（px）、米（m）、公里（km）、英里（mi）和百分比（%）。百分比单位会根据默认值对属性进行调整，从而为叠加层的样式设置提供更大的灵活性。
## 几何类型
Amazon Location Service 支持多种 GeoJSON 几何类型，例如 `Point`、`LineString`、`Polygon` 和 `MultiPolygon`。可以使用 GeoJSON 中的属性对象对每种几何类型进行样式设置和调整，从而可以对地图上的标记、路线和区域进行广泛自定义。
## 使用紧凑叠加层
**注意**
紧凑叠加层支持以下几何类型：点、线和多边形。它不支持 `multiPoint`、`multiLine` 或 `multiPolgyon`。
借助紧凑叠加层选项，您可以使用单个查询参数在静态地图上高效地显示多个几何体。这种精简方法简化了请求格式并缩小了请求的大小，从而使传输叠加层数据更加方便。客户可以在一个查询参数中输入多种几何类型及其相应的样式属性，Amazon Location Service 将通过按指定方式解析和渲染叠加层来处理这项繁重的工作。
使用紧凑叠加层格式时，请注意，请求 URL 的大小存在限制。尽管 Amazon Location Service 优化了查询，但请确保您的请求保持在合理范围内，尤其是在处理多个几何体及其相关属性时。
## Format
紧凑叠加层格式的结构如下：`geometry_type:geometry;property_1=value_1;property_2=value_2|geometry_type:geometry;property_1=value_1...`
每种几何图形类型都与其样式属性一起定义。多个几何体通过管道运算符（\$1）进行分隔，每个几何体的各属性通过分号进行分隔。
## 支持的几何类型
Amazon Location Service 支持多种几何类型，包括 `Point`、`MultiPoint`、`LineString`、`Polygon` 和 `MultiPolygon`。这些几何类型可在同一查询参数中使用紧凑叠加层格式进行组合和样式设置。
## 样式属性
每个几何体均可使用各种样式属性（如颜色、轮廓颜色、大小等）进行自定义。利用这些属性，您可以控制地图上每个几何体的外观，从而确保叠加层符合您的业务需求。