Trip and Order Progress

Lớp FleetEngineTripLocationProvider

Lớp google.maps.journeySharing.FleetEngineTripLocationProvider

Nhà cung cấp vị trí 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 API JavaScript Maps.

FleetEngineTripLocationProvider
FleetEngineTripLocationProvider(options)
Các thông số: 
Tạo một nhà cung cấp vị trí mới cho chuyến đi của Fleet Engine.
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params)
Các thông số: 
Giá trị trả lại hàng: Không có
Chức năng tuỳ chỉnh hình nhiều đường để tô màu hình nhiều đường đang hoạt động theo tốc độ đọc. Chỉ định hàm này làm FleetEngineTripLocationProviderOptions.activePolylineCustomization để kết xuất hình nhiều đường nhận biết lưu lượng truy cập cho hình nhiều đường đang hoạt động.
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params)
Các thông số: 
Giá trị trả lại hàng: Không có
Chức năng tuỳ chỉnh hình nhiều đường tô màu hình nhiều đường còn lại theo tốc độ đọc. Chỉ định hàm này làm FleetEngineTripLocationProviderOptions.remainingPolylineCustomization để kết xuất hình nhiều đường nhận biết lưu lượng truy cập cho hình nhiều đường còn lại.
tripId
Loại:  string
Mã cho chuyến đi mà nhà cung cấp vị trí này quan sát. Đặt trường này để bắt đầu theo dõi.
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)
Sự kiện được kích hoạt khi hoàn tất yêu cầu cập nhật dữ liệu của Fleet Engine.
Kế thừa: ispollingchange

Giao diện FleetEngineTripLocationProviderOptions

Giao diện google.maps.journeySharing.FleetEngineTripLocationProviderOptions

Các tuỳ chọn cho trình cung cấp vị trí 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 tiêu dùng trong Google Cloud Console.
activePolylineCustomization optional
Loại:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional
Tuỳ chỉnh được áp dụng cho hình nhiều đường đang hoạt động. Hình nhiều đường đang hoạt động tương ứng với một phần của tuyến đường mà xe đang đi qua.

Sử dụng trường này để chỉ định kiểu tuỳ chỉnh (chẳng hạn như màu nhiều đường) và tính tương tác (chẳng hạn như xử lý lượt nhấp).
  • Nếu bạn chỉ định đối tượng PolylineOptions, các thay đổi được chỉ định trong đối tượng đó sẽ được áp dụng cho hình nhiều đường sau khi hình nhiều đường được tạo, ghi đè các tuỳ chọn mặc định của đối tượng đó (nếu có).
  • Nếu một hàm được chỉ định, hàm này sẽ được gọi một lần khi hình nhiều đường đượ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 hình 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 hình nhiều đường này đã thay đổi hay chưa.

    Xem TripPolylineCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng chúng.
destinationMarkerCustomization optional
Loại:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Chế độ tuỳ chỉnh đã áp dụng cho điểm đánh dấu điểm đế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ư thao tác nhấp chuột).
  • Nếu bạn chỉ định một đối tượng MarkerOptions, các 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 tùy chọn mặc định của đối tượng đó (nếu có).
  • Nếu một hàm được chỉ định, hàm này được gọi một lần khi điểm đánh dấu được tạo, trước khi nó được thêm vào chế độ xem 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 chúng.
originMarkerCustomization optional
Loại:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Chế độ tuỳ chỉnh đã áp dụng cho điểm đánh dấu điểm khởi hành.

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ư thao tác nhấp chuột).
  • Nếu bạn chỉ định một đối tượng MarkerOptions, các 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 tùy chọn mặc định của đối tượng đó (nếu có).
  • Nếu một hàm được chỉ định, hàm này được gọi một lần khi điểm đánh dấu được tạo, trước khi nó được thêm vào chế độ xem 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 chúng.
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 hơn pollingIntervalMillis để tìm nạp thông tin cập nhật vị trí, thì lần cập nhật vị trí tiếp theo sẽ không bắt đầu cho đến khi hoàn tất quá trình cập nhật hiện tại.

Việc đặt giá trị này thành 0 sẽ tắt tính năng cập nhật vị trí định kỳ. Hệ thống sẽ tìm nạp thông tin cập nhật vị trí mới nếu bất kỳ thông số nào mà trình cung cấp vị trí quan sát thấy có sự thay đổi.

Khoảng thời gian thăm dò mặc định là 5.000 mili giây (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ị nhỏ hơn 0, thì 5000 sẽ được sử dụng.
remainingPolylineCustomization optional
Loại:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional
Tùy chỉnh đã áp dụng cho hình nhiều đường còn lại. Hình 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 đi qua.

Sử dụng trường này để chỉ định kiểu tuỳ chỉnh (chẳng hạn như màu nhiều đường) và tính tương tác (chẳng hạn như xử lý lượt nhấp).
  • Nếu bạn chỉ định đối tượng PolylineOptions, các thay đổi được chỉ định trong đối tượng đó sẽ được áp dụng cho hình nhiều đường sau khi hình nhiều đường được tạo, ghi đè các tuỳ chọn mặc định của đối tượng đó (nếu có).
  • Nếu một hàm được chỉ định, hàm này sẽ được gọi một lần khi hình nhiều đường đượ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 hình 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 hình nhiều đường này đã thay đổi hay chưa.

    Xem TripPolylineCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng chúng.
takenPolylineCustomization optional
Loại:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional
Tùy chỉnh được áp dụng cho hình nhiều đường được chụp. Hình nhiều đường được sử dụng 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 tuỳ chỉnh (chẳng hạn như màu nhiều đường) và tính tương tác (chẳng hạn như xử lý lượt nhấp).
  • Nếu bạn chỉ định đối tượng PolylineOptions, các thay đổi được chỉ định trong đối tượng đó sẽ được áp dụng cho hình nhiều đường sau khi hình nhiều đường được tạo, ghi đè các tuỳ chọn mặc định của đối tượng đó (nếu có).
  • Nếu một hàm được chỉ định, hàm này sẽ được gọi một lần khi hình nhiều đường đượ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 hình 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 hình nhiều đường này đã thay đổi hay chưa.

    Xem TripPolylineCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng chúng.
tripId optional
Loại:  string optional
Mã chuyến đi cần theo dõi ngay sau khi tạo thực thể cho trình cung cấp vị trí. 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 sử 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 đã á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ư thao tác nhấp chuột).
  • Nếu bạn chỉ định một đối tượng MarkerOptions, các 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 tùy chọn mặc định của đối tượng đó (nếu có).
  • Nếu một hàm được chỉ định, hàm này được gọi một lần khi điểm đánh dấu được tạo, trước khi nó được thêm vào chế độ xem 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 chúng.
waypointMarkerCustomization optional
Tùy chỉnh đã áp dụng cho đ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ư thao tác nhấp chuột).
  • Nếu bạn chỉ định một đối tượng MarkerOptions, các 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 tùy chọn mặc định của đối tượng đó (nếu có).
  • Nếu một hàm được chỉ định, hàm này được gọi một lần khi điểm đánh dấu được tạo, trước khi nó được thêm vào chế độ xem 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 chúng.

Giao diện FleetEngineTripLocationProviderUpdateEvent

Giao diện google.maps.journeySharing.FleetEngineTripLocationProviderUpdateEvent

Đối tượng sự kiện được chuyể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 được quá trình cập nhật trả về. Không thể sửa đổi.