添加地理圍欄 - Amazon Location Service
建立地理圍欄集合繪製地理圍欄添加多邊形地理圍欄添加循環地理圍欄

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

添加地理圍欄

地理圍欄包含形成封閉邊界的點和頂點，它定義了感興趣的區域。地理圍欄集合存儲和管理一個或多個地理圍欄。

Amazon 位置地理圍欄集合會儲存使用稱為 Geo (7946) 的標準地理空間資料格式定義的地理JSON圍欄。RFC您可以免費使用諸如 geojson.io 之類的工具以圖形方式繪製地理圍欄並保存輸出的 Geo 文件。JSON

注意

Amazon Location 不支援跨越反經絡的孔、多重多邊形、順時針多邊形和地理圍欄的多邊形。

建立地理圍欄集合

使用 Amazon 位置主控台、或 Amazon 位置，建立地理圍欄集合以存放和管理地理圍欄。 AWS CLI APIs

Console

若要使用 Amazon 位置主控台建立地理圍欄集合

  1. 打開 Amazon 定 Location Service 主控台，網址為https://console.aws.amazon.com/location/。

  2. 在左側導覽窗格中，選擇「地理圍欄集合」。

  3. 選擇 [建立地理圍欄集合]。

  4. 填寫下列方塊：

    • 名稱 — 輸入唯一的名稱。例如 ExampleGeofenceCollection。 最多可輸入 100 個字元 有效的項目包括英數字元、連字號、句號和底線。

    • 說明 — 輸入可選描述以區分您的資源。

  5. 在以 CloudWatch 作為目標的EventBridge 規則下，您可以創建一個可選 EventBridge 規則以開始對地理圍欄事件做出反應。這使 Amazon 位置能夠將事件發佈到 Amazon CloudWatch 日誌。

  6. (選用) 在 Tags (標籤) 底下，輸入標籤 Key (金鑰) 與 Value (值)。這將為您的新地理圍欄集合添加一個標籤。如需詳細資訊，請參閱標記您的 Amazon Location Service 資源。

  7. (選擇性) 在客戶受管金鑰加密底下，您可以選擇新增客戶管理的金鑰。這會新增您透過預設 AWS 擁有的加密建立、擁有和管理的對稱客戶管理金鑰。如需詳細資訊，請參閱加密靜態資料。

  8. 選擇 [建立地理圍欄集合]。

API

使用 Amazon 位置創建地理圍欄集合 APIs

使用來自 Amazon 位置地理圍欄APIs的CreateGeofenceCollection操作。

下面的例子使用一個API請求來創建一個名為的地理圍欄集合 ExampleGeofenceCollection。 地理圍欄集合與客戶管理的 AWS KMS 金鑰相關聯，以加密客戶資料。

POST /geofencing/v0/collections
Content-type: application/json

{
   "CollectionName": "ExampleGeofenceCollection",
   "Description": "Geofence collection 1 for shopping center",
   "KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
   "Tags": { 
      "Tag1" : "Value1"
   }
}
AWS CLI

使用指令建立地理圍欄集合的步驟 AWS CLI

使用 create-geofence-collection 命令。

下列範例使用建立 AWS CLI 稱為的地理圍欄集合 ExampleGeofenceCollection。 地理圍欄集合與客戶管理的 AWS KMS 金鑰相關聯，以加密客戶資料。

aws location \
  create-geofence-collection \
  --collection-name "ExampleGeofenceCollection" \
  --description "Shopping center geofence collection" \
  --kms-key-id "1234abcd-12ab-34cd-56ef-1234567890ab" \
  --tags Tag1=Value1
注意

帳單取決於您的使用情況。您可能會因使用其他 AWS 服務而產生費用。如需詳細資訊，請參閱 Amazon 定 Location Service 定價。

繪製地理圍欄

現在您已經建立了地理圍欄集合，您可以定義地理圍欄。地理圍欄被定義為多邊形或圓形。要繪製多邊形地理圍欄，您可以使用地理JSON編輯工具，例如 geojson.io。

若要將地理圍欄建立為圓，您必須定義圓的中心點和半徑。例如，如果您想要建立地理圍欄，以便在設備距離特定位置 50 公尺以內時收到通知，則可以使用該位置的緯度和經度，並將半徑指定為 50 公尺。

使用 Amazon 定 Location ServiceAPIs，您還可以以鍵值對的形式將中繼資料新增至地理圍欄。這些對於存儲地理圍欄的信息（例如其類型或其他應用程序特定的信息）非常有用。您可以在何時使用此中繼資料使用 Amazon 對 Amazon 定 Location Service 事件做出反應 EventBridge。

添加多邊形地理圍欄

本節介紹創建多邊形地理圍欄

使用地理工具繪製地理圍欄 JSON

現在您已經建立了地理圍欄集合，您可以使用 Geo JSON 編輯工具 (例如 geojson.io) 來定義地理圍欄。

若要建立地理JSON檔案

  1. 開啟地理JSON編輯工具。例如，巨星 .io。

  2. 選擇繪製多邊形圖標並繪製您感興趣的區域。

  3. 選擇「儲存」，然後JSON從下拉式選單中選擇「地理」。

