本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 靜態地圖
<a name="static-maps"></a>

**注意**  
靜態映射僅支援標準和衛星樣式。如需詳細資訊，請參閱[AWS 映射樣式和功能](map-styles.md)。

靜態貼圖提供地理資料的預先轉譯表示法，並可選擇為您的應用程式覆蓋標記 （或接腳）、路由和多邊形區域。靜態映射可讓您根據可自訂的參數和資料輸入產生靜態 （非互動式） 映射映像。透過自訂浮水印、形狀或套用自訂樣式，Static Map 可讓您建立符合特定需求的地圖視覺化效果，增強最終使用者體驗並有效傳達地理資訊。伺服器會自訂請求的映射映像，並以 JPEG 檔案的形式將其交付給用戶端。您可以程式設計方式請求和產生根據您的特定需求量身打造的地圖影像。

*GetStaticMap API* 會根據中心座標、週框方塊或浮水印等指定參數產生地圖的靜態影像。API 允許自訂地圖功能和樣式，可在沒有互動式地圖功能的 Web 或行動應用程式中使用。

如需詳細資訊，請參閱《*Amazon Location Service API 參考*》中的 [GetStaticMap](https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetStaticMap.html)。

如需此 API 的請求、回應、cURL 和 CLI 命令範例，請參閱[如何使用靜態映射](https://docs.aws.amazon.com/location/latest/developerguide/static-maps-how-to.html)。

## 常用案例
<a name="static-maps-use-cases"></a>
+ **Web 或行動應用程式中的內嵌地圖：**靜態地圖影像可以有效地內嵌在網站或行動應用程式中，以非互動式地圖提供位置、路由或興趣點的視覺化效果，從而減少載入時間和資料用量。範例包括搜尋引擎 （例如 Yahoo)，顯示具有 POIs 搜尋結果的地圖影像。
+ **電子郵件中的位置詳細資訊：**靜態地圖影像可用來透過電子郵件共用位置資訊，以協助最終使用者了解電子郵件的內容。例如，食品交付或共乘應用程式使用靜態地圖影像，在包含帳單和摘要的往返或交付電子郵件中顯示取件/投遞地點、路由或周邊區域。
+ **行銷資料和列印文件：**自訂靜態地圖影像可以整合到手冊、傳單或其他列印資料中，提供與內容相關的地理資訊視覺效果。

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

請求包含選用的 URI 參數，例如 `BoundedPositions`、 `BoundingBox`和 `Center`等，以定義地圖的可見區域和浮水印。定義影像大小`Width`時需要參數 `Height`和 。如需了解詳細資訊，請參閱 [自訂靜態地圖](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 格式的映射影像。