Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Perbarui pelacak Anda dengan posisi perangkat
<a name="send-location-updates"></a>

Untuk melacak perangkat Anda, Anda dapat memposting pembaruan posisi perangkat ke pelacak Anda. Anda kemudian dapat mengambil posisi perangkat ini atau riwayat posisi perangkat dari sumber daya pelacak Anda.

Setiap pembaruan posisi harus menyertakan ID perangkat, stempel waktu, dan posisi. Anda dapat secara opsional menyertakan metadata lain, termasuk akurasi dan hingga 3 pasangan nilai kunci untuk Anda gunakan sendiri.

Jika pelacak Anda ditautkan ke satu atau beberapa koleksi geofence, pembaruan akan dievaluasi terhadap geofences tersebut (mengikuti aturan pemfilteran yang Anda tentukan untuk pelacak). Jika perangkat melanggar area geofenced (dengan berpindah dari dalam area ke luar, atau sebaliknya), Anda akan menerima acara di. EventBridge Ini `ENTER` atau `EXIT` peristiwa mencakup detail pembaruan posisi, termasuk ID perangkat, stempel waktu, dan metadata terkait apa pun.

**catatan**  
Untuk informasi selengkapnya tentang pemfilteran posisi, lihat[Membuat pelacak](start-create-tracker.md).  
Untuk informasi selengkapnya tentang peristiwa geofence, lihat. [Bereaksi terhadap peristiwa Amazon Location Service dengan Amazon EventBridge](location-events.md)

Gunakan salah satu metode ini untuk mengirim pembaruan perangkat:
+ [Kirim pembaruan MQTT](tracking-using-mqtt.md) ke sumber daya AWS IoT Core dan tautkan ke sumber daya pelacak Anda.
+ Kirim pembaruan lokasi menggunakan API Pelacak Lokasi Amazon, dengan menggunakan AWS CLI, atau Lokasi APIs Amazon. Anda dapat menggunakan [AWS SDKs](dev-sdks.md)untuk menelepon APIs dari aplikasi iOS atau Android Anda.

------
#### [ API ]

**Untuk mengirim pembaruan posisi menggunakan Lokasi Amazon APIs**

Gunakan `[BatchUpdateDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchUpdateDevicePosition.html)` operasi dari Pelacak APIs Lokasi Amazon. 

Contoh berikut menggunakan permintaan API untuk memposting pembaruan posisi perangkat *ExampleDevice* ke pelacak*ExampleTracker*.

```
POST /tracking/v0/trackers/ExampleTracker/positions
Content-type: application/json
{
 "Updates": [
    {
    "DeviceId": "1",
    "Position": [
   -123.12245146162303, 49.27521118043802
    ],
    "SampleTime": "2022-10-24T19:09:07.327Z",
     "PositionProperties": { 
            "name" : "device1" 
         },
         "Accuracy": { 
            "Horizontal": 10
         }
    },

    {
    "DeviceId": "2",
    "Position": [
   -123.1230104928471, 49.27752402723152
    ],
    "SampleTime": "2022-10-02T19:09:07.327Z"
    },
    {
    "DeviceId": "3",
    "Position": [
    -123.12325592118916, 49.27340530543111
    ],
    "SampleTime": "2022-10-02T19:09:07.327Z"
    },
    {
    "DeviceId": "4",
    "Position": [
    -123.11958813096311, 49.27774641063121
    ],
    "SampleTime": "2022-10-02T19:09:07.327Z"
    },
    {
    "DeviceId": "5",
    "Position": [
    -123.1277418058896, 49.2765989015285
    ],
    "SampleTime": "2022-10-02T19:09:07.327Z"
    },
    {
    "DeviceId": "6",
    "Position": [
   -123.11964267059481, 49.274188155916534
    ],
    "SampleTime": "2022-10-02T19:09:07.327Z"
    }
    ]
}
```

------
#### [ AWS CLI ]

**Untuk mengirim pembaruan posisi menggunakan AWS CLI perintah**

Gunakan perintah `[batch-update-device-position](https://docs.aws.amazon.com/cli/latest/reference/location/batch-update-device-position.html)`.

Contoh berikut menggunakan AWS CLI untuk memposting pembaruan posisi perangkat untuk *ExampleDevice-1* dan *ExampleDevice-2* ke pelacak*ExampleTracker*. 

```
aws location batch-update-device-position \
--tracker-name ExampleTracker \
--updates '[{"DeviceId":"ExampleDevice-1","Position":[-123.123,47.123],"SampleTime":"2021-11-30T21:47:25.149Z"},{"DeviceId":"ExampleDevice-2","Position":[-123.123,47.123],"SampleTime":"2021-11-30T21:47:25.149Z","Accuracy":{"Horizontal":10.30},"PositionProperties":{"field1":"value1","field2":"value2"}}]'
```

------