Fleet Tracking - Last Mile Fleet

Lớp FleetEngineDeliveryVehicleLocationProvider

class google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProvider extends PollingLocationProvider, LocationProvider
library "journeySharing"

Nhà cung cấp dịch vụ vị trí của xe giao hàng.

const {FleetEngineDeliveryVehicleLocationProvider} = await google.maps.importLibrary("journeySharing");
FleetEngineDeliveryVehicleLocationProvider
FleetEngineDeliveryVehicleLocationProvider(options)
Tham số:
Tạo một nhà cung cấp vị trí mới cho xe giao hàng của Fleet Engine.
deliveryVehicleId
Loại: string
Mã của xe mà nhà cung cấp vị trí này quan sát. Đặt trường này để theo dõi một xe.
shouldShowOutcomeLocations
Loại: boolean optional
Bạn có thể cho phép người dùng hiển thị vị trí kết quả của nhiệm vụ.
shouldShowTasks
Loại: boolean optional
Cho phép người dùng hiển thị các việc cần làm đã tìm nạp (không bắt buộc).
staleLocationThresholdMillis
Loại: number
Trường này chỉ có thể đọc. Ngưỡng cho vị trí xe cũ. Nếu vị trí được cập nhật gần đây nhất của xe cũ hơn ngưỡng này, thì xe sẽ không xuất hiện.
taskFilterOptions
Trả về các tuỳ chọn bộ lọc cần áp dụng khi tìm nạp việc cần làm.
Được kế thừa: isPolling, pollingIntervalMillis
Đượ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)
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 FleetEngineDeliveryVehicleLocationProviderOptions

giao diện google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderOptions

Các lựa chọn cho nhà cung cấp thông tin vị trí của xe giao hàng.

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 DeliveryVehiclePolylineCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng.
deliveryVehicleId
không bắt buộc
Loại: string optional
Mã nhận dạng của xe giao hàng 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ỳ xe nào; hãy sử dụng FleetEngineDeliveryVehicleLocationProvider.deliveryVehicleId để đặt mã nhận dạng và bắt đầu theo dõi.
deliveryVehicleMarkerCustomization
không bắt buộc
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 DeliveryVehicleMarkerCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng.
plannedStopMarkerCustomization
không bắt buộc
Nội dung tuỳ chỉnh được áp dụng cho điểm đánh dấu điểm dừng theo kế hoạ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 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 PlannedStopMarkerCustomizationFunctionParams để 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, thì tính năng thông báo cập nhật vị trí định kỳ sẽ bị tắt. Thông báo cập nhật vị trí mới sẽ được tìm nạp nếu có bất kỳ tham số nào mà nhà cung cấp vị trí quan sát được thay đổi.

