> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/analytics/id/iot-query/schema-overview/transformation-layer/common-transformations/trips.md).

# Perjalanan

Catatan perjalanan kendaraan yang diturunkan dari data telematika mentah. Mencakup waktu mulai dan berakhir, jarak, statistik kecepatan, dan deteksi zona

Transformasi Perjalanan memproses data telematika mentah menjadi catatan perjalanan kendaraan terpisah. Setiap baris dalam `processed_common_data.trips` mewakili satu perjalanan lengkap: di mana perjalanan itu dimulai dan berakhir, berapa lama waktu yang dibutuhkan, seberapa jauh kendaraan menempuh jarak, dan zona mana yang menjadi titik keberangkatan atau kedatangan.

Transformasi bawaan berjalan setiap 8 jam dan mencakup jendela bergulir 12 jam untuk data mentah. Pada setiap kali berjalan, rekaman yang sebelumnya dihitung untuk jendela tersebut diganti dengan perhitungan baru, sehingga tabel selalu mencerminkan data terbaru yang tersedia.

{% hint style="info" %}

* Data dalam tabel ini dapat berumur hingga 8 jam, yang mencerminkan eksekusi yang paling baru selesai.
* Semua stempel waktu disimpan dalam UTC.
  {% endhint %}

## Tabel keluaran: processed\_common\_data.Perjalanan

Setiap baris merepresentasikan satu perjalanan kendaraan yang telah divalidasi. Tabel ini diberi kunci berdasarkan `device_id` dan `trip_start_time`.

<table><thead><tr><th width="215">Kolom</th><th width="115">Tipe</th><th>Deskripsi</th></tr></thead><tbody><tr><td><code>device_id</code></td><td>integer</td><td>Pengenal perangkat. Untuk mendapatkan label Pelacak, gabungkan ke <code>raw_business_data.objects</code> on <code>device_id</code> where <code>is_deleted = false</code> untuk menghindari penggandaan baris dari penetapan perangkat historis.</td></tr><tr><td><code>trip_start_time</code></td><td>stempel waktu</td><td>Waktu saat perjalanan dimulai. Ditentukan oleh titik pertama dari segmen Gerakan baru setelah pemberhentian yang memenuhi syarat atau celah data.</td></tr><tr><td><code>trip_end_time</code></td><td>stempel waktu</td><td>Waktu ketika perjalanan berakhir. Diatur ke saat perangkat beralih dari Bergerak ke berhenti yang berlangsung setidaknya 5 menit.</td></tr><tr><td><code>trip_duration</code></td><td>text</td><td>Durasi perjalanan diformat sebagai <code>HH:MI:SS</code>.</td></tr><tr><td><code>trip_duration_seconds</code></td><td>numerik</td><td>Durasi perjalanan dalam detik. Gunakan bidang ini untuk perhitungan aritmetika.</td></tr><tr><td><code>trip_distance_meters</code></td><td>numerik</td><td>Total jarak perjalanan dalam meter, dihitung dari geometri garis PostGIS yang dibangun dari semua titik dalam perjalanan.</td></tr><tr><td><code>avg_speed</code></td><td>numerik</td><td>Kecepatan rata-rata di seluruh titik dalam perjalanan, dalam km/jam.</td></tr><tr><td><code>max_speed</code></td><td>numerik</td><td>Kecepatan maksimum yang tercatat selama perjalanan, dalam km/jam.</td></tr><tr><td><code>min_speed</code></td><td>numerik</td><td>Kecepatan minimum yang dicatat selama perjalanan, dalam km/jam.</td></tr><tr><td><code>latitude_start</code></td><td>numerik</td><td>Lintang titik pertama perjalanan, dalam derajat.</td></tr><tr><td><code>longitude_start</code></td><td>numerik</td><td>Bujur titik pertama perjalanan, dalam derajat.</td></tr><tr><td><code>altitude_start</code></td><td>numerik</td><td>Ketinggian pada awal perjalanan, dalam meter di atas permukaan laut.</td></tr><tr><td><code>latitude_end</code></td><td>numerik</td><td>Lintang titik terakhir perjalanan, dalam derajat.</td></tr><tr><td><code>longitude_end</code></td><td>numerik</td><td>Bujur titik terakhir perjalanan, dalam derajat.</td></tr><tr><td><code>altitude_end</code></td><td>numerik</td><td>Ketinggian pada akhir perjalanan, dalam meter di atas permukaan laut.</td></tr><tr><td><code>points_in_trip</code></td><td>integer</td><td>Jumlah titik telematika mentah yang disertakan dalam perjalanan. Minimal 2 untuk perjalanan yang valid.</td></tr><tr><td><code>start_zone</code></td><td>text</td><td>Nama zona Perimeter yang berisi titik awal perjalanan, jika ada. Null jika titik awal tidak berada dalam zona yang ditentukan.</td></tr><tr><td><code>end_zone</code></td><td>text</td><td>Nama zona Perimeter yang berisi titik akhir perjalanan, jika ada. Null jika titik akhir tidak berada dalam zona yang ditentukan.</td></tr></tbody></table>

