Trip and Order Progress

Lớp FleetEngineTripLocationProvider

Lớp google.maps.journeySharing.FleetEngineTripLocationProvider

Nhà cung cấp vị trí của chuyến đi.

Lớp này mở rộng PollingLocationProvider.

Truy cập bằng cách gọi const {FleetEngineTripLocationProvider} = await google.maps.importLibrary("journeySharing").
Xem Thư viện trong Maps JavaScript API.
FleetEngineTripLocationProvider
FleetEngineTripLocationProvider(options)
Tham số: 
Tạo một trình cung cấp vị trí mới cho chuyến đi trên Fleet Engine.
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params)
Tham số: 
Giá trị trả về:  Không có
Chức năng tuỳ chỉnh đường nhiều đoạn giúp tô màu đường nhiều đoạn đang hoạt động theo chỉ số tốc độ. Chỉ định hàm này là FleetEngineTripLocationProviderOptions.activePolylineCustomization để hiển thị một đường nhiều đoạn có nhận biết lưu lượng truy cập cho đường nhiều đoạn đang hoạt động.
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params)
Tham số: 
Giá trị trả về:  Không có
Chức năng tuỳ chỉnh đường nhiều đường giúp tô màu phần còn lại của đường nhiều đường theo tốc độ đọc. Chỉ định hàm này làm FleetEngineTripLocationProviderOptions.remainingPolylineCustomization để hiển thị một đường nhiều đoạn có nhận biết lưu lượng truy cập cho đường nhiều đoạn còn lại.
tripId
Loại:  string
Mã của chuyến đi mà trình cung cấp vị trí này theo dõi. Đặt trường này để bắt đầu theo dõi.
Được kế thừa: isPolling, pollingIntervalMillis
refresh
refresh()
Tham số:  Không có
Giá trị trả về:  void
Làm mới rõ ràng vị trí được theo dõi.
Kế thừa: addListener
error
function(event)
Đối số: 
Sự kiện được kích hoạt khi trình cung cấp vị trí gặp lỗi.
update
function(event)
Đối số: 
Sự kiện được kích hoạt khi yêu cầu cập nhật dữ liệu Fleet Engine hoàn tất.
Kế thừa: ispollingchange

Giao diện FleetEngineTripLocationProviderOptions

google.maps.journeySharing.FleetEngineTripLocationProviderOptionsgiao diện

Các lựa chọn cho trình cung cấp vị trí của chuyến đi.
authTokenFetcher
Cung cấp mã thông báo web JSON để xác thực ứng dụng với Fleet Engine.
projectId
Loại:  string
Mã dự án của người dùng trên Google Cloud Console.
activePolylineCustomization optional
Loại:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional
Chế độ tuỳ chỉnh được áp dụng cho đường nhiều đoạn đang hoạt động. Một đường nhiều đường đang hoạt động tương ứng với một phần của tuyến đường mà xe hiện đang di chuyển.

Sử dụng trường này để chỉ định kiểu dáng tuỳ chỉnh (chẳng hạn như màu đường nhiều đoạn) và khả năng tương tác (chẳng hạn như xử lý lượt nhấp).
  • Nếu bạn chỉ định một đối tượng PolylineOptions, thì những thay đổi được chỉ định trong đối tượng đó sẽ được áp dụng cho đường nhiều đoạn sau khi đường nhiều đoạn được tạo, ghi đè các lựa chọn mặc định của đường nhiều đoạn nếu có.
  • Nếu bạn chỉ định một hàm, thì hàm đó sẽ được gọi một lần khi đường nhiều đoạn được tạo. (Trong lệnh gọi này, tham số isNew trong đối tượng tham số hàm được đặt thành true.) Ngoài ra, hàm này được gọi khi toạ độ của đường nhiều đường thay đổi hoặc khi trình cung cấp vị trí nhận được dữ liệu từ Fleet Engine, bất kể dữ liệu tương ứng với đường nhiều đường này có thay đổi hay không.

    Hãy xem TripPolylineCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng các tham số đó.
destinationMarkerCustomization optional
Loại:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Chế độ tuỳ chỉnh được áp dụng cho điểm đánh dấu đích đến.

