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 phần Thư viện trong API Maps JavaScript.
FleetEngineTripLocationProvider
FleetEngineTripLocationProvider(options)
Thông số: 
Tạo một nhà cung cấp vị trí mới cho chuyến đi bằng Công cụ quản lý đội xe.
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params)
Thông số: 
Giá trị trả về:  Không có
Hàm tuỳ chỉnh đa tuyến tô màu cho đa tuyến đang hoạt động theo tốc độ đọc. Chỉ định hàm này làm FleetEngineTripLocationProviderOptions.activePolylineCustomization để hiển thị một đường đa giác nhận biết được lưu lượng truy cập cho đường đa giác đang hoạt động.
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params)
Thông số: 
Giá trị trả về:  Không có
Hàm tuỳ chỉnh đường đa tuyến tô màu cho đường đa tuyến còn lại theo tốc độ đọc. Chỉ định hàm này làm FleetEngineTripLocationProviderOptions.remainingPolylineCustomization để hiển thị một đường đa tuyến có nhận biết được lưu lượng truy cập cho đường đa tuyến còn lại.
tripId
Loại:  string
Mã của chuyến đi mà nhà cung cấp vị trí này quan sát được. Thiết lập trường này để bắt đầu theo dõi.
Kế thừa: isPolling, pollingIntervalMillis
refresh
refresh()
Thông 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 của Công cụ quản lý đội xe đã hoàn tất.
Kế thừa: ispollingchange

Giao diện FleetEngineTripLocationProviderOptions

Giao diện google.maps.journeySharing.FleetEngineTripLocationProviderOptions

Các lựa chọn cho 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 Công cụ của đội xe.
projectId
Loại:  string
Mã dự án của người dùng trong Google Cloud Console.
activePolylineCustomization optional
Loại:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional
Tuỳ chỉnh được áp dụng cho đường đa tuyến đang hoạt động. Một đường đa tuyến đ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 đường đa tuyế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ì các thay đổi được chỉ định trong đối tượng đó sẽ được áp dụng cho đa giác sau khi đa giác được tạo, ghi đè các tuỳ chọn mặc định của đa giác nếu có.
  • Nếu bạn chỉ định một hàm, hàm đó sẽ được gọi một lần khi tạo đa tuyế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 toạ độ của đường đa tuyến thay đổi hoặc khi nhà cung cấp vị trí nhận dữ liệu từ Công cụ xe, bất kể dữ liệu tương ứng với đường đa tuyến này có thay đổi hay không.

    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
Nội dung tuỳ chỉnh được áp dụng cho điểm đánh dấu đích.

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ì 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 tuỳ 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, hàm đó sẽ được gọi một lần khi tạo điểm đánh dấu, trước khi đượ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 nhà cung cấp vị trí nhận dữ liệu từ Công cụ của đội xe, bất kể dữ liệu tương ứng với điểm đánh dấu này có thay đổi hay không.

    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
Nội dung tuỳ chỉnh được áp dụng cho điểm đánh dấu nguồn 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ì 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 tuỳ 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, hàm đó sẽ được gọi một lần khi tạo điểm đánh dấu, trước khi đượ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 nhà cung cấp vị trí nhận dữ liệu từ Công cụ của đội xe, bất kể dữ liệu tương ứng với điểm đánh dấu này có thay đổi hay không.

    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 quá trình tìm nạp thông tin cập nhật vị trí mất nhiều thời gian hơn pollingIntervalMillis, thì quá trình cập nhật vị trí tiếp theo sẽ không bắt đầu cho đến khi quá trình hiện tại kết thúc.

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ỳ. 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ò ý kiến mặc định là 5000 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ò ý kiến thành một giá trị khác 0 thấp hơn, thì 5000 sẽ được sử dụng.
remainingPolylineCustomization optional
Loại:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional
Tuỳ chỉnh được áp dụng cho đường đa tuyến 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 đường đa tuyế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ì các thay đổi được chỉ định trong đối tượng đó sẽ được áp dụng cho đa giác sau khi đa giác được tạo, ghi đè các tuỳ chọn mặc định của đa giác nếu có.
  • Nếu bạn chỉ định một hàm, hàm đó sẽ được gọi một lần khi tạo đa tuyế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 toạ độ của đường đa tuyến thay đổi hoặc khi nhà cung cấp vị trí nhận dữ liệu từ Công cụ xe, bất kể dữ liệu tương ứng với đường đa tuyến này có thay đổi hay không.

    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
Nội dung tuỳ chỉnh được áp dụng cho đường đa tuyến đã chụp. Hình nhiều đường đã chụp 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 đường đa tuyế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ì các thay đổi được chỉ định trong đối tượng đó sẽ được áp dụng cho đa giác sau khi đa giác được tạo, ghi đè các tuỳ chọn mặc định của đa giác nếu có.
  • Nếu bạn chỉ định một hàm, hàm đó sẽ được gọi một lần khi tạo đa tuyế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 toạ độ của đường đa tuyến thay đổi hoặc khi nhà cung cấp vị trí nhận dữ liệu từ Công cụ xe, bất kể dữ liệu tương ứng với đường đa tuyến này có thay đổi hay không.

    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 để theo dõi ngay sau khi tạo thực thể trình cung cấp vị trí. Nếu không được chỉ định, 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
Áp dụng tuỳ chỉnh 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ì 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 tuỳ 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, hàm đó sẽ được gọi một lần khi tạo điểm đánh dấu, trước khi đượ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 nhà cung cấp vị trí nhận dữ liệu từ Công cụ của đội xe, bất kể dữ liệu tương ứng với điểm đánh dấu này có thay đổi hay không.

    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 điểm đánh dấu mốc đường.

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ì 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 tuỳ 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, hàm đó sẽ được gọi một lần khi tạo điểm đánh dấu, trước khi đượ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 nhà cung cấp vị trí nhận dữ liệu từ Công cụ của đội xe, bất kể dữ liệu tương ứng với điểm đánh dấu này có thay đổi hay không.

    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

Giao diện google.maps.journeySharing.FleetEngineTripLocationProviderUpdateEvent

Đố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 được trả về trong bản cập nhật. Không thể sửa đổi.