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

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

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

有兩種方法可以根據地理圍欄評估位置以生成地理圍欄事件:

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

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

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

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

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

下列範例使AWS CLI用或 Amazon 位置 API。

API

使用 Amazon 位置 API 根據地理圍欄的位置評估裝置位置

使用來自 Amazon 位置地理圍欄 API 的BatchEvaluateGeofences操作。

以下示例使用 API 請求來評估設備ExampleDevice到關聯地理圍欄集合的位置。ExampleGeofenceCollection將這些值替換為您自己的地理圍欄和設備 ID。

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位置。ExampleGeofenceCollection將這些值替換為您自己的地理圍欄和設備 ID。

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"}}]'