Shipment Tracking

FleetEngineShipmentLocationProvider class

Lớp google.maps.journeySharing.FleetEngineShipmentLocationProvider

Nhà cung cấp vị trí giao hàng.

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

Truy cập bằng cách gọi const {FleetEngineShipmentLocationProvider} = await google.maps.importLibrary("journeySharing").
Xem Thư viện trong Maps JavaScript API.
FleetEngineShipmentLocationProvider
FleetEngineShipmentLocationProvider(options)
Tham số: 
Tạo một trì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 tác vụ mà trình cung cấp vị trí này quan sát. Đặ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

FleetEngineShipmentLocationProviderOptions interface

google.maps.journeySharing.FleetEngineShipmentLocationProviderOptionsgiao 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 trên Google Cloud Console.
activePolylineCustomization 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 ShipmentPolylineCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng các tham số đó.
deliveryVehicleMarkerCustomization optional
Loại:  (function(ShipmentMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Chế độ 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à 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 ShipmentMarkerCustomizationFunctionParams để 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(ShipmentMarkerCustomizationFunctionParams): 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 ShipmentMarkerCustomizationFunctionParams để 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 đặt giá trị này thành 0, vô cực hoặc giá trị âm, tính năng tự động cập nhật vị trí sẽ bị tắt. Thông tin cập nhật vị trí mới sẽ được tìm nạp một lần nếu tham số mã nhận dạng theo dõi (ví dụ: mã nhận dạng 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 hiển thị 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à 5000 mili giây. Nếu bạn đặt khoảng thời gian thăm dò thành một giá trị dương thấp hơn, thì 5000 sẽ được lưu trữ và sử dụng.
remainingPolylineCustomization 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 ShipmentPolylineCustomizationFunctionParams để 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
Đã á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 ShipmentPolylineCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng các tham số đó.
trackingId optional
Loại:  string optional
Mã theo dõi của tác vụ cần theo dõi ngay sau khi trình cung cấp vị trí được khởi tạo. Nếu không được chỉ định, trình cung cấp vị trí sẽ không bắt đầu theo dõi bất kỳ tác vụ nào; hãy dùng FleetEngineShipmentLocationProvider.trackingId để đặt mã nhận dạng theo dõi và bắt đầu theo dõi.

Giao diện FleetEngineShipmentLocationProviderUpdateEvent

google.maps.journeySharing.FleetEngineShipmentLocationProviderUpdateEventgiao 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 optional
Loại:  TaskTrackingInfo optional
Cấu trúc thông tin theo dõi việc cần làm do bản cập nhật trả về. Không thể sửa đổi.