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 Maps JavaScript API.
FleetEngineTripLocationProvider
FleetEngineTripLocationProvider(options)
Thông số: 
Tạo nhà cung cấp vị trí mới cho chuyến đi của Fleet Engine.
tripId
Loại:  string
Mã nhận dạng cho chuyến đi mà nhà cung cấp vị trí này quan sát. Hãy đặt 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 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 Fleet Engine đã 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 cho Fleet Engine.
projectId
Loại:  string
Mã dự án của người dùng trong Google Cloud Console.
destinationMarkerCustomization optional
Loại:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Đã áp dụng tùy chỉnh 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à tính tương tác (chẳng hạn như xử lý lượt nhấp).
  • Nếu đối tượng MarkerOptions được chỉ định, 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 tùy chọn mặc định của đối tượng nếu có.
  • Nếu hàm được chỉ định, thì hàm sẽ được gọi một lần khi điểm đánh dấu được tạo, trước khi hàm này đượ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ừ 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.

    Xem TripMarkerCustomizationFunctionParams để biết danh sách các tham số đã cung cấp và cách sử dụng các tham số đó.
originMarkerCustomization optional
Loại:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Đã áp dụng tùy chỉnh 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à tính tương tác (chẳng hạn như xử lý lượt nhấp).
  • Nếu đối tượng MarkerOptions được chỉ định, 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 tùy chọn mặc định của đối tượng nếu có.
  • Nếu hàm được chỉ định, thì hàm sẽ được gọi một lần khi điểm đánh dấu được tạo, trước khi hàm này đượ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ừ 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.

    Xem TripMarkerCustomizationFunctionParams để biết danh sách các tham số đã 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 hơn pollingIntervalMillis để tìm nạp thông tin cập nhật về vị trí, thì lần cập nhật vị trí tiếp theo sẽ không bắt đầu cho đến khi thông tin cập nhật 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 định kỳ của các thông tin cập nhật vị trí. Thông báo 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 quan sát được do nhà cung cấp vị trí 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ò là giá trị nhỏ hơn 0 thì 5000 sẽ được sử dụng.
tripId optional
Loại:  string optional
Mã chuyến đi để theo dõi ngay sau khi nhà cung cấp vị trí được tạo bản sao. 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
Tùy 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à tính tương tác (chẳng hạn như xử lý lượt nhấp).
  • Nếu đối tượng MarkerOptions được chỉ định, 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 tùy chọn mặc định của đối tượng nếu có.
  • Nếu hàm được chỉ định, thì hàm sẽ được gọi một lần khi điểm đánh dấu được tạo, trước khi hàm này đượ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ừ 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.

    Xem TripMarkerCustomizationFunctionParams để biết danh sách các tham số đã 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 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à tính tương tác (chẳng hạn như xử lý lượt nhấp).
  • Nếu đối tượng MarkerOptions được chỉ định, 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 tùy chọn mặc định của đối tượng nếu có.
  • Nếu hàm được chỉ định, thì hàm sẽ được gọi một lần khi điểm đánh dấu được tạo, trước khi hàm này đượ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ừ 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.

    Xem TripWaypointMarkerCustomizationFunctionParams để biết danh sách các tham số đã 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 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 trả về bởi nội dung cập nhật. Không thể sửa đổi.