Contoh di bawah ini menunjukkan pola kueri umum. Kueri dasar mengembalikan catatan perjalanan untuk 7 hari terakhir yang diurutkan berdasarkan perangkat dan waktu mulai. Contoh kedua melakukan join ke `raw_business_data.objects` untuk menyertakan label Pelacak yang dapat dibaca manusia di samping setiap perjalanan.

{% tabs %}
{% tab title="Kueri perjalanan dasar" %}
{% code overflow="wrap" expandable="true" %}

```sql
PILIH
    device_id,
    trip_start_time,
    trip_end_time,
    trip_duration,
    trip_distance_meters,
    avg_speed,
    start_zone,
    end_zone
DARI processed_common_data.Perjalanan
WHERE trip_start_time >= CURRENT_DATE - INTERVAL '7 days'
ORDER BY device_id, trip_start_time;
```

{% endcode %}
{% endtab %}

{% tab title="Dengan label pelacak" %}
{% code overflow="wrap" expandable="true" %}

```sql
PILIH
    t.device_id,
    o.pelacak_label,
    t.trip_start_time,
    t.trip_end_time,
    t.trip_distance_meters,
    t.avg_speed,
    t.start_zone,
    t.end_zone
FROM processed_common_data.trips t
LEFT JOIN raw_business_data.objects o ON o.device_id = t.device_id
WHERE t.trip_start_time >= CURRENT_DATE - INTERVAL '7 days'
ORDER BY t.device_id, t.trip_start_time;
```

{% endcode %}
{% endtab %}
{% endtabs %}

## Cara catatan perjalanan dibentuk

Catatan perjalanan bukan pembacaan perangkat mentah, melainkan entitas turunan yang disusun dari ratusan\
titik telematika individual. Transformasi bekerja melalui data mentah secara bertahap:\
pertama memutuskan titik mana yang layak dipertahankan, lalu mengklasifikasikan status gerakan\
setiap titik, kemudian mengelompokkan titik ke dalam segmen perjalanan, dan akhirnya menghitung metrik agregat yang\
muncul di tabel keluaran. Memahami proses ini membantu Anda menafsirkan hasil dengan benar\
dan mengenali kapan pengaturan bawaan perlu disesuaikan untuk armada Anda.

Berikut adalah langkah-langkah algoritma yang membentuk catatan perjalanan:

{% stepper %}
{% step %}

#### **Mengumpulkan dan membersihkan input**

Transformasi membaca data 12 jam terakhir dari dua tabel sumber:

* `tracking_data_core` untuk pembacaan posisi dan gerakan
* `states` untuk penanda gerakan perangkat keras yang dikirim setiap pelacak

Titik difilter sebelum pemrosesan lebih lanjut:

* Rekaman dengan koordinat nol dihapus.
* Titik dengan kurang dari 3 satelit dikecualikan dari himpunan GNSS.
* Titik LBS (`satelit = -1`) adalah pengecualian: titik ini diteruskan untuk penanganan terpisah pada langkah berikutnya, karena posisi menara seluler memerlukan pemeriksaan validitas yang berbeda sebelum dapat berpartisipasi dalam deteksi perjalanan.
  {% endstep %}

{% step %}

#### **Menentukan apakah setiap titik merepresentasikan gerakan**

Setiap titik diklasifikasikan ke dalam salah satu dari tiga status:

* `Bergerak`: kecepatan berada pada atau di atas 3 km/jam, dan jarak dari titik sebelumnya melebihi 50 meter atau penanda gerakan perangkat keras pelacak aktif. Kedua kondisi ini mencegah positif palsu: pemeriksaan jarak menyaring lonjakan kecepatan, dan penanda perangkat keras menangkap gerakan dengan kecepatan rendah yang sebenarnya yang tidak akan terdeteksi oleh jarak saja.
* `Berhenti`: kecepatan berada di bawah ambang batas atau jarak tidak mencukupi.
* `Parkir`: tidak ada pembacaan kecepatan yang tersedia untuk titik ini.

