Ảo giác trợ lý AI
Tạo thông tin không có căn cứ nhưng trình bày như đã biết; trong di chuyển có thể là giờ hoặc khả năng bịa đặt.
Ví dụ
Trợ lý báo chuyến trong khi công cụ chỉ trả điểm dừng.
Bảng thuật ngữ ROOTE
Bảng thuật ngữ về di chuyển và dữ liệu.
Định nghĩa đơn giản để hiểu giao thông, dịch vụ gần bạn và công cụ kết nối với ứng dụng của bạn.
79 định nghĩa hiển thị
Ả
A
API
Giao diện để chương trình dùng khả năng dịch vụ khác qua hợp đồng định nghĩa, gồm đầu vào và phản hồi mong đợi.
Ví dụ
Ứng dụng tìm điểm dừng qua API ROOTE.
API REST
Cách giao diện HTTP sử dụng tài nguyên và cơ chế web; hợp đồng API xác định tuyến, phương thức và định dạng.
Ví dụ
Tìm kiếm gửi qua tuyến GET đã tài liệu.
B
Bán kính tìm kiếm
Khoảng cách quanh điểm gốc giới hạn tìm, đơn vị và giới hạn tùy theo hợp đồng hoặc công cụ.
Ví dụ
radius=600 yêu cầu bán kính 600 mét trong ví dụ REST.
Bộ nhớ đệm
Lưu tạm kết quả để tránh tìm trùng lặp; giá trị trong bộ nhớ giữ nguồn và thời gian gốc.
Ví dụ
Hai yêu cầu giống nhau có thể dùng lại kết quả còn hiệu lực.
C
Chèn lệnh yêu cầu
Cố ý dùng nội dung bên ngoài để thay đổi hướng dẫn trợ lý; thông tin nhà cung cấp phải là dữ liệu, không phải lệnh.
Ví dụ
Lệnh bí ẩn trong tên địa điểm không được thực thi.
Chỉ xem
Chức năng chỉ cho xem, không cho phép tác động sửa đổi; xem khả dụng không đặt chỗ hay thuê xe.
Ví dụ
Công cụ Dữ liệu ROOTE dùng để xem thông tin.
Chuyến đi
Việc thực hiện dịch vụ vận tải gắn lộ trình và các điểm dừng. Trong GTFS, chuyến liên kết với tuyến và lịch phục vụ.
Ví dụ
Hai chuyến kế tiếp trên cùng tuyến là hai chuyến khác nhau.
Chuyển tuyến
Chuyển từ dịch vụ hoặc phương thức này sang khác trong hành trình. Gần hai điểm dừng không đảm bảo chuyển tuyến khả thi.
Ví dụ
Cần tính thời gian di chuyển và chờ đợi giữa các sân ga.
Cọc giữ xe
Trang bị tại trạm để gắn xe đạp. Không đảm bảo luôn có thể trả xe tại thời điểm xem.
Ví dụ
Phải có chỗ trả xe sẵn và sử dụng được.
Công cụ MCP
Chức năng mô tả bằng tên, tác vụ và schema tham số; trợ lý dùng đúng đầu vào theo schema này.
Ví dụ
geocode nhận địa chỉ; transit_nearby nhận tọa độ.
D
Dấu thời gian
Thời điểm liên kết với dữ liệu hay sự kiện, ý nghĩa tùy theo trường dữ liệu: quan sát, cập nhật, nhận hoặc hết hạn.
Ví dụ
source_updated_at và received_at mô tả giai đoạn khác nhau.
Di chuyển chia sẻ
Tập hợp dịch vụ cho phép nhiều người dùng liên tục sử dụng cùng phương tiện, thay vì phương tiện riêng của cá nhân.
Ví dụ
Xe đạp và xe trượt cho thuê trong thành phố.
Dịch vụ đô thị
Thiết bị hoặc dịch vụ phổ biến gần nơi, ví dụ nhà vệ sinh, điểm nước uống, trạm sạc, thường có thông tin chưa đầy đủ.
Ví dụ
Kết quả gần bạn cho biết dịch vụ và thông tin hiện có.
Dữ liệu lỗi thời — stale
Thông tin quá cũ theo hợp đồng hoặc chính sách, có thể giữ làm lịch sử gần nhưng không dùng như mới.
Ví dụ
Giao diện báo dữ liệu cần cập nhật.
Dữ liệu thời gian thực
Thông tin cập nhật thể hiện tình trạng gần đây hoặc phục vụ ước tính. Độ mới phải đánh giá; thời gian thực không đồng nghĩa tức thì hoặc đảm bảo.
Ví dụ
Ước tính lượt xe cập nhật từ dữ liệu mới.
Đ
Điểm bắt đầu tìm kiếm
Điểm xuất phát tìm gần và tính khoảng cách, có thể khác trung tâm bản đồ hiển thị.
Ví dụ
Camera di chuyển nhưng tìm vẫn tập trung Bordeaux.
Điểm cuối
Điểm kết thúc lộ trình giao thông. Tuyến có thể có nhiều biến thể với điểm cuối khác nhau.
Ví dụ
Chuyến ngắn kết thúc trước điểm cuối thông thường.
Điểm cuối — tuyến API
Địa chỉ cùng thao tác cung cấp chức năng API; các tuyến khác nhau trả kết quả kiểu khác nhau.
Ví dụ
/v1/transit/nearby tìm nơi giao thông.
Điểm dừng giao thông
Nơi dịch vụ giao thông đón hoặc trả khách. Điểm dừng công khai không tự động có lịch trình kế tiếp.
Ví dụ
Điểm dừng xe buýt trả về không có giờ khởi hành.
Điểm quan tâm — POI
Nơi nhận biết hữu ích cho tìm kiếm, như doanh nghiệp hay thiết bị; khác với địa chỉ bưu chính đơn thuần.
Ví dụ
Tên khách sạn có thể tìm như doanh nghiệp.
Định vị địa lý
Lấy vị trí địa lý qua thiết bị hoặc ứng dụng, phụ thuộc quyền truy cập và độ chính xác.
Ví dụ
Nút định vị yêu cầu sự đồng ý của trình duyệt.
Độ mới dữ liệu
Đánh giá tính cập nhật dựa trên thời gian và quy định hợp đồng; giờ xem không chứng minh tính mới nguồn.
Ví dụ
Số liệu nhận giờ hiện tại có thể từ quan sát cũ.
G
Gán nguồn
Nhận dạng nhà cung cấp hoặc nguồn dữ liệu; khi bắt buộc, ứng dụng phải hiển thị thông tin này.
Ví dụ
Khi required=true, nhãn nguồn phải giữ trên giao diện.
GBFS
Định dạng chuẩn dữ liệu công khai cho phương tiện dùng chung, phiên bản và luồng mô tả hệ thống, trạm, phương tiện và trạng thái.
Ví dụ
Thông tin trạm và số liệu khả dụng tách biệt.
Giá trị không biết — null
Không có giá trị biết trong hợp đồng, dùng null để biểu thị; không thay bằng số 0, false hay bằng chứng không có.
Ví dụ
Đếm xe null không có nghĩa trạm trống.
Gián đoạn
Sự kiện ảnh hưởng dịch vụ vận tải, như tạm ngưng hoặc thay đổi lộ trình, với phạm vi và thời gian xác định.
Ví dụ
Cảnh báo có thể chỉ áp dụng cho một tuyến trong thời gian nhất định.
Giao thông liên-modal
Sử dụng nhiều phương thức di chuyển nối tiếp trong một chuyến, mỗi đoạn có lịch trình, quyền truy cập và điều kiện riêng.
Ví dụ
Bạn đi xe đạp đến tram rồi đi bộ tiếp.
Giờ dự kiến
Giờ theo lịch kế hoạch cho ngày và lượt xe, không nhất thiết phản ánh tình hình hiện tại.
Ví dụ
Khởi hành dự kiến lúc 8:10 theo lịch.
Giờ mở cửa
Khoảng thời gian nơi công bố mở cửa, không phải xác nhận trực tiếp hoạt động hiện tại.
Ví dụ
Đóng cửa tạm thời có thể không phản ánh trong giờ mở theo thông thường.
Giờ ước tính
Dự đoán thời gian đến dựa trên dữ liệu hiện có, có thể thay đổi khi có thông tin mới.
Ví dụ
Dự kiến 8:10 giờ nay ước tính 8:14.
Giới hạn tần suất — rate limit
Hạn chế tốc độ yêu cầu cho phép; quy tắc và cách tiếp tục theo hợp đồng hiện hành.
Ví dụ
Mã 429 yêu cầu tuân thủ chỉ dẫn hoãn lại.
GTFS Realtime — GTFS-RT
Định dạng chuẩn truyền cập nhật chuyến, vị trí phương tiện, cảnh báo; loại dữ liệu phụ thuộc nhà cung cấp.
Ví dụ
Luồng vị trí không đảm bảo có ước tính cho mọi điểm dừng.
GTFS Schedule
Định dạng chuẩn mô tả dịch vụ giao thông kế hoạch: điểm dừng, tuyến, chuyến, lịch và giờ; không tự động cập nhật thời gian thực.
Ví dụ
Lịch trình liên kết chuyến và ngày phục vụ.
H
Hướng đi
Chỉ dẫn chiều hoặc điểm đến dịch vụ. Phải xác thực với lộ trình và nơi lên xe.
Ví dụ
Bạn tìm tram đi điểm đến của bạn, không phải chiều ngược lại.
I
Iframe
Thẻ HTML tải tài liệu trong trang, với domain khác trang cha không thể đọc trạng thái bên trong tự do.
Ví dụ
Thay đổi tìm cần trao đổi có tài liệu để thông báo lên cha.
J
JSON
Định dạng văn bản cấu trúc gồm đối tượng, mảng, chuỗi và số; JSON hợp lệ chưa chắc thỏa schema API.
Ví dụ
Bộ sưu tập stations cần đúng kiểu và trường.
K
Kết quả một phần — partial
Kết quả có dữ liệu hữu dụng nhưng thiếu hoặc giới hạn, kèm cảnh báo thích hợp.
Ví dụ
Nguồn phản hồi khi nguồn khác không có.
Kết quả trống — empty
Tìm không trả thực thể trong vùng xem, không chứng minh ngoài vùng có dịch vụ hay không.
Ví dụ
Không có điểm dừng phù hợp bộ lọc.
Khả dụng
Tình trạng hoặc số lượng có thể sử dụng theo dữ liệu biết được. Khả dụng quan sát có thể thay đổi và không phải đặt chỗ.
Ví dụ
Ba xe quan sát ở trạm không đồng nghĩa ba xe đã đặt chỗ.
Khả năng tiếp cận
Đặc điểm cho phép người dùng với nhu cầu khác nhau sử dụng tại nơi hoặc dịch vụ. Dữ liệu thiếu không có nghĩa là có hoặc không khả năng tiếp cận.
Ví dụ
Khả năng đi xe lăn có thể được ghi hoặc không biết.
Khách MCP
Thành phần ứng dụng AI giao tiếp server MCP, quản lý trao đổi giao thức kết nối.
Ví dụ
Client gửi dẫn số tìm tới ROOTE.
Khoảng cách địa lý
Khoảng cách tính giữa các vị trí theo phương pháp dịch vụ; không phải khoảng cách đi đường hay thời gian đi bộ.
Ví dụ
Nơi gần có thể phải đi vòng xa mới đến được.
Không trạm – free-floating
Hình thức xe không bắt buộc phải lấy hoặc trả tại trạm cố định. Khu vực và quy định đỗ xe vẫn theo dịch vụ.
Ví dụ
Xe trượt phải trả trong khu vực được phép.
Khởi hành sắp tới
Chuyến hoặc lượt xe sắp tới tại điểm và dịch vụ. Tìm điểm dừng không tương đương tìm lịch khởi hành tiếp theo.
Ví dụ
Danh sách điểm dừng và danh sách khởi hành là kết quả riêng biệt.
Kinh độ
Tọa độ đông hoặc tây so với kinh tuyến gốc, đo bằng độ từ −180 đến 180.
Ví dụ
Kinh độ có thể gửi qua lon hoặc alias lng.
L
Lấy phương tiện
Hành động bắt đầu sử dụng phương tiện. Có xe và số đếm dương chưa đủ nếu dịch vụ báo tạm ngưng lấy xe.
Ví dụ
Xe có mặt nhưng trạm có thể không cho thuê.
Lịch phục vụ
Thông tin ngày dịch vụ vận tải hoạt động, kèm ngoại lệ nếu có. Lịch trình phải được hiểu theo lịch này.
Ví dụ
Chuyến trong tuần có thể không hoạt động chủ nhật.
Loại dịch vụ
Phân loại để chọn hoặc mô tả dịch vụ đô thị, giá trị chấp nhận dựa theo giao diện và mô hình dữ liệu.
Ví dụ
API Services ROOTE dùng types=toilets cho nhà vệ sinh.
M
Mã Bearer
Mã truy cập gửi trong tiêu đề Authorization, theo cơ chế bảo mật; phải giữ an toàn cấu hình.
Ví dụ
Authorization: Bearer dùng không công khai token trong URL.
Mã địa lý
Tìm kiếm chuyển địa chỉ hoặc biểu thức thành ứng viên có tọa độ; nhiều nơi có thể cùng tên.
Ví dụ
Hai thành phố có phố cùng tên.
Mã địa lý ngược
Tìm địa điểm hoặc tên gọi dựa trên tọa độ, kết quả có thể là nơi gần hơn chứ không phải địa chỉ chính xác.
Ví dụ
Điểm GPS liên kết với tên đọc được.
Máy chủ MCP
Chương trình cung cấp chức năng theo giao thức MCP; công cụ được server tuyên bố quyết định lệnh gọi của client.
Ví dụ
tools/list xem danh sách công cụ sẵn có.
MCP — Model Context Protocol
Giao thức cho ứng dụng AI giao tiếp với server lộ công cụ hoặc ngữ cảnh; không tự xác định chất lượng dữ liệu trả về.
Ví dụ
Trợ lý phát hiện công cụ tìm ROOTE.
N
Nguồn gốc
Thông tin xác định nơi dữ liệu lấy và cách tạo theo hợp đồng, giúp hiểu ý nghĩa dữ liệu.
Ví dụ
Kết quả giữ nguồn và ngữ cảnh thu thập.
Người hạn chế vận động — PMR
Người gặp khó khăn di chuyển lâu dài hoặc tạm thời. Chỉ ghi PMR không thể hiện đầy đủ tất cả nhu cầu hay trang bị cần có.
Ví dụ
Có dốc lên không mô tả hết mọi chướng ngại vật.
Nhà vệ sinh công cộng
Nhà vệ sinh dành cho công chúng theo quy định địa phương, có thể không miễn phí, không mở cửa liên tục hoặc không hoàn toàn tiếp cận được.
Ví dụ
Kiểm tra điều kiện trước khi đến dùng.
Nhúng — bản đồ tích hợp
Chèn trải nghiệm ngoài trong trang, ví dụ bản đồ trong iframe; tham số và quyền quyết định bối cảnh dùng.
Ví dụ
Iframe ROOTE hiển thị xe đạp quanh Bordeaux.
Nước uống được
Nước được công nhận an toàn cho người tiêu dùng. Điểm nước hay vòi không nên ghi là nước uống nếu không có thông tin rõ ràng.
Ví dụ
Loại thiết bị và thuộc tính phải được phân biệt.
O
OpenAPI
Đặc tả mô tả hợp đồng API HTTP bằng tập tin có cấu trúc, hỗ trợ kiểm định tuyến, tham số, trả lời và schema.
Ví dụ
Hợp đồng ROOTE công bố trong openapi.json.
P
Phạm vi
Khu vực và mức độ đầy đủ dữ liệu cho tìm kiếm hoặc nguồn; phạm vi hạn chế làm giới hạn kết luận.
Ví dụ
Danh sách có thể hữu ích dù không đủ tất cả dịch vụ.
Phản hồi dựa dữ liệu — grounding
Tạo câu trả lời từ thông tin thực lấy được hoặc cung cấp; phần thiếu và giới hạn phải hiển thị rõ.
Ví dụ
Trợ lý trình bày địa điểm trả về, không bịa thông tin giờ mở.
Phóng to bản đồ
Mức thu phóng bản đồ, điều khiển hiển thị nhưng không thay thế bán kính truy vấn API.
Ví dụ
zoom=15 phóng to bản đồ.
Q
Quá thời gian — timeout
Ngắt chờ vượt quá thời gian thao tác; chỉ ra tìm không hoàn tất, không phải không có kết quả.
Ví dụ
Ứng dụng đề xuất thử lại thay vì trả danh sách trống.
Quan sát
Trạng thái hoặc sự kiện đã xảy ra tại thời điểm xác định, khác với dự kiến hay ước tính.
Ví dụ
Lượt xe thực tế có thể khác ước tính.
S
Sân ga, sân đỗ
Nơi đón khách của điểm giao thông. Nhiều sân có thể phục vụ hướng hoặc dịch vụ khác nhau.
Ví dụ
Hai chiều của tuyến có thể dùng sân riêng biệt.
Streamable HTTP
Phương thức MCP qua HTTP từ client đến server. Hỗ trợ cần kiểm tra trong client dùng.
Ví dụ
Server ROOTE dùng https://mcp.roote.ai/mcp.
T
Tham số truy vấn
Giá trị trong phần URL sau dấu hỏi; tên và định dạng theo giao diện sử dụng.
Ví dụ
modes=bus,tram chọn chế độ qua URL hợp lệ.
Thời hạn tồn tại — TTL
Thời lượng dùng quản lý hiệu lực hoặc làm mới dữ liệu trong bộ nhớ đệm, theo hợp đồng; không chứng minh thời gian quan sát gốc.
Ví dụ
Bộ nhớ đệm hết hạn phải theo chính sách làm mới.
Tọa độ GPS
Giá trị mô tả điểm địa lý, thường theo vĩ độ và kinh độ, thứ tự cần làm rõ trong giao diện dùng.
Ví dụ
Tìm gần nhận hai tọa độ khác nhau.
Trả lại
Kết thúc sử dụng phương tiện theo quy định dịch vụ. Nơi trả có thể khác nơi lấy.
Ví dụ
Trạm cho thuê nhưng không còn chỗ trả xe.
Trạm sạc
Thiết bị sạc cho phương tiện tương thích. Xác định vị trí không đảm bảo có sẵn hoặc phù hợp kết nối.
Ví dụ
Vị trí và trạng thái sạc là hai thông tin riêng biệt.
Trạm xe đạp
Nơi tổ chức để nhận hoặc trả xe đạp chia sẻ. Vị trí, dung lượng và khả năng sử dụng thể hiện các đặc tính khác nhau của trạm.
Ví dụ
Trạm có thể hiển thị trên bản đồ nhưng tạm thời không có xe.
Trạng thái HTTP
Mã cho kết quả yêu cầu ở cấp HTTP; cần kiểm tra nội dung và trạng thái nghiệp vụ thêm.
Ví dụ
HTTP 200 có thể chứa lỗi nghiệp vụ.
Tuyến giao thông
Dịch vụ vận tải xác định trong mạng, có một hoặc nhiều lộ trình hoặc biến thể. Tên tuyến chưa chắc xác định đúng chiều đi.
Ví dụ
Một tuyến có thể có nhiều điểm cuối khác nhau.
Ứ
Ứng dụng chủ MCP
Ứng dụng tiếp nhận tương tác người dùng và quản lý một hoặc nhiều client MCP; chịu trách nhiệm dùng kết quả trong giao diện.
Ví dụ
Ứng dụng hội thoại của bạn kết nối server ROOTE.
V
Vĩ độ
Tọa độ bắc hoặc nam xích đạo, đo bằng độ, giá trị hợp lệ từ −90 đến 90.
Ví dụ
Vĩ độ điểm tìm truyền qua lat.
X
Xe đạp điện trợ lực
Xe đạp có động cơ hỗ trợ khi đạp, thông tin loại động cơ và pin có thể tách riêng trong dữ liệu di chuyển.
Ví dụ
Trạm phân biệt xe đạp thường và xe đạp điện.
Xe đạp tự do
Dịch vụ cho mượn xe đạp dùng tạm thời theo điều kiện của nhà cung cấp, có thể dùng với trạm cố định hoặc xe không trạm.
Ví dụ
Bạn tìm xe đạp và sử dụng dịch vụ cho thuê tương ứng.
Không có định nghĩa phù hợp. Thử từ khác hoặc bỏ bộ lọc.
Nguồn tham khảo để tìm hiểu thêm
Các thuật ngữ ROOTE tuân theo hợp đồng được tài liệu hóa. Các tiêu chuẩn và giao thức có nguồn chính thức riêng.
Quay lại trung tâm tài nguyên