Sử dụng trường này để chỉ định kiểu tuỳ chỉnh (chẳng hạn như biểu tượng điểm đánh dấu) và khả năng tương tác (chẳng hạn như xử lý lượt nhấp).
  • Nếu bạn chỉ định một đối tượng MarkerOptions, thì những thay đổi được chỉ định trong đối tượng đó sẽ được áp dụng cho điểm đánh dấu sau khi điểm đánh dấu được tạo, ghi đè các lựa chọn mặc định của điểm đánh dấu nếu có.
  • Nếu bạn chỉ định một hàm, thì hàm đó sẽ được gọi một lần khi điểm đánh dấu được tạo, trước khi được thêm vào khung hiển thị bản đồ. (Trong lệnh gọi này, tham số isNew trong đối tượng tham số hàm được đặt thành true.) Ngoài ra, hàm này được gọi khi trình cung cấp vị trí nhận được dữ liệu từ Fleet Engine, bất kể dữ liệu tương ứng với điểm đánh dấu này có thay đổi hay không.

    Hãy xem TripMarkerCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng các tham số đó.
originMarkerCustomization optional
Loại:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Chế độ tuỳ chỉnh được áp dụng cho điểm đánh dấu gốc.

Sử dụng trường này để chỉ định kiểu tuỳ chỉnh (chẳng hạn như biểu tượng điểm đánh dấu) và khả năng tương tác (chẳng hạn như xử lý lượt nhấp).
  • Nếu bạn chỉ định một đối tượng MarkerOptions, thì những thay đổi được chỉ định trong đối tượng đó sẽ được áp dụng cho điểm đánh dấu sau khi điểm đánh dấu được tạo, ghi đè các lựa chọn mặc định của điểm đánh dấu nếu có.
  • Nếu bạn chỉ định một hàm, thì hàm đó sẽ được gọi một lần khi điểm đánh dấu được tạo, trước khi được thêm vào khung hiển thị bản đồ. (Trong lệnh gọi này, tham số isNew trong đối tượng tham số hàm được đặt thành true.) Ngoài ra, hàm này được gọi khi trình cung cấp vị trí nhận được dữ liệu từ Fleet Engine, bất kể dữ liệu tương ứng với điểm đánh dấu này có thay đổi hay không.

    Hãy xem TripMarkerCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng các tham số đó.
pollingIntervalMillis optional
Loại:  number optional
Thời gian tối thiểu giữa các lần tìm nạp thông tin cập nhật vị trí (tính bằng mili giây). Nếu mất nhiều thời gian hơn pollingIntervalMillis để tìm nạp thông tin cập nhật vị trí, thì thông tin cập nhật vị trí tiếp theo sẽ không bắt đầu cho đến khi thông tin hiện tại hoàn tất.

Khi bạn đặt giá trị này thành 0, các bản cập nhật vị trí định kỳ sẽ bị tắt. Thông tin cập nhật vị trí mới sẽ được tìm nạp nếu có bất kỳ thông số nào mà trình cung cấp vị trí quan sát được thay đổi.

Khoảng thời gian thăm dò mặc định là 5000 mili giây, đây là khoảng thời gian tối thiểu. Nếu bạn đặt khoảng thời gian thăm dò thành một giá trị khác 0 thấp hơn, thì 5000 sẽ được dùng.
remainingPolylineCustomization optional
Loại:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional
Tuỳ chỉnh được áp dụng cho phần còn lại của đường nhiều đoạn. Một đường nhiều đường còn lại tương ứng với một phần của tuyến đường mà xe chưa bắt đầu di chuyển.

Sử dụng trường này để chỉ định kiểu dáng tuỳ chỉnh (chẳng hạn như màu đường nhiều đoạn) và khả năng tương tác (chẳng hạn như xử lý lượt nhấp).
  • Nếu bạn chỉ định một đối tượng PolylineOptions, thì những thay đổi được chỉ định trong đối tượng đó sẽ được áp dụng cho đường nhiều đoạn sau khi đường nhiều đoạn được tạo, ghi đè các lựa chọn mặc định của đường nhiều đoạn nếu có.
  • Nếu bạn chỉ định một hàm, thì hàm đó sẽ được gọi một lần khi đường nhiều đoạn được tạo. (Trong lệnh gọi này, tham số isNew trong đối tượng tham số hàm được đặt thành true.) Ngoài ra, hàm này được gọi khi toạ độ của đường nhiều đường thay đổi hoặc khi trình cung cấp vị trí nhận được dữ liệu từ Fleet Engine, bất kể dữ liệu tương ứng với đường nhiều đường này có thay đổi hay không.

    Hãy xem TripPolylineCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng các tham số đó.
takenPolylineCustomization optional
Loại:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional
Đã áp dụng chế độ tuỳ chỉnh cho đường nhiều đường đã chụp. Đường nhiều đường đã đi tương ứng với một phần của tuyến đường mà xe đã đi qua.