Titik LBS menjalani pemeriksaan tambahan sebelum menerima status. Setiap titik LBS dengan kecepatan terhitung antara posisi berurutan melebihi 200 km/jam dibuang sebagai artefak penentuan posisi. Titik LBS yang lolos pemeriksaan ini dan langsung mengikuti titik GNSS dapat membentuk segmen perjalanan satu titik tersendiri, yang mencakup kasus saat perangkat beralih dari penentuan posisi satelit ke menara seluler di tengah perjalanan. Semua titik LBS tidak valid lainnya dihapus.
{% endstep %}

{% step %}

#### Mengelompokkan titik ke dalam perjalanan

Dengan setiap titik membawa status gerakan, transformasi mengidentifikasi batas perjalanan. Perjalanan baru dimulai ketika:

* Perangkat menghasilkan titik data pertamanya dalam jendela pemrosesan.
* Gerakan berlanjut kembali setelah berhenti yang memenuhi syarat (durasi parkir minimum terlampaui).
* Gerakan berlanjut kembali setelah celah data (batas waktu terlampaui).

Perjalanan berakhir ketika:

* Perangkat telah berhenti terus-menerus selama durasi parkir minimum.
* Celah data selama durasi batas waktu terjadi saat perangkat tidak bergerak.

Ambang batas yang mengontrol batas-batas ini tercantum dalam [Parameter konfigurasi](#configuration-parameters) referensi di bawah.
{% endstep %}

{% step %}

#### Menghitung metrik keluaran

Setelah batas perjalanan ditetapkan, semua titik di setiap perjalanan diagregasikan menjadi satu baris keluaran:

* `trip_distance_meters`: diturunkan dari geometri garis PostGIS yang dibuat dari urutan titik terurut menggunakan `ST_MakeLine`.
* `avg_speed`, `max_speed`, `min_speed`: dihitung di seluruh titik dalam perjalanan.
* `latitude_start`, `longitude_start`, `latitude_end`, `longitude_end`: diambil dari titik pertama dan terakhir dalam urutan.
* `start_zone`, `end_zone`: diisi dengan mencocokkan koordinat awal dan akhir terhadap `processed_common_data.zones_geom`. Kecocokan memerlukan titik berada tepat di dalam batas zona; tidak ada buffer yang diterapkan.
  {% endstep %}

{% step %}

#### Menyaring noise sebelum menulis hasil

Tidak semua segmen perjalanan yang diidentifikasi oleh algoritma layak dipertahankan. Segmen pendek yang disebabkan oleh pemulihan GPS singkat, perangkat diam dengan sesekali pergeseran posisi, atau data tidak lengkap di batas jendela dibuang. Perjalanan hanya ditulis ke tabel keluaran ketika memenuhi semua kondisi berikut secara bersamaan:

| Kondisi                          | Ambang batas                 |
| -------------------------------- | ---------------------------- |
| Titik dalam perjalanan           | Setidaknya 2                 |
| Kecepatan maksimum yang tercatat | Setidaknya 3 km/jam          |
| Jarak total perjalanan           | Setidaknya 100 meter         |
| Waktu mulai perjalanan           | Harus ditentukan (tidak nol) |
| Waktu akhir perjalanan           | Harus ditentukan (tidak nol) |
| {% endstep %}                    |                              |
| {% endstepper %}                 |                              |

Dua bagian referensi berikut memuat parameter yang dapat dikonfigurasi dan aturan penskalaan data mentah yang diterapkan transformasi secara internal.

<details>

<summary>Parameter konfigurasi</summary>

Ambang batas ini mengatur bagaimana perjalanan dipisah dan divalidasi. Ini merupakan target yang paling umum untuk penyesuaian. Lihat [Menyesuaikan transformasi](#customizing-the-transformation) untuk petunjuk cara menyesuaikannya di templat alur kerja.

<table><thead><tr><th width="233">Parameter</th><th width="133">Nilai bawaan</th><th>Deskripsi</th></tr></thead><tbody><tr><td>Durasi minimum parkir</td><td>300 detik (5 menit)</td><td>Perhentian yang lebih singkat dari ini tidak mengakhiri perjalanan saat ini. Perangkat dianggap masih berada dalam perjalanan yang sama.</td></tr><tr><td>Batas waktu jeda data</td><td>1200 detik (20 menit)</td><td>Jika tidak ada data yang masuk selama durasi ini, perjalanan saat ini berakhir dan perjalanan baru dimulai saat data dilanjutkan.</td></tr><tr><td>Jarak minimum gerakan</td><td>50 meter</td><td>Sebuah titik harus setidaknya sejauh ini dari titik sebelumnya agar dihitung sebagai gerakan.</td></tr><tr><td>Kecepatan minimum gerakan</td><td>3 km/j</td><td>Titik di bawah kecepatan ini tidak diklasifikasikan sebagai bergerak.</td></tr></tbody></table>

</details>

<details>

<summary>Penskalaan nilai mentah</summary>

Data telematika mentah dari `tracking_data_core` menyimpan nilai koordinat dan kecepatan sebagai bilangan bulat untuk penyimpanan yang efisien. Transformasi mengonversinya ke satuan standar sebelum pemrosesan.

| Kolom              | Pembagi          | Hasil                                  |
| ------------------ | ---------------- | -------------------------------------- |
| `lintang`, `bujur` | 10.000.000 (1e7) | Derajat (mis., 554567890 → 55,456789°) |
| `ketinggian`       | 10.000.000 (1e7) | Meter di atas permukaan laut           |
| `speed`            | 100 (1e2)        | km/jam (mis., 6530 → 65,30 km/jam)     |

</details>

## Menyesuaikan transformasi

Transformasi default Perjalanan mencerminkan logika deteksi perjalanan tujuan umum Navixy. Jika skenario operasional Anda memerlukan perilaku yang berbeda, Anda dapat memuat templat alur kerja ke [Penyusun transformasi](https://navixy.com/docs/analytics/id/iot-query/schema-overview/transformation-layer/transformation-builder.md), mengubah node yang relevan, dan menjadwalkan alur kerja yang telah disesuaikan sebagai transformasi kustom di `data_kustom_yang_diproses`.

{% hint style="warning" %}
Beberapa node dalam alur kerja Perjalanan menggunakan fungsi geometri PostGIS dan fungsi jendela (`LAG`, `FIRST_VALUE`, `LAST_VALUE`, `SUM OVER`). Mengubah node-node ini memerlukan pengetahuan SQL yang kuat. Selalu pratinjau hasilnya menggunakan **Jalankan** tombol di Transformation Builder sebelum menjadwalkan alur kerja yang telah dimodifikasi.
{% endhint %}

### Contoh kustomisasi

Buka bagian-bagian di bawah untuk melihat beberapa contoh penyesuaian berdasarkan kasus.

<details>

<summary>Menyesuaikan ambang batas perhentian dan jeda</summary>

Gunakan ini ketika ambang batas parkir default 5 menit memisahkan apa yang seharusnya menjadi satu perjalanan berkelanjutan menjadi beberapa rekaman — umum pada rute pengiriman perkotaan dengan perhentian singkat yang sering. Penyesuaian ini juga membantu saat perangkat memiliki interval pelaporan yang tidak teratur dan batas waktu jeda 20 menit mengakhiri perjalanan terlalu dini.

Nilai ambang batas ditetapkan secara tetap sebagai konstanta integer di dua node SQL kustom:

1. Buka **Penanda perjalanan** node (`custom_9`). Temukan kondisi `parking_duration >= 300 * INTERVAL '1 second'`. Ini muncul dua kali di node. Ganti `300` dengan nilai target Anda dalam detik di kedua tempat. Misalnya, untuk mensyaratkan berhenti selama 10 menit, gunakan `600`.
2. Dalam node yang sama **Penanda perjalanan** node (`custom_9`), temukan `time_diff >= 1200`. Lalu buka **Penanda parkir** node (`custom_6`) dan temukan kondisi yang sama di sana. Ganti `1200` dengan nilai target Anda dalam detik di kedua node. Misalnya, untuk menoleransi celah 30 menit, gunakan `1800`.
3. Klik **Jalankan** untuk melihat pratinjau hasil dan memastikan bahwa batas perjalanan sesuai dengan ekspektasi operasional Anda sebelum Penjadwalan.

</details>

<details>

<summary>Mengaktifkan penyaringan LBS berbasis jarak</summary>

Gunakan ini ketika Armada Anda beroperasi di area dengan cakupan GPS yang buruk dan titik LBS menyebabkan lonjakan koordinat besar — misalnya, perangkat kehilangan sinyal satelit dan melompat ke menara seluler beberapa kilometer jauhnya. Mengecualikan titik-titik ini menghasilkan geometri perjalanan yang lebih bersih dan perhitungan jarak yang lebih akurat.

Templat alur kerja menyertakan placeholder untuk pemeriksaan ini di **LBS Diproses** node (`custom_3`), tetapi secara default tidak aktif. The `distance_status` kolom dikodekan secara keras untuk selalu mengembalikan `'VALID'` melalui ekspresi placeholder `CASE WHEN 1 != 1 THEN 'EXCLUDED_DISTANCE' ELSE 'VALID' END`. Untuk mengaktifkannya:

1. Buka **LBS Diproses** node SQL kustom (`custom_3`) di Transformation Builder.
2. Ganti baris placeholder dengan kondisi nyata berdasarkan `distance_meters`. Misalnya, untuk mengecualikan titik LBS yang berjarak lebih dari 500 meter dari titik sebelumnya:

```sql
   CASE
       WHEN point_type = 'LBS' AND distance_meters > 500
       THEN 'EXCLUDED_DISTANCE'
       ELSE 'VALID'
   END AS distance_status,
```

Ambang batas antara 200 dan 1000 meter adalah rentang awal yang wajar — gunakan nilai lebih rendah di area dengan cakupan menara seluler yang padat, dan nilai lebih tinggi di tempat menara jarang.

3. Klik **Jalankan** untuk melihat pratinjau hasil. Periksa berapa banyak titik LBS yang kini dikecualikan dan apakah perjalanan yang tersisa terlihat benar. Sesuaikan ambang batas jika diperlukan sebelum Penjadwalan.

</details>

<details>

<summary>Mengecualikan titik LBS sepenuhnya</summary>

Gunakan ini ketika Armada Anda menggunakan perangkat hanya GPS yang tidak pernah menghasilkan pembacaan LBS, atau ketika Anda ingin catatan perjalanan dibuat sepenuhnya dari posisi GNSS yang terkonfirmasi.

1. Buka **Data inti** node sumber (`telematics_1`, jenis: Data mentah: Telematics). Di **Kondisi filter** field, hapus `OR satellites = -1` dari pemeriksaan satelit, sehingga mengubah:

```
   event_id IN (2, 802, 803, 804, 811) AND latitude <> 0 AND longitude <> 0
   AND (satellites >= 3 OR satellites = -1)
```

menjadi:

```
   event_id IN (2, 802, 803, 804, 811) AND latitude <> 0 AND longitude <> 0
   AND satellites >= 3
```

2. Hapus **LBS Diproses** node (`custom_3`) dan the **LBS terfilter** node (`custom_4`) dari graf, beserta semua sisi yang terhubung dengannya. Buat sisi baru dari **Dengan jarak** node (`custom_2`) ke **Filter tidak valid** node (`filter_1`) untuk memulihkan aliran data.
3. Buka **Filter tidak valid** node dan ganti kedua kondisi dinamis yang ada dengan satu kondisi langsung: `calculated_speed_kmh <= 200`. Kondisi asli (`lbs_excluded_flag = 0` dan `speed_status = 'VALID'`) mereferensikan kolom yang dihasilkan oleh node yang dihapus dan akan menyebabkan galat eksekusi jika dibiarkan di tempat.
4. Klik **Jalankan** untuk melihat pratinjau output. Verifikasi bahwa jumlah titik dan batas perjalanan terlihat benar untuk data Anda sebelum Penjadwalan.

</details>

### Menggunakan templat alur kerja

Navixy menyediakan templat alur kerja Perjalanan siap pakai yang dapat Anda muat ke pembangun transformasi sebagai titik awal. Templat ini mencakup semua langkah pemrosesan yang dijelaskan di halaman ini, mulai dari penyerapan data mentah hingga pencocokan zona dan agregasi.

Lihat [Templat](https://navixy.com/docs/analytics/id/iot-query/schema-overview/transformation-layer/transformation-builder/templates.md) halaman untuk unduhan, instruksi impor, dan konfigurasi simpul Output untuk transformasi ini.

## Langkah berikutnya

* [**Transformasi umum**](https://navixy.com/docs/analytics/id/iot-query/schema-overview/transformation-layer/common-transformations.md): Kembali ke indeks transformasi.
* [**Templat**](https://navixy.com/docs/analytics/id/iot-query/schema-overview/transformation-layer/transformation-builder/templates.md): Unduh templat alur kerja Perjalanan dan impor ke pembangun transformasi.
* [**Penyusun transformasi**](https://navixy.com/docs/analytics/id/iot-query/schema-overview/transformation-layer/transformation-builder.md): Pelajari cara menggunakan editor alur kerja visual, menambahkan simpul, dan melihat pratinjau hasil.
* [**Lapisan data mentah**](https://navixy.com/docs/analytics/id/iot-query/schema-overview/bronze-layer.md): Jelajahi tabel sumber yang memasok data ke transformasi Perjalanan: `tracking_data_core`, `states`, dan `zones_geom`.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/analytics/id/iot-query/schema-overview/transformation-layer/common-transformations/trips.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