將地理圍欄放入JSON地理圍欄集合

您可以使用產生的 Geo JSON 檔案，使用 Amazon 定位服務主控台、或 Amazon 位置來上傳 AWS CLI地理圍欄：APIs

Console

使用 Amazon 定位服務主控台將地理圍欄新增至 Location Service 圍欄集合

  1. 打開 Amazon 定 Location Service 主控台，網址為https://console.aws.amazon.com/location/。

  2. 在左側導覽窗格中，選擇「地理圍欄集合」。

  3. 從「地理圍欄」集合清單中，選取目標地理圍欄集合的名稱連結。

  4. 在「地理圍欄」下，選擇「建立地理圍欄」。

  5. 在「新增地理圍欄」視窗中，將 Ge o 拖放JSON到視窗中。

  6. 選擇 [新增地理圍欄]。

API

使用 Amazon 位置添加地理圍欄 APIs

使用來自 Amazon 位置地理圍欄APIs的PutGeofence操作。

以下示例使用API請求添加給定 ID 的地理圍欄 GEOFENCE-EXAMPLE1 到一個名為的地理圍欄集合 ExampleGeofenceCollection。 它還使用鍵Type和值指定單個地理圍欄元數據屬性。loadingArea

PUT /geofencing/v0/collections/ExampleGeofenceCollection/geofence/GEOFENCE-EXAMPLE1
    Content-type: application/json
    
    {
       "GeofenceProperties": {
          "Type" : "loadingArea"
       },
       "Geometry": { 
          "Polygon": [   
            [
                [-5.716667, -15.933333],
                [-14.416667, -7.933333],
                [-12.316667, -37.066667],
                [-5.716667, -15.933333]
            ]
          ]
       }
    }

或者，您可以使用該BatchPutGeofence操作添加多個地理圍欄。

POST /geofencing/v0/collections/ExampleGeofenceCollection/put-geofences
    Content-type: application/json
    
    {
       "Entries": [ 
          {
             "GeofenceProperties": {
                "Type" : "loadingArea"
             },
             "GeofenceId": "GEOFENCE-EXAMPLE1",
             "Geometry": { 
                "Polygon": [ 
                   [ 
                      [-5.716667, -15.933333],
                      [-14.416667, -7.933333],
                      [-12.316667, -37.066667],
                      [-5.716667, -15.933333]
                   ]
                ]
             }
          }
       ]
    }
AWS CLI

使用指令將地理圍欄加入至地理圍欄集合的步驟 AWS CLI

使用 put-geofence 命令。

下列範例會使用將地理圍欄新增 AWS CLI 至名為的地理圍欄集合 ExampleGeofenceCollection.

$ aws location \
        put-geofence \
            --collection-name ExampleGeofenceCollection \
            --geofence-id ExampleGeofenceTriangle \
            --geofence-properties '{"Type": "loadingArea"}' \
            --geometry 'Polygon=[[[-5.716667, -15.933333],[-14.416667, -7.933333],[-12.316667, -37.066667],[-5.716667, -15.933333]]]'
    {
        "CreateTime": "2020-11-11T00:16:14.487000+00:00",
        "GeofenceId": "ExampleGeofenceTriangle",
        "UpdateTime": "2020-11-11T00:19:59.894000+00:00"
    }

添加循環地理圍欄

本節介紹創建循環地理圍欄。您必須知道要做為圓心點的緯度和經度，以及圓的半徑（以米為單位）。您可以使用 Amazon 位置APIs或. AWS CLI

API

使用 Amazon 位置添加圓形地理圍欄 APIs

使用來自 Amazon 位置地理圍欄APIs的PutGeofence操作。

以下示例使用API請求添加給定 ID 的地理圍欄 GEOFENCE-EXAMPLE2 到一個名為的地理圍欄集合 ExampleGeofenceCollection:

PUT /geofencing/v0/collections/ExampleGeofenceCollection/geofence/GEOFENCE-EXAMPLE2
    Content-type: application/json
    
    {
       "Geometry": { 
          "Circle": {   
            "Center": [-5.716667, -15.933333],
            "Radius": 50
          }
       }
    }
AWS CLI

使用指令將圓形地理圍欄加入至地理圍欄集合的步驟 AWS CLI

使用 put-geofence 命令。

下列範例會使用將地理圍欄新增 AWS CLI 至名為的地理圍欄集合 ExampleGeofenceCollection.

$ aws location \
        put-geofence \
            --collection-name ExampleGeofenceCollection \
            --geofence-id ExampleGeofenceCircle \
            --geometry 'Circle={Center=[-5.716667, -15.933333], Radius=50}'
注意

您也可以將複雜JSON的幾何圖形放入其自己的檔案中，如下列範例所示。

$ aws location \
        put-geofence \
            --collection-name ExampleGeofenceCollection \
            --geofence-id ExampleGeofenceCircle \
            --geometry file:circle.json

在此範例中，圓形 .json 檔案包含圓幾何圖形JSON的檔案。

{
    "Circle": {
        "Center": [-74.006975, 40.717127],
        "Radius": 287.7897969218057
    }
}