根據地理圍欄評估設備位置 - Amazon Location Service

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

根據地理圍欄評估設備位置

有兩種方式可以根據地理柵欄評估位置以產生地理柵欄事件:

  • 您可以連結追蹤器和地理圍欄集合。如需詳細資訊,請參閱一節:將追蹤器連結至地理圍欄集合

  • 您可以直接向地理圍欄集合資源發出請求,以評估一個或多個職位。

如果您還想跟踪設備的位置歷史記錄或在地圖上顯示位置,請將跟踪器與地理圍欄集合鏈接。或者,您可能不想評估所有位置更新,或者您不打算將位置數據存儲在跟踪器資源中。如果是這種情況之一,則可以直接向地理圍欄集合發出請求,並根據其地理圍欄評估一個或多個設備位置。

針對地理圍欄評估設備位置會產生事件。您可以對這些事件做出反應並將事件路由到其他事件AWS服務。如需接收地理圍欄事件時可採取之動作的詳細資訊,請參閱使用 Amazon Location Service 事件 EventBridge

Amazon Location 事件包括產生該事件的裝置位置更新的屬性,包括時間、位置、準確性和鍵值中繼資料,以及輸入或退出的地理圍欄的某些屬性。如需地理柵欄事件內所含資料的詳細資訊,請參閱亞馬遜 EventBridge Amazon Location Service 的事件範例

以下範例例使用AWS CLI,或亞馬遜位置 API。

API

使用 Amazon Location API 評估裝置位置

使用BatchEvaluateGeofences從亞馬遜位置地理圍欄 API 進行操作。

以下示例使用 API 請求來評估設備的位置ExampleDevice到關聯的地理圍欄集合ExampleGeofenceCollection

POST /geofencing/v0/collections/ExampleGeofenceCollection/positions HTTP/1.1 Content-type: application/json { "DevicePositionUpdates": [ { "DeviceId": "ExampleDevice", "Position": [-123.123, 47.123], "SampleTime": "2021-11-30T21:47:25.149Z", "Accuracy": { "Horizontal": 10.30 }, "PositionProperties": { "field1": "value1", "field2": "value2" } } ] }
AWS CLI

要根據地理柵欄的位置評估裝置位置AWS CLI命令

使用 batch-evaluate-geofences 命令。

下列的例子使用AWS CLI評估的位置ExampleDevice-1ExampleDevice-2針對關聯的地理圍欄集合ExampleGeofenceCollection

aws location \ batch-evaluate-geofences \ --collection-name ExampleGeofenceCollection \ --device-position-updates '[{"DeviceId":"ExampleDevice","Position":[-123.123,47.123],"SampleTime":"2021-11-30T21:47:25.149Z","Accuracy":{"Horizontal":10.30},"PositionProperties":{"field1":"value1","field2":"value2"}}]'