本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 靜態地圖
**注意**
靜態映射僅支援標準和衛星樣式。如需詳細資訊，請參閱[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)。
## 常用案例
+ **Web 或行動應用程式中的內嵌地圖：**靜態地圖影像可以有效地內嵌在網站或行動應用程式中，以非互動式地圖提供位置、路由或興趣點的視覺化效果，從而減少載入時間和資料用量。範例包括搜尋引擎 （例如 Yahoo)，顯示具有 POIs 搜尋結果的地圖影像。
+ **電子郵件中的位置詳細資訊：**靜態地圖影像可用來透過電子郵件共用位置資訊，以協助最終使用者了解電子郵件的內容。例如，食品交付或共乘應用程式使用靜態地圖影像，在包含帳單和摘要的往返或交付電子郵件中顯示取件/投遞地點、路由或周邊區域。
+ **行銷資料和列印文件：**自訂靜態地圖影像可以整合到手冊、傳單或其他列印資料中，提供與內容相關的地理資訊視覺效果。
## 了解請求
請求包含選用的 URI 參數，例如 `BoundedPositions`、 `BoundingBox`和 `Center`等，以定義地圖的可見區域和浮水印。定義影像大小`Width`時需要參數 `Height`和 。如需了解詳細資訊，請參閱 [自訂靜態地圖](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 產生的靜態地圖。它涵蓋各種功能，例如調整地圖的位置、大小、語言、縮放、浮水印和歸因，讓您能夠根據特定需求量身打造地圖。
如需詳細資訊，請參閱《*Amazon Location Service API 參考*》中的 [GetStaticMap](https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetStaticMap.html)。
## 位置
位置可讓您定義地圖的中心和邊界。您可以透過設定中心座標、週框方塊，或使用縮放層級來決定要顯示多少區域，來控制地圖的焦點。若要了解其運作方式，請參閱 [如何取得特定位置的靜態映射](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 和精簡的浮水印格式，以提供靈活且有效率的浮水印新增方式。
如需詳細資訊，請參閱《*Amazon Location Service API 參考*》中的 [GetStaticMap](https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetStaticMap.html)。
## 使用 GeoJSON
GeoJSON 是一種多樣化的格式，可讓您在靜態地圖上覆蓋自訂資料。透過定義點、線和多邊形等地理特徵，您可以增強地圖的視覺呈現，為使用者提供有價值的內容。GeoJSON 受到廣泛支援，在設計和自訂地圖浮水印時提供靈活性，使其成為顯示區域、繪製路由或顯示空間關係的理想格式。
透過 Amazon Location Service，您可以利用 GeoJSON 將動態、以位置為基礎的功能直接新增至靜態地圖。這可讓您建立高度可自訂的浮水印，這些浮水印可根據您的特定業務需求量身打造。GeoJSON 支援多種幾何類型，包括 `Point`、`Polygon`、 `LineString`和 `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 會最佳化查詢，但請確保您的請求保持在合理的限制內，特別是在處理多個幾何及其相關聯的屬性時。
## 格式
精簡浮水印格式的結構如下： `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`。這些幾何類型可以使用精簡的浮水印格式，在相同的查詢參數中組合和設計樣式。
## 樣式屬性
您可以使用各種樣式屬性來自訂每個幾何，例如顏色、輪廓顏色、大小等。這些屬性可讓您控制地圖上每個幾何的外觀，確保浮水印符合您的業務需求。