Khoảng thời gian thăm dò mặc định là 5.000 mili giây, đây cũng là 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ì giá trị 5000 sẽ được 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 DeliveryVehiclePolylineCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng.
shouldShowOutcomeLocations
không bắt buộc
Loại: boolean optional
Boolean để hiện hoặc ẩn vị trí kết quả cho các nhiệm vụ đã tìm nạp.
shouldShowTasks
không bắt buộc
Loại: boolean optional
Boolean để hiện hoặc ẩn việc cần làm. Nếu bạn đặt giá trị này thành false, thì điểm cuối ListTasks sẽ không được gọi để tìm nạp các việc cần làm. Chỉ những điểm dừng sắp tới của xe mới xuất hiện.
staleLocationThresholdMillis
không bắt buộc
Loại: number optional
Ngưỡng cho vị trí xe cũ. Nếu vị trí được cập nhật gần đây nhất của xe cũ hơn ngưỡng này, thì xe sẽ không xuất hiện. Mặc định là 24 giờ tính bằng mili giây. Nếu ngưỡng nhỏ hơn 0 hoặc Infinity, thì ngưỡng này sẽ bị bỏ qua và vị trí của xe sẽ không được coi là cũ.
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 DeliveryVehiclePolylineCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng.
taskFilterOptions
không bắt buộc
Các tuỳ chọn bộ lọc cần áp dụng khi tìm nạp tác vụ. Các lựa chọn có thể bao gồm xe, thời gian và trạng thái nhiệm vụ cụ thể.
taskMarkerCustomization
không bắt buộc
Loại: (function(TaskMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Nội dung tuỳ chỉnh được áp dụng cho điểm đánh dấu việc cần làm. Điểm đánh dấu nhiệm vụ được hiển thị tại vị trí dự kiến của mỗi nhiệm vụ được giao cho 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 TaskMarkerCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng.
taskOutcomeMarkerCustomization
không bắt buộc
Loại: function(TaskMarkerCustomizationFunctionParams): void optional
Nội dung tuỳ chỉnh được áp dụng cho điểm đánh dấu kết quả của nhiệm vụ. Điểm đánh dấu kết quả của nhiệm vụ được hiển thị tại vị trí kết quả thực tế của mỗi nhiệm vụ được giao cho 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 TaskMarkerCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng.

Giao diện FleetEngineTaskFilterOptions

giao diện google.maps.journeySharing.FleetEngineTaskFilterOptions

Các lựa chọn lọc cho nhiệm vụ trong Nhà cung cấp vị trí xe giao hàng.

completionTimeFrom
không bắt buộc
Loại: Date optional
Giới hạn dưới (không bao gồm) cho thời gian hoàn thành việc cần làm. Dùng để lọc những việc cần làm đã hoàn thành sau thời gian được chỉ định.
completionTimeTo
không bắt buộc
Loại: Date optional
Giới hạn trên (không bao gồm) cho thời gian hoàn thành việc cần làm. Dùng để lọc những việc cần làm đã hoàn thành trước thời gian chỉ định.
state
không bắt buộc
Loại: string optional
Trạng thái của việc cần làm. Các giá trị hợp lệ là OPEN hoặc CLOSED.

Giao diện FleetEngineDeliveryVehicleLocationProviderUpdateEvent

giao diện google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderUpdateEvent

Đối tượng sự kiện được truyền đến trình xử lý sự kiện khi sự kiện FleetEngineDeliveryVehicleLocationProvider.update được kích hoạt.

completedVehicleJourneySegments
không bắt buộc
Loại: Array<VehicleJourneySegment> optional
Các chặng hành trình mà xe này đã hoàn thành. Không thể sửa đổi.
deliveryVehicle
không bắt buộc
Loại: DeliveryVehicle optional
Cấu trúc dữ liệu của xe giao hàng được trả về sau khi cập nhật. Không thể sửa đổi.
tasks
không bắt buộc
Loại: Array<Task> optional
Danh sách các nhiệm vụ mà xe giao hàng này thực hiện. Không thể sửa đổi.

Lớp FleetEngineDeliveryFleetLocationProvider

class google.maps.journeySharing.FleetEngineDeliveryFleetLocationProvider extends PollingLocationProvider, LocationProvider
library "journeySharing"

Nhà cung cấp dịch vụ vị trí cho đội xe giao hàng.

const {FleetEngineDeliveryFleetLocationProvider} = await google.maps.importLibrary("journeySharing");
FleetEngineDeliveryFleetLocationProvider
FleetEngineDeliveryFleetLocationProvider(options)
Tham số:
Tạo một nhà cung cấp vị trí mới cho các xe được Fleet Engine theo dõi.
deliveryVehicleFilter
Loại: string optional
Bộ lọc được áp dụng khi tìm nạp xe giao hàng.
locationRestriction
Ranh giới để theo dõi xe giao hàng. Nếu bạn không đặt ranh giới, thì hệ thống sẽ không theo dõi xe giao hàng nào. Để theo dõi tất cả xe giao hàng bất kể vị trí, hãy đặt ranh giới tương đương với toàn bộ trái đất.
staleLocationThresholdMillis
Loại: number
Trường này chỉ có thể đọc. Ngưỡng cho vị trí xe cũ. Nếu vị trí được cập nhật gần đây nhất của xe cũ hơn ngưỡng này, thì xe sẽ không xuất hiện.
Được kế thừa: isPolling, pollingIntervalMillis
Được kế thừa: addListener
update
function(event)
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 FleetEngineDeliveryFleetLocationProviderOptions

giao diện google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderOptions

Các lựa chọn cho nhà cung cấp dịch vụ vị trí của đội xe giao hàng.

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.
deliveryVehicleFilter
không bắt buộc
Loại: string optional
Một truy vấn bộ lọc cần áp dụng khi tìm nạp xe giao hàng. Bộ lọc này được truyền trực tiếp đến Fleet Engine.

Hãy xem ListDeliveryVehiclesRequest.filter để biết các định dạng được hỗ trợ.

Xin lưu ý rằng các bộ lọc hợp lệ cho thuộc tính phải có tiền tố "attributes". Ví dụ: attributes.x = "y" hoặc attributes."x y" = "z".
deliveryVehicleMarkerCustomization
không bắt buộc
Loại: function(DeliveryVehicleMarkerCustomizationFunctionParams): void 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 DeliveryVehicleMarkerCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng.
locationRestriction
không bắt buộc
Ranh giới vĩ độ/kinh độ để theo dõi xe ngay sau khi nhà cung cấp vị trí được tạo thực thể. Nếu bạn không đặt, nhà cung cấp vị trí sẽ không bắt đầu theo dõi bất kỳ xe nào; hãy sử dụng FleetEngineDeliveryFleetLocationProvider.locationRestriction để đặt ranh giới và bắt đầu theo dõi. Để theo dõi tất cả xe giao hàng bất kể vị trí, hãy đặt ranh giới tương đương với toàn bộ trái đất.
staleLocationThresholdMillis
không bắt buộc
Loại: number optional
Ngưỡng cho vị trí xe cũ. Nếu vị trí được cập nhật gần đây nhất của xe cũ hơn ngưỡng này, thì xe sẽ không xuất hiện. Mặc định là 24 giờ tính bằng mili giây. Nếu ngưỡng nhỏ hơn 0 hoặc Infinity, thì ngưỡng này sẽ bị bỏ qua và vị trí của xe sẽ không được coi là cũ.

Giao diện FleetEngineDeliveryFleetLocationProviderUpdateEvent

giao diện google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderUpdateEvent

Đối tượng sự kiện được truyền đến trình xử lý sự kiện khi sự kiện FleetEngineDeliveryFleetLocationProvider.update được kích hoạt.

deliveryVehicles
không bắt buộc
Loại: Array<DeliveryVehicle> optional
Danh sách xe giao hàng mà truy vấn trả về. Không thể sửa đổi.