Sử dụng trường này để chỉ định kiểu dáng tuỳ chỉnh (chẳng hạn như màu đường nhiều đoạn) và khả năng tương tác (chẳng hạn như xử lý lượt nhấp).
  • Nếu bạn chỉ định một đối tượng PolylineOptions, thì những thay đổi được chỉ định trong đối tượng đó sẽ được áp dụng cho đường nhiều đoạn sau khi đường nhiều đoạn được tạo, ghi đè các lựa chọn mặc định của đường nhiều đoạn nếu có.
  • Nếu bạn chỉ định một hàm, thì hàm đó sẽ được gọi một lần khi đường nhiều đoạn được tạo. (Trong lệnh gọi này, tham số isNew trong đối tượng tham số hàm được đặt thành true.) Ngoài ra, hàm này được gọi khi toạ độ của đường nhiều đường thay đổi hoặc khi trình cung cấp vị trí nhận được dữ liệu từ Fleet Engine, bất kể dữ liệu tương ứng với đường nhiều đường này có thay đổi hay không.

    Hãy xem TripPolylineCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng các tham số đó.
tripId optional
Loại:  string optional
Mã chuyến đi cần theo dõi ngay sau khi trình cung cấp vị trí được khởi tạo. Nếu bạn không chỉ định, trình cung cấp vị trí sẽ không bắt đầu theo dõi bất kỳ chuyến đi nào; hãy dùng FleetEngineTripLocationProvider.tripId để đặt mã nhận dạng và bắt đầu theo dõi.
vehicleMarkerCustomization optional
Loại:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Chế độ tuỳ chỉnh được áp dụng cho điểm đánh dấu xe.

Sử dụng trường này để chỉ định kiểu tuỳ chỉnh (chẳng hạn như biểu tượng điểm đánh dấu) và khả năng tương tác (chẳng hạn như xử lý lượt nhấp).
  • Nếu bạn chỉ định một đối tượng MarkerOptions, thì những thay đổi được chỉ định trong đối tượng đó sẽ được áp dụng cho điểm đánh dấu sau khi điểm đánh dấu được tạo, ghi đè các lựa chọn mặc định của điểm đánh dấu nếu có.
  • Nếu bạn chỉ định một hàm, thì hàm đó sẽ được gọi một lần khi điểm đánh dấu được tạo, trước khi được thêm vào khung hiển thị bản đồ. (Trong lệnh gọi này, tham số isNew trong đối tượng tham số hàm được đặt thành true.) Ngoài ra, hàm này được gọi khi trình cung cấp vị trí nhận được dữ liệu từ Fleet Engine, bất kể dữ liệu tương ứng với điểm đánh dấu này có thay đổi hay không.

    Hãy xem TripMarkerCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng các tham số đó.
waypointMarkerCustomization optional
Tuỳ chỉnh được áp dụng cho một điểm đánh dấu điểm tham chiếu.

Sử dụng trường này để chỉ định kiểu tuỳ chỉnh (chẳng hạn như biểu tượng điểm đánh dấu) và khả năng tương tác (chẳng hạn như xử lý lượt nhấp).
  • Nếu bạn chỉ định một đối tượng MarkerOptions, thì những thay đổi được chỉ định trong đối tượng đó sẽ được áp dụng cho điểm đánh dấu sau khi điểm đánh dấu được tạo, ghi đè các lựa chọn mặc định của điểm đánh dấu nếu có.
  • Nếu bạn chỉ định một hàm, thì hàm đó sẽ được gọi một lần khi điểm đánh dấu được tạo, trước khi được thêm vào khung hiển thị bản đồ. (Trong lệnh gọi này, tham số isNew trong đối tượng tham số hàm được đặt thành true.) Ngoài ra, hàm này được gọi khi trình cung cấp vị trí nhận được dữ liệu từ Fleet Engine, bất kể dữ liệu tương ứng với điểm đánh dấu này có thay đổi hay không.

    Hãy xem TripWaypointMarkerCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng các tham số đó.

Giao diện FleetEngineTripLocationProviderUpdateEvent

google.maps.journeySharing.FleetEngineTripLocationProviderUpdateEventgiao diện

Đối tượng sự kiện được truyền đến trình xử lý sự kiện khi sự kiện FleetEngineTripLocationProvider.update được kích hoạt.
trip optional
Loại:  Trip optional
Cấu trúc chuyến đi do bản cập nhật trả về. Không thể sửa đổi.