Shipment Tracking

Lớp FleetEngineShipmentLocationProvider

google.maps.journeySharing.FleetEngineShipmentLocationProvider class
extends PollingLocationProvider
library "journeySharing"

Nhà cung cấp dịch vụ vị trí lô hàng.

const {FleetEngineShipmentLocationProvider} = await google.maps.importLibrary("journeySharing");
FleetEngineShipmentLocationProvider
FleetEngineShipmentLocationProvider(options)
Tham số:
Tạo một nhà cung cấp vị trí mới cho tính năng theo dõi lô hàng của Fleet Engine.
trackingId
Loại: string
Mã theo dõi cho nhiệm vụ 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.
Đượ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.
Được 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 Fleet Engine hoàn tất.
Được kế thừa: ispollingchange

Giao diện FleetEngineShipmentLocationProviderOptions

google.maps.journeySharing.FleetEngineShipmentLocationProviderOptions giao diện

Các lựa chọn cho nhà cung cấp vị trí vận chuyển.
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 trong Google Cloud Console.
activePolylineCustomization
không bắt buộc
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 của hình nhiều đường) 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 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 hình nhiều đường (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 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 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 có thay đổi hay không.

    Hãy xem ShipmentPolylineCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng.
deliveryVehicleMarkerCustomization
không bắt buộc
Loại: (function(ShipmentMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Nội dung tuỳ chỉnh được áp dụng cho điểm đánh dấu xe giao hà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à tính 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, 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 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.

    Hãy xem ShipmentMarkerCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng.
destinationMarkerCustomization
không bắt buộc
Loại: (function(ShipmentMarkerCustomizationFunctionParams): void)|MarkerOptions optional
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à tính 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, 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 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.

    Hãy xem ShipmentMarkerCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng.
pollingIntervalMillis
không bắt buộc
Loại: number optional
Thời gian tối thiểu giữa các lần tìm nạp thông báo 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 báo cập nhật vị trí, thì thông báo cập nhật vị trí tiếp theo sẽ không bắt đầu cho đến khi thông báo cập nhật hiện tại hoàn tất.

Nếu bạn đặt giá trị này thành 0, Vô cực hoặc một giá trị âm, thì tính năng tự động cập nhật vị trí sẽ bị tắt. Thông báo cập nhật vị trí mới sẽ được tìm nạp một lần nếu tham số mã theo dõi (ví dụ: mã theo dõi lô hàng của nhà cung cấp vị trí lô hàng) hoặc một lựa chọn lọc (ví dụ: ranh giới khung nhìn hoặc bộ lọc thuộc tính cho nhà cung cấp vị trí đội xe) thay đổi.

Khoảng thời gian thăm dò mặc định và tối thiểu là 5.000 mili giây. Nếu bạn đặt khoảng thời gian thăm dò ý kiến thành một giá trị dương thấp hơn, thì giá trị 5000 sẽ được lưu trữ và sử dụng.
remainingPolylineCustomization
không bắt buộc
Nội dung tuỳ chỉnh được á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 của hình nhiều đường) 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 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 hình nhiều đường (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 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 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 có thay đổi hay không.

    Hãy xem ShipmentPolylineCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng.
takenPolylineCustomization
không bắt buộc
Tuỳ chỉnh được áp dụng cho hình nhiều đường đã lấy. Hình 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 tuỳ chỉnh (chẳng hạn như màu của hình nhiều đường) 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 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 hình nhiều đường (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 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 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 có thay đổi hay không.

    Hãy xem ShipmentPolylineCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng.
trackingId
không bắt buộc
Loại: string optional
Mã theo dõi của tác vụ cần theo dõi ngay sau khi nhà cung cấp vị trí được tạo thực thể. 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ỳ nhiệm vụ nào; hãy sử dụng FleetEngineShipmentLocationProvider.trackingId để đặt mã theo dõi và bắt đầu theo dõi.

Giao diện FleetEngineShipmentLocationProviderUpdateEvent

google.maps.journeySharing.FleetEngineShipmentLocationProviderUpdateEvent giao diện

Đối tượng sự kiện được truyền đến trình xử lý sự kiện khi sự kiện FleetEngineShipmentLocationProvider.update được kích hoạt.
taskTrackingInfo
không bắt buộc
Loại: TaskTrackingInfo optional
Cấu trúc thông tin theo dõi nhiệm vụ được trả về sau khi cập nhật. Không thể sửa đổi.