先決條件

在應用程式中顯示地圖之前，請遵循先決條件步驟：

建立地圖資源

要在應用程序中使用地圖，您必須具有地圖資源，該資源指定要在地圖中使用的地圖樣式和數據提供程序。

注意

如果您的應用程式正在對業務中使用的資產 (例如送貨車輛或員工) 進行追蹤或路線規劃，則不得使用 Esri 作為地理位置提供者。如需詳細資訊，請參閱 AWS 服務條款第 82 條。

您可以使用 Amazon 定位服務主控台AWS CLI、或 Amazon 位置 API 建立地圖資源。

Console

使用 Amazon 定位服務主控台建立地圖資源

1. 在 Amazon 位置主控台的「地圖」頁面上，選擇「建立地圖」以預覽地圖樣式。

2. 為新地圖資源新增名稱和描述。

3. 選擇地圖樣式。

   注意

   如果您的應用程式正在對業務中使用的資產 (例如送貨車輛或員工) 進行追蹤或路線規劃，則不得使用 Esri 作為地理位置提供者。如需詳細資訊，請參閱 AWS 服務條款第 82 條。

4. 從政治觀點要使用的中選擇。

5. 同意 Amazon 位置條款與條件，然後選擇「建立地圖」。您可以與選擇的地圖互動：放大、縮小或向任何方向平移。

6. 若要允許使用者切換樣式 (例如，要允許他們在衛星影像和向量樣式之間切換)，您必須為每個樣式建立地圖資源。

   您可以刪除不想在主控台的 [地圖] 首頁上使用的具有地圖樣式的資源。

API

使用亞馬遜位置 API 建立地圖資源

使用來自亞馬遜位置 API 的CreateMap操作。

下列範例是建立ExampleMap使用地VectorEsriStreets圖樣式呼叫的對應資源的 API 要求。

POST /maps/v0/maps HTTP/1.1
Content-type: application/json

{
   "Configuration": { 
      "Style": "VectorEsriStreets"
   },
   "MapName": "ExampleMap"
   }
}

注意

如果您的應用程式正在對業務中使用的資產 (例如送貨車輛或員工) 進行追蹤或路線規劃，則不得使用 Esri 作為地理位置提供者。如需詳細資訊，請參閱 AWS 服務條款第 82 條。

AWS CLI

使用指令建立地圖資源的AWS CLI步驟

使用 create-map 命令。

下列範例會建立稱為ExampleMap地圖樣式的對映資源。VectorEsriStreets

aws location \
  create-map \
  --configuration Style="VectorEsriStreets" \
  --map-name "ExampleMap"

注意

如果您的應用程式正在對業務中使用的資產 (例如送貨車輛或員工) 進行追蹤或路線規劃，則不得使用 Esri 作為地理位置提供者。如需詳細資訊，請參閱 AWS 服務條款第 82 條。

驗證您的請求

建立地圖資源並準備好開始在應用程式中建置位置功能後，您需要選擇驗證請求的方式。

注意

大多數地圖前端應用程式都需要未經驗證存取地圖或 Amazon 定位服務的其他功能。視應用程式而定，您可能想要使用AWS簽名 v4 來驗證請求，或者您可以使用 Amazon Cognito 或 Amazon 位置 API 金鑰進行未經驗證的使用。若要深入瞭解所有這些選項，請參閱授予對亞馬遜定位服務的訪問。