# Glosari mobiliti dan data. Definisi mudah untuk fahami pengangkutan, perkhidmatan berdekatan dan alat yang menyambungkannya ke aplikasi anda. Source: https://www.roote.ai/ms/istilah-mobiliti/ Language: ms Author: ROOTE ## Basikal sewa kendiri Perkhidmatan membolehkan pinjam basikal untuk kegunaan sementara mengikut syarat pengendali. Boleh beroperasi dengan stesen atau kenderaan tanpa stesen. Contoh : Anda kenal pasti basikal dan guna perkhidmatan sewaan berkaitan. Mendalami dalam panduan : [Bagaimana Cara Mencari Basikal Sewa Dekat Saya?](https://www.roote.ai/ms/guides/bagaimana-cara-mencari-basikal-sewa-dekat-saya/) ## Mobiliti dikongsi Kumpulan perkhidmatan memberikan akses kepada kenderaan yang digunakan bergantian oleh ramai orang, bukan milik seorang sahaja. Contoh : Basikal dan skuter yang disewa dalam bandar. Mendalami dalam panduan : [Bagaimana Cara Mencari Basikal Sewa Dekat Saya?](https://www.roote.ai/ms/guides/bagaimana-cara-mencari-basikal-sewa-dekat-saya/) ## Tempat lekat Peralatan stesen tempat basikal boleh dilekatkan. Kehadirannya tidak menjamin penerimaan pemulangan pada masa semak. Contoh : Tempat pulang mesti tersedia dan boleh digunakan. Mendalami dalam panduan : [Stesen Basikal Kosong atau Penuh: Apa yang Harus Dilakukan?](https://www.roote.ai/ms/guides/stesen-basikal-kosong-atau-penuh-apa-yang-harus-dilakukan/) ## Stesen basikal Tempat teratur untuk ambil atau kembalikan basikal dikongsi. Koordinat, kapasiti dan ketersediaan adalah aspek berbeza stesen. Contoh : Stesen mungkin terpapar di peta tapi kosong sementara. Mendalami dalam panduan : [Stesen Basikal Kosong atau Penuh: Apa yang Harus Dilakukan?](https://www.roote.ai/ms/guides/stesen-basikal-kosong-atau-penuh-apa-yang-harus-dilakukan/) ## Tanpa stesen — free-floating Susunan kenderaan tidak perlu diambil dan dikembalikan pada tempat tetap. Zon dan peraturan tempat letak adalah milik perkhidmatan. Contoh : Skuter mesti dikembalikan dalam zon dibenarkan. Mendalami dalam panduan : [Basikal di stesen atau tanpa stesen: apa perbezaannya?](https://www.roote.ai/ms/guides/basikal-di-stesen-atau-tanpa-stesen-apa-perbezaannya/) ## Ketersediaan Keadaan atau kuantiti menunjukkan apa boleh digunakan menurut maklumat diketahui. Ketersediaan pemerhatian boleh berubah dan bukan tempahan. Contoh : Tiga basikal di stesen belum tentu tiga tempahan dibuat. Mendalami dalam panduan : [Ketersediaan Basikal Masa Nyata: Bagaimana Memaparkannya Dalam Aplikasi?](https://www.roote.ai/ms/guides/pamer-ketersediaan-basikal-masa-nyata-dalam-aplikasi/) ## Ambil kenderaan Tindakan mula guna kenderaan. Pemasa positif tidak mencukupi jika perkhidmatan menandakan pengambilan dilumpuhkan. Contoh : Basikal ada tapi stesen mungkin tidak benarkan sewa. Mendalami dalam panduan : [Ketersediaan Basikal Masa Nyata: Bagaimana Memaparkannya Dalam Aplikasi?](https://www.roote.ai/ms/guides/pamer-ketersediaan-basikal-masa-nyata-dalam-aplikasi/) ## Pemulangan Akhir penggunaan kenderaan ikut peraturan perkhidmatan. Pilihan pemulangan mungkin berbeza dengan pilihan ambil. Contoh : Stesen benarkan mula sewa tapi tiada tempat pulang. Mendalami dalam panduan : [Stesen Basikal Kosong atau Penuh: Apa yang Harus Dilakukan?](https://www.roote.ai/ms/guides/stesen-basikal-kosong-atau-penuh-apa-yang-harus-dilakukan/) ## Basikal berkuasa elektrik Basikal dengan motor bantu kayuh ikut ciri. Dalam data mobiliti, jenis penggerak dan bateri boleh dipisah. Contoh : Stesen boleh bezakan basikal mekanikal dan elektrik. Mendalami dalam panduan : [Ketersediaan Basikal Masa Nyata: Bagaimana Memaparkannya Dalam Aplikasi?](https://www.roote.ai/ms/guides/pamer-ketersediaan-basikal-masa-nyata-dalam-aplikasi/) ## Intermodaliti Penggunaan berganti pelbagai mod pergerakan dalam satu perjalanan. Setiap langkah ada jadual, akses dan syarat tersendiri. Contoh : Anda berbasikal ke tram dan sambung berjalan kaki. Mendalami dalam panduan : [Bagaimana menggabungkan basikal dan pengangkutan awam dalam kehidupan seharian?](https://www.roote.ai/ms/guides/bagaimana-menggabungkan-basikal-dan-pengangkutan-awam-harian/) ## Hentian pengangkutan Tempat perkhidmatan ambil atau turunkan penumpang. Hentian terbuka tidak selalu tunjuk waktu datang seterusnya. Contoh : Hentian bas dipaparkan tanpa waktu keberangkatan. Mendalami dalam panduan : [Bagaimana cara mencari perhentian bas atau tram terdekat?](https://www.roote.ai/ms/guides/cara-mencari-perhentian-bas-atau-tram-terdekat/) ## Platform Ruang atau titik menaiki di lokasi pengangkutan. Beberapa platform berhampiran mungkin guna untuk arah atau perkhidmatan berbeza. Contoh : Dua hala laluan mungkin guna platform berbeza. Mendalami dalam panduan : [Bagaimana mencari perhentian bas dan arah yang betul?](https://www.roote.ai/ms/guides/cara-mencari-perhentian-bas-dan-arah-yang-betul/) ## Laluan Perkhidmatan pengangkutan dikenal dalam jaringan, dengan satu atau lebih laluan/varian. Nama laluan tidak cukup tentukan arah betul. Contoh : Laluan sama boleh ada beberapa terminal. Mendalami dalam panduan : [Bagaimana mencari perhentian bas dan arah yang betul?](https://www.roote.ai/ms/guides/cara-mencari-perhentian-bas-dan-arah-yang-betul/) ## Perjalanan Pelaksanaan perkhidmatan pengangkutan dengan laluan dan hentian. Dalam GTFS, perjalanan disambung ke laluan dan kalendar perkhidmatan. Contoh : Dua keberangkatan berturutan laluan sama adalah dua perjalanan berasingan. Mendalami dalam panduan : [GTFS, GTFS-RT dan GBFS: Apakah Perbezaannya?](https://www.roote.ai/ms/guides/gtfs-gtfs-rt-dan-gbfs-apakah-perbezaannya/) ## Arah Penunjuk hala atau destinasi perkhidmatan. Perlu disahkan dengan laluan dan tempat menaiki. Contoh : Anda cari tram ke destinasi, bukan arah berlawanan. Mendalami dalam panduan : [Bagaimana mencari perhentian bas dan arah yang betul?](https://www.roote.ai/ms/guides/cara-mencari-perhentian-bas-dan-arah-yang-betul/) ## Terminal Penghujung laluan pengangkutan. Laluan boleh ada varian dengan terminal berbeza. Contoh : Servis singkat tamat sebelum terminal biasa. Mendalami dalam panduan : [Bagaimana mencari perhentian bas dan arah yang betul?](https://www.roote.ai/ms/guides/cara-mencari-perhentian-bas-dan-arah-yang-betul/) ## Tukar pengangkutan Beralih dari satu perkhidmatan atau mod ke lain semasa perjalanan. Dekat dua hentian tidak jamin pertukaran mudah. Contoh : Sediakan masa berjalan antara platform dan tunggu. Mendalami dalam panduan : [Cara Membaca Pelan Bas, Tram atau LRT?](https://www.roote.ai/ms/guides/cara-membaca-pelan-bas-tram-atau-lrt/) ## Waktu jadual Waktu dijadual dalam pelan untuk tarikh dan hentian tertentu. Tidak semestinya memperlihatkan keadaan kenderaan semasa. Contoh : Keberangkatan dijadualkan jam 8:10 menurut kalendar. Mendalami dalam panduan : [Jadual Bas: Apakah Perbezaan Antara Jadual Teoritis dan Masa Sebenar?](https://www.roote.ai/ms/guides/jadual-bas-perbezaan-jadual-teoritis-dan-masa-sebenar/) ## Waktu anggaran Ramalan masa laluan akan datang berdasarkan data tersedia. Boleh berubah bila data baru masuk. Contoh : Laluan dijangka jam 8:10 kini anggar jam 8:14. Mendalami dalam panduan : [Jadual Bas: Apakah Perbezaan Antara Jadual Teoritis dan Masa Sebenar?](https://www.roote.ai/ms/guides/jadual-bas-perbezaan-jadual-teoritis-dan-masa-sebenar/) ## Keberangkatan seterusnya Rangkaian masa depan dipaparkan untuk lokasi dan perkhidmatan. Cari hentian tidak sama dengan cari waktu keberangkatan seterusnya. Contoh : Senarai hentian dan senarai keberangkatan adalah hasil berbeza. Mendalami dalam panduan : [Bagaimana cara mencari perhentian pengangkutan berhampiran menggunakan API?](https://www.roote.ai/ms/guides/cara-mencari-perhentian-pengangkutan-berhampiran-dengan-api/) ## Gangguan Peristiwa mempengaruhi perkhidmatan pengangkutan seperti hentian atau laluan berubah. Kesan dibaca dalam kawasan dan masa ditetapkan. Contoh : Amaran mungkin hanya untuk laluan tertentu waktu tertentu. Mendalami dalam panduan : [Bagaimana cara mencipta pembantu yang mencari mobiliti di sekitar alamat?](https://www.roote.ai/ms/guides/cara-cipta-pembantu-mobiliti-sekitar-alamat/) ## Kalendar perkhidmatan Maklumat hari perkhidmatan pengangkutan disediakan dengan pengecualian. Waktu perlu difahami bersama kalendar ini. Contoh : Laluan bekerja hari biasa mungkin tiada Ahad. Mendalami dalam panduan : [GTFS, GTFS-RT dan GBFS: Apakah Perbezaannya?](https://www.roote.ai/ms/guides/gtfs-gtfs-rt-dan-gbfs-apakah-perbezaannya/) ## Perkhidmatan bandar Kemudahan atau perkhidmatan berguna dekat lokasi seperti tandas, bekalan air atau stesen cas. Maklumat mungkin tidak lengkap. Contoh : Hasil pencarian menunjukkan perkhidmatan dengan info yang diketahui. Mendalami dalam panduan : [Bagaimana cara mencari perhentian pengangkutan berhampiran menggunakan API?](https://www.roote.ai/ms/guides/cara-mencari-perhentian-pengangkutan-berhampiran-dengan-api/) ## Tandas awam Tandas untuk penggunaan umum mengikut syarat lokasi. Kehadirannya dalam data tidak jamin percuma, buka atau akses semasa. Contoh : Sahkan syarat ditunjukkan sebelum pergi. Mendalami dalam panduan : [Bagaimana mencari tandas awam percuma di sekitar anda?](https://www.roote.ai/ms/guides/cara-mencari-tandas-umum-percuma-di-sekitar/) ## Aksesibiliti Ciri membolehkan penggunaan tempat atau perkhidmatan mengikut keperluan individu. Data tidak diketahui bukan bermakna boleh atau tidak boleh akses. Contoh : Akses kerusi roda boleh diketahui atau tidak. Mendalami dalam panduan : [Tandas Awam Mesra Aksesibiliti: Apa Yang Perlu Disemak Sebelum Bergerak?](https://www.roote.ai/ms/guides/tandas-awam-mesra-aksesibiliti-apa-yang-perlu-disemak-sebelum-bergerak/) ## Orang kurang upaya pergerakan — OKUP Orang hadapi kesukaran bergerak sementara atau kekal. Label OKUP bukan terangkan semua akses atau kemudahan diperlukan. Contoh : Kehadiran cerun tidak jelaskan semua halangan mungkin ada. Mendalami dalam panduan : [Tandas Awam Mesra Aksesibiliti: Apa Yang Perlu Disemak Sebelum Bergerak?](https://www.roote.ai/ms/guides/tandas-awam-mesra-aksesibiliti-apa-yang-perlu-disemak-sebelum-bergerak/) ## Waktu operasi Jangka masa tempat isytihar buka. Bukan pengesahan masa sebenar operasi. Contoh : Tutup sementara mungkin tidak dipaparkan pada waktu biasa. Mendalami dalam panduan : [Bagaimana mencari tandas awam percuma di sekitar anda?](https://www.roote.ai/ms/guides/cara-mencari-tandas-umum-percuma-di-sekitar/) ## Air minuman Air dianggap sesuai untuk minum manusia. Titik air atau pancuran tidak patut dianggap minuman tanpa maklumat jelas. Contoh : Jenis kemudahan dan sifatnya harus bezakan. Mendalami dalam panduan : [Bagaimana cara mencari perhentian pengangkutan berhampiran menggunakan API?](https://www.roote.ai/ms/guides/cara-mencari-perhentian-pengangkutan-berhampiran-dengan-api/) ## Stesen pengecasan Alat untuk cas kenderaan serasi. Menemui stesen tidak jamin ketersediaan atau keserasian penyambung. Contoh : Lokasi cas dan statusnya dua maklumat berbeza. Mendalami dalam panduan : [Bagaimana cara mencari perhentian pengangkutan berhampiran menggunakan API?](https://www.roote.ai/ms/guides/cara-mencari-perhentian-pengangkutan-berhampiran-dengan-api/) ## Jenis perkhidmatan Kategori digunakan pilih atau terangkan perkhidmatan bandar. Nilai diterima bergantung pada antara muka dan skema. Contoh : API Perkhidmatan ROOTE guna types=toilets untuk tandas. Mendalami dalam panduan : [Bagaimana cara mencari perhentian pengangkutan berhampiran menggunakan API?](https://www.roote.ai/ms/guides/cara-mencari-perhentian-pengangkutan-berhampiran-dengan-api/) ## Geolokasi Dapat lokasi geografi oleh peranti atau aplikasi. Bergantung pada kebenaran dan ketepatan tersedia. Contoh : Tombol lokasi minta kelulusan pelayar. Mendalami dalam panduan : [Cara Memasukkan Peta Mobiliti dalam Laman Web Anda?](https://www.roote.ai/ms/guides/cara-memasukkan-peta-mobiliti-di-laman-web/) ## Koordinat GPS Nilai bagi mewakili titik geografi biasanya latitud dan longitud. Urutan mesti ditentukan dalam antara muka. Contoh : Carian berdekatan terima dua koordinat berbeza. Mendalami dalam panduan : [Bagaimana cara mencari perhentian pengangkutan berhampiran menggunakan API?](https://www.roote.ai/ms/guides/cara-mencari-perhentian-pengangkutan-berhampiran-dengan-api/) ## Latitud Koordinat utara atau selatan khatulistiwa dinyatakan dalam darjah dalam contoh ROOTE. Nilai sah dari −90 ke 90. Contoh : Latitud titik carian dihantar dalam lat. Mendalami dalam panduan : [Bagaimana cara mencari perhentian pengangkutan berhampiran menggunakan API?](https://www.roote.ai/ms/guides/cara-mencari-perhentian-pengangkutan-berhampiran-dengan-api/) ## Longitud Koordinat timur-barat berbanding meridian rujukan. Contoh ROOTE guna darjah antara −180 dan 180. Contoh : Longitud boleh dihantar dalam lon atau alias lng. Mendalami dalam panduan : [Bagaimana cara mencari perhentian pengangkutan berhampiran menggunakan API?](https://www.roote.ai/ms/guides/cara-mencari-perhentian-pengangkutan-berhampiran-dengan-api/) ## Geokod Carian tukar alamat atau ungkapan geografi ke calon dengan koordinat. Beberapa tempat mungkin sama nama. Contoh : Dua bandar ada jalan sama nama. Mendalami dalam panduan : [Bagaimana cara mencipta pembantu yang mencari mobiliti di sekitar alamat?](https://www.roote.ai/ms/guides/cara-cipta-pembantu-mobiliti-sekitar-alamat/) ## Geokod terbalik Carian tempat atau label dari koordinat. Hasil mungkin tempat dekat, bukan alamat tepat dijamin. Contoh : Titik GPS dipadankan dengan label boleh baca. Mendalami dalam panduan : [Apakah itu pelayan MCP dan apa fungsinya?](https://www.roote.ai/ms/guides/apa-itu-pelayan-mcp-dan-fungsinya/) ## Tempat menarik — POI Tempat dikenali berguna dalam carian seperti premis atau kemudahan. POI berbeza dengan alamat pos biasa. Contoh : Nama hotel boleh dicari sebagai premis. Mendalami dalam panduan : [Bagaimana cara mencipta pembantu yang mencari mobiliti di sekitar alamat?](https://www.roote.ai/ms/guides/cara-cipta-pembantu-mobiliti-sekitar-alamat/) ## Asal carian Titik dari mana carian berdekatan dilakukan dan jarak dikira. Boleh berlainan dengan pusat peta ditunjuk. Contoh : Kamera bergerak tapi carian pusat di Bordeaux. Mendalami dalam panduan : [Cara Memasukkan Peta Mobiliti dalam Laman Web Anda?](https://www.roote.ai/ms/guides/cara-memasukkan-peta-mobiliti-di-laman-web/) ## Jejari carian Jarak keliling titik asal digunakan untuk bataskan carian. Unit dan had menurut kontrak jalan atau alat. Contoh : radius=600 minta jejari 600 meter dalam contoh REST. Mendalami dalam panduan : [Bagaimana cara mencari perhentian pengangkutan berhampiran menggunakan API?](https://www.roote.ai/ms/guides/cara-mencari-perhentian-pengangkutan-berhampiran-dengan-api/) ## Jarak geografi Jarak dikira antara posisi ikut kaedah perkhidmatan. Bukan automatik jarak laluan atau masa berjalan. Contoh : Tempat dekat boleh perlukan pusing untuk capai. Mendalami dalam panduan : [Bagaimana cara mencari perhentian pengangkutan berhampiran menggunakan API?](https://www.roote.ai/ms/guides/cara-mencari-perhentian-pengangkutan-berhampiran-dengan-api/) ## Zum peta Tahap pembesaran pandangan peta. Kawal paparan tapi tidak ganti jejari permintaan API. Contoh : zoom=15 mendekatkan pandangan peta. Mendalami dalam panduan : [Cara Memasukkan Peta Mobiliti dalam Laman Web Anda?](https://www.roote.ai/ms/guides/cara-memasukkan-peta-mobiliti-di-laman-web/) ## Data masa nyata Maklumat dikemas kini untuk tunjuk keadaan terkini atau sokong anggaran. Kesegaran dinilai; masa nyata bukan serta-merta atau terjamin. Contoh : Anggaran laluan dikira semula dari data baru. Mendalami dalam panduan : [Jadual Bas: Apakah Perbezaan Antara Jadual Teoritis dan Masa Sebenar?](https://www.roote.ai/ms/guides/jadual-bas-perbezaan-jadual-teoritis-dan-masa-sebenar/) ## Pemerhatian Keadaan atau peristiwa dikesan pada masa tertentu. Berbeza dengan peristiwa dijadual atau dianggarkan. Contoh : Laluan sebenar bas mungkin berbeza anggaran. Mendalami dalam panduan : [Jadual Bas: Apakah Perbezaan Antara Jadual Teoritis dan Masa Sebenar?](https://www.roote.ai/ms/guides/jadual-bas-perbezaan-jadual-teoritis-dan-masa-sebenar/) ## Kesegaran data Kualiti kemaskini maklumat ikut tarikh dan peraturan kontrak. Masa capaian tidak cukup bukti kesegaran sumber. Contoh : Pengiraan kini mungkin dari pemerhatian lama. Mendalami dalam panduan : [Ketersediaan Basikal Masa Nyata: Bagaimana Memaparkannya Dalam Aplikasi?](https://www.roote.ai/ms/guides/pamer-ketersediaan-basikal-masa-nyata-dalam-aplikasi/) ## Penanda masa Masa dikaitkan dengan data atau peristiwa. Maksud bergantung pada medan: pemerhatian, kemas kini, terima atau tamat. Contoh : source_updated_at dan received_at berbeza tahap. Mendalami dalam panduan : [Ketersediaan Basikal Masa Nyata: Bagaimana Memaparkannya Dalam Aplikasi?](https://www.roote.ai/ms/guides/pamer-ketersediaan-basikal-masa-nyata-dalam-aplikasi/) ## Data lapuk — stale Maklumat dianggap terlalu lama ikut kontrak atau polisi sah. Boleh disimpan sebagai sejarah tetapi tidak dikira segar. Contoh : Antara muka tunjuk ketersediaan perlu dikemas kini. Mendalami dalam panduan : [Ketersediaan Basikal Masa Nyata: Bagaimana Memaparkannya Dalam Aplikasi?](https://www.roote.ai/ms/guides/pamer-ketersediaan-basikal-masa-nyata-dalam-aplikasi/) ## Tempoh sah — TTL Durasi urus kesahihan atau pembaharuan data cache ikut kontrak. Tidak tunjuk masa pemerhatian asal. Contoh : Cache tamat tempoh ikut polisi kemas kini. Mendalami dalam panduan : [Ketersediaan Basikal Masa Nyata: Bagaimana Memaparkannya Dalam Aplikasi?](https://www.roote.ai/ms/guides/pamer-ketersediaan-basikal-masa-nyata-dalam-aplikasi/) ## Cache Simpanan sementara keputusan untuk elak carian sama berulang. Nilai cache simpan sumber dan konteks masa. Contoh : Dua permintaan sama guna semula balasan sah. Mendalami dalam panduan : [Ketersediaan Basikal Masa Nyata: Bagaimana Memaparkannya Dalam Aplikasi?](https://www.roote.ai/ms/guides/pamer-ketersediaan-basikal-masa-nyata-dalam-aplikasi/) ## Liputan Kawasan dan tahap lengkap maklumat untuk carian atau sumber. Liputan separa hadkan kesimpulan boleh dibuat. Contoh : Senarai berguna walaupun tidak wakil semua perkhidmatan. Mendalami dalam panduan : [Tiada keputusan atau ralat API: bagaimana membuat perbezaan?](https://www.roote.ai/ms/guides/tiada-keputusan-atau-ralat-api-bagaimana-membuat-perbezaan/) ## Asal usul Maklumat kenal dari mana data dan cara hasil ikut kontrak. Bantu fahami skopnya. Contoh : Keputusan simpan sumber dan konteks pengambilan. Mendalami dalam panduan : [Bagaimana cara mencipta pembantu yang mencari mobiliti di sekitar alamat?](https://www.roote.ai/ms/guides/cara-cipta-pembantu-mobiliti-sekitar-alamat/) ## Kredit Sebutan pembekal atau sumber berkaitan data. Jika wajib, pengalaman perlu tunjukkan kredit. Contoh : Jika required=true kredit mesti simpan dalam antara muka. Mendalami dalam panduan : [Bagaimana cara mencari perhentian pengangkutan berhampiran menggunakan API?](https://www.roote.ai/ms/guides/cara-mencari-perhentian-pengangkutan-berhampiran-dengan-api/) ## Jadual GTFS Format standard terangkan tawaran pengangkutan dirancang: hentian, laluan, perjalanan, kalendar dan laluan. Tidak berikan kemas kini masa nyata automatik. Contoh : Laluan dijadual kaitkan dengan perjalanan dan hari perkhidmatan. Mendalami dalam panduan : [GTFS, GTFS-RT dan GBFS: Apakah Perbezaannya?](https://www.roote.ai/ms/guides/gtfs-gtfs-rt-dan-gbfs-apakah-perbezaannya/) ## GTFS Masa Nyata — GTFS-RT Format standard untuk hantar kemas kini perjalanan, posisi kenderaan dan amaran. Kategori bergantung penerbit. Contoh : Aliran posisi tidak bermakna anggaran untuk semua hentian. Mendalami dalam panduan : [GTFS, GTFS-RT dan GBFS: Apakah Perbezaannya?](https://www.roote.ai/ms/guides/gtfs-gtfs-rt-dan-gbfs-apakah-perbezaannya/) ## GBFS Format standard data awam mobiliti dikongsi. Mengikut versi dan aliran, terangkan sistem, stesen, kenderaan dan statusnya. Contoh : Maklumat stesen dan kiraan ketersediaan berasingan. Mendalami dalam panduan : [GTFS, GTFS-RT dan GBFS: Apakah Perbezaannya?](https://www.roote.ai/ms/guides/gtfs-gtfs-rt-dan-gbfs-apakah-perbezaannya/) ## Nilai tidak diketahui — null Ketiadaan nilai dalam kontrak guna null maksud ini. Tidak harus diganti sifar, salah atau bukti tiada. Contoh : Kiraan basikal null bukan stesen kosong. Mendalami dalam panduan : [Tiada keputusan atau ralat API: bagaimana membuat perbezaan?](https://www.roote.ai/ms/guides/tiada-keputusan-atau-ralat-api-bagaimana-membuat-perbezaan/) ## API Antara muka program guna keupayaan perkhidmatan lain ikut kontrak. Tentukan input dan balasan diharapkan. Contoh : Aplikasi cari hentian dengan API ROOTE. Mendalami dalam panduan : [API atau MCP: yang mana untuk dipilih dalam integrasi data mobiliti?](https://www.roote.ai/ms/guides/api-atau-mcp-pilih-integrasi-data-mobiliti/) ## API REST Pendekatan HTTP guna sumber dan mekanisme web. Kontrak API jelaskan laluan, kaedah dan representasi. Contoh : Carian dihantar ke laluan GET yang didokumen. Mendalami dalam panduan : [Bagaimana cara mencari perhentian pengangkutan berhampiran menggunakan API?](https://www.roote.ai/ms/guides/cara-mencari-perhentian-pengangkutan-berhampiran-dengan-api/) ## Endpoint — laluan API Alamat dan operasi dipaparkan API untuk fungsi tertentu. Laluan berlainan pulangkan keluarga keputusan berbeza. Contoh : /v1/transit/nearby cari lokasi pengangkutan. Mendalami dalam panduan : [Bagaimana cara mencari perhentian pengangkutan berhampiran menggunakan API?](https://www.roote.ai/ms/guides/cara-mencari-perhentian-pengangkutan-berhampiran-dengan-api/) ## Parameter pertanyaan Nilai di URL selepas tanda soal. Nama dan format ikut antara muka. Contoh : modes=bus,tram pilih mod dalam URL sesuai. Mendalami dalam panduan : [Cara Memasukkan Peta Mobiliti dalam Laman Web Anda?](https://www.roote.ai/ms/guides/cara-memasukkan-peta-mobiliti-di-laman-web/) ## Status HTTP Kod hasil permintaan di tahap HTTP. Perlu disahkan isi dan status aplikasi. Contoh : HTTP 200 boleh ada status aplikasi error. Mendalami dalam panduan : [Tiada keputusan atau ralat API: bagaimana membuat perbezaan?](https://www.roote.ai/ms/guides/tiada-keputusan-atau-ralat-api-bagaimana-membuat-perbezaan/) ## Keputusan kosong — empty Carian tidak pulangkan entiti dalam kawasan semak. Tidak buktikan tiada perkhidmatan secara fizikal. Contoh : Tiada hentian pulang ikut tapisan. Mendalami dalam panduan : [Tiada keputusan atau ralat API: bagaimana membuat perbezaan?](https://www.roote.ai/ms/guides/tiada-keputusan-atau-ralat-api-bagaimana-membuat-perbezaan/) ## Balasan separa — partial Keputusan ada maklumat guna dengan had atau elemen terhilang. Harus ada amaran bersesuaian. Contoh : Satu sumber balas, satu tidak dapat. Mendalami dalam panduan : [Tiada keputusan atau ralat API: bagaimana membuat perbezaan?](https://www.roote.ai/ms/guides/tiada-keputusan-atau-ralat-api-bagaimana-membuat-perbezaan/) ## Masa tamat — timeout Gangguan menunggu melebihi masa diizinkan. Tunjuk carian tidak selesai, bukan tiada hasil. Contoh : Aplikasi cadang cuba semula, bukan tunjuk senarai kosong. Mendalami dalam panduan : [Tiada keputusan atau ralat API: bagaimana membuat perbezaan?](https://www.roote.ai/ms/guides/tiada-keputusan-atau-ralat-api-bagaimana-membuat-perbezaan/) ## Had kadar — rate limit Sekatan kadar permintaan dibenarkan. Peraturan dan cara sambung ikut kontrak aktif. Contoh : Kod 429 minta ikut panduan sambung. Mendalami dalam panduan : [Tiada keputusan atau ralat API: bagaimana membuat perbezaan?](https://www.roote.ai/ms/guides/tiada-keputusan-atau-ralat-api-bagaimana-membuat-perbezaan/) ## Token Bearer ID akses dihantar dalam header Authorization ikut mekanisma. Simpan dalam konfigurasi selamat. Contoh : Authorization: Bearer guna tanpa siar token dalam URL. Mendalami dalam panduan : [Bagaimana untuk menyambungkan Pembantu IA ke MCP ROOTE?](https://www.roote.ai/ms/guides/cara-sambungkan-pembantu-ia-ke-mcp-roote/) ## JSON Format teks berstruktur guna objek, tatasusunan, rentetan dan nombor. JSON sah sintaks boleh tidak ikut skema API. Contoh : Koleksi stesen mesti ada jenis dan medan dijangka. Mendalami dalam panduan : [Bagaimana cara mencari perhentian pengangkutan berhampiran menggunakan API?](https://www.roote.ai/ms/guides/cara-mencari-perhentian-pengangkutan-berhampiran-dengan-api/) ## OpenAPI Spesifikasi terangkan kontrak API HTTP dalam dokumen berstruktur. Bantu semak laluan, parameter, balasan dan skema. Contoh : Kontrak ROOTE diterbit dalam openapi.json. Mendalami dalam panduan : [Bagaimana cara mencari perhentian pengangkutan berhampiran menggunakan API?](https://www.roote.ai/ms/guides/cara-mencari-perhentian-pengangkutan-berhampiran-dengan-api/) ## Embed — peta terbenam Sisipan pengalaman luar dalam halaman seperti peta dalam iframe. Parameter dan kebenaran tentukan konteks guna. Contoh : Iframe ROOTE paparkan basikal sekitar Bordeaux. Mendalami dalam panduan : [Cara Memasukkan Peta Mobiliti dalam Laman Web Anda?](https://www.roote.ai/ms/guides/cara-memasukkan-peta-mobiliti-di-laman-web/) ## Iframe Elemen HTML muat dokumen dalam halaman. Pada domain berlainan, halaman utama tidak boleh baca status dokumen disisip secara bebas. Contoh : Pertukaran dokumentasi perlu untuk kemas kini carian naik ke halaman utama. Mendalami dalam panduan : [Cara Memasukkan Peta Mobiliti dalam Laman Web Anda?](https://www.roote.ai/ms/guides/cara-memasukkan-peta-mobiliti-di-laman-web/) ## MCP — Model Context Protocol Protokol untuk aplikasi AI berkomunikasi dengan pelayan pamer alat atau konteks. Tidak tentukan sendiri kualiti data. Contoh : Pembantu temui alat carian ROOTE. Mendalami dalam panduan : [Apakah itu pelayan MCP dan apa fungsinya?](https://www.roote.ai/ms/guides/apa-itu-pelayan-mcp-dan-fungsinya/) ## Pelayan MCP Program pamer keupayaan ikut protokol MCP. Alat diisytihar tentukan boleh digunakan klien. Contoh : tools/list untuk semak inventori tersedia. Mendalami dalam panduan : [Apakah itu pelayan MCP dan apa fungsinya?](https://www.roote.ai/ms/guides/apa-itu-pelayan-mcp-dan-fungsinya/) ## Klien MCP Komponen aplikasi AI komunikasi dengan pelayan MCP. Urus pertukaran protokol sambungan itu. Contoh : Klien hantar argumen carian ke ROOTE. Mendalami dalam panduan : [Apakah itu pelayan MCP dan apa fungsinya?](https://www.roote.ai/ms/guides/apa-itu-pelayan-mcp-dan-fungsinya/) ## Aplikasi hos MCP Aplikasi bagi interaksi pengguna dan urus satu atau lebih klien MCP. Bertanggungjawab guna hasil dalam pengalaman. Contoh : Aplikasi perbualan hubungkan pelayan ROOTE. Mendalami dalam panduan : [Apakah itu pelayan MCP dan apa fungsinya?](https://www.roote.ai/ms/guides/apa-itu-pelayan-mcp-dan-fungsinya/) ## Alat MCP Keupayaan boleh laksana diterangkan nama, fungsi dan skema argumen. Pembantu guna input diterima oleh skema. Contoh : geocode terima alamat; transit_nearby terima koordinat. Mendalami dalam panduan : [Bagaimana untuk menyambungkan Pembantu IA ke MCP ROOTE?](https://www.roote.ai/ms/guides/cara-sambungkan-pembantu-ia-ke-mcp-roote/) ## Streamable HTTP Transport MCP untuk komunikasi pelayan jauh melalui HTTP. Sokongan perlu disahkan dalam klien. Contoh : Pelayan jauh ROOTE guna https://mcp.roote.ai/mcp. Mendalami dalam panduan : [Bagaimana untuk menyambungkan Pembantu IA ke MCP ROOTE?](https://www.roote.ai/ms/guides/cara-sambungkan-pembantu-ia-ke-mcp-roote/) ## Jawapan berasaskan data — grounding Pembinaan jawapan dari maklumat benar diambil atau diberi. Ruang kosong dan cadangan harus nyata. Contoh : Pembantu guna tempat dikembalikan tanpa reka jadual. Mendalami dalam panduan : [Bagaimana cara mencipta pembantu yang mencari mobiliti di sekitar alamat?](https://www.roote.ai/ms/guides/cara-cipta-pembantu-mobiliti-sekitar-alamat/) ## Halusinasi pembantu AI Pengeluaran maklumat tidak disokong tetapi dipaparkan seolah benar. Dalam mobiliti, mungkin jadual atau ketersediaan direka. Contoh : Pembantu umum laluan tetapi alat hanya balas hentian. Mendalami dalam panduan : [Bagaimana cara mencipta pembantu yang mencari mobiliti di sekitar alamat?](https://www.roote.ai/ms/guides/cara-cipta-pembantu-mobiliti-sekitar-alamat/) ## Suntikan arahan Cubaan guna kandungan luar ubah arahan pembantu. Keterangan pembekal hanya data, bukan arahan. Contoh : Arahan tersembunyi dalam nama tempat tidak harus dijalankan. Mendalami dalam panduan : [Bagaimana cara mencipta pembantu yang mencari mobiliti di sekitar alamat?](https://www.roote.ai/ms/guides/cara-cipta-pembantu-mobiliti-sekitar-alamat/) ## Cuma baca Keupayaan lihat tanpa tindakan ubah ikut alat. Lihat ketersediaan bukan tempah, buka kunci atau sewa kenderaan. Contoh : Alat Data ROOTE untuk lihat maklumat. Mendalami dalam panduan : [Apakah itu pelayan MCP dan apa fungsinya?](https://www.roote.ai/ms/guides/apa-itu-pelayan-mcp-dan-fungsinya/)