クイックスタート

デバイス一覧を取り、走行軌跡を GeoJSON で受け取る

認証 でアクセストークンを取得済みとします。スコープは noki.devices.read と noki.locations.read が必要です。

デバイス一覧

curl 'https://datastore.agribus-connect.net/v1/agricultural-machinery/devices' \
  -H 'Authorization: Bearer <accessToken>'

DeviceListResponse が返ります。devices[].device_id (UUID) を次の呼び出しに使います。現在はアカウントごとに 1 台のデバイスが返ります。

位置情報履歴

curl 'https://datastore.agribus-connect.net/v1/agricultural-machinery/devices/<device_id>/locations?since=2026-01-01T00:00:00Z&until=2026-01-31T23:59:59Z&limit=1000' \
  -H 'Authorization: Bearer <accessToken>'

• since / until は ISO 8601 (UTC、例 2026-01-01T00:00:00Z)。省略時は直近 30 日
• limit は取得する作業セッションの上限 (省略時 1000)

レスポンスは GeoJSON の FeatureCollection です。各 Feature は Point (経度・緯度・高度) で、properties に次の値が入ります。

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": { "type": "Point", "coordinates": [141.35, 43.06, 25.0] },
      "properties": {
        "device_id": "550e8400-e29b-41d4-a716-446655440000",
        "date_time": "2026-01-10T01:23:45Z",
        "speed": 1.8,
        "heading": 92.5,
        "is_working": true,
        "work_width": 3.0,
        "gnss_status": "RtkFix",
        "operation_type": "Tilling"
      }
    }
  ]
}

(値は例です。gnss_status と operation_type の取りうる値はサーバーの列挙型に従います。)

エラー