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

# 静态地图
<a name="static-maps"></a>

**注意**  
静态地图仅支持标准和卫星风格。有关更多信息，请参阅 [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)。

## 常见使用案例
<a name="static-maps-use-cases"></a>
+ **Web 或移动应用程序中的嵌入式地图：**静态地图图像能够有效嵌入 Web 或移动应用程序中，通过非交互式地图提供位置、路线或兴趣点的可视化效果，从而减少加载时间和数据使用量。例如，搜索引擎（例如雅虎）显示地图图像以及搜索结果 POIs。
+ **电子邮件中的位置详情：**静态地图图像可用于通过电子邮件共享位置信息，以帮助您的最终用户了解电子邮件的上下文。例如，送餐或拼车应用程序会使用静态地图图像在行程结束后的电子邮件或配送电子邮件中显示取货/送货（或上车/下车）地点、路线或周边区域，并在电子邮件中附上账单和明细。
+ **营销材料和印刷文档：**可以将自定义的静态地图图像整合到宣传册、传单或其他印刷材料中，从而以具有视觉吸引力的形式呈现与内容相关的地理信息。

## 了解请求
<a name="static-maps-understanding-request"></a>

该请求包含可选的 URI 参数（例如 `BoundedPositions`、`BoundingBox` 和 `Center` 等），用于定义地图的可见区域和叠加层。`Height` 和 `Width` 是定义图像尺寸时的必需参数。要了解更多信息，请参阅 [自定义静态地图](customizing-static-maps.md) 和 [静态地图上的叠加](overlaying-static-map.md)。
+ `BoundedPositions`：要包含在图像中的坐标。
+ `BoundingBox`：定义地图西南边缘和东北边缘的坐标。
+ `Height`：指定图像的高度。
+ `Width`：指定图像的宽度。
+ `GeoJsonOverlay`：用于添加叠加层的有效 GeoJSON 对象。

## 了解响应
<a name="static-maps-understanding-response"></a>

该响应包含 `CacheControl`、`ContentType` 和 `ETag` 之类的标头，并以 JPEG 或 PNG 格式的二进制 blob 形式返回静态地图。标头包含静态图像的缓存控制、内容类型和版本等元数据。
+ `CacheControl`：指定地图图像的缓存配置。
+ `ContentType`：表示地图图像的格式（JPEG 或 PNG）。
+ `ETag`：静态地图图像版本的标识符。
+ `Blob`：以 JPEG 或 PNG 格式呈现地图图像。