Fleet Tracking - Last Mile Fleet

Lớp FleetEngineDeliveryVehicleLocationProvider

Lớp google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProvider

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

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

Truy cập bằng cách gọi const {FleetEngineDeliveryVehicleLocationProvider} = await google.maps.importLibrary("journeySharing").
Xem Thư viện trong Maps JavaScript API.
FleetEngineDeliveryVehicleLocationProvider
FleetEngineDeliveryVehicleLocationProvider(options)
Tham số: 
Tạo một trình cung cấp vị trí mới cho xe giao hàng của Fleet Engine.
deliveryVehicleId
Loại:  string
Mã nhận dạng của xe mà trình cung cấp vị trí này theo dõi. Đặt trường này để theo dõi một chiếc 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ế độ chỉ đọc. Ngưỡng cho thông tin vị trí của xe không còn mới. 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 lựa chọn bộ lọc để áp dụng khi tìm nạp việc cần làm.
Được kế thừa: isPolling, pollingIntervalMillis
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

Giao diện FleetEngineDeliveryVehicleLocationProviderOptions

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderOptionsgiao diện

Các lựa chọn cho nhà cung cấp vị trí 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 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 DeliveryVehiclePolylineCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng các tham số đó.
deliveryVehicleId optional
Loại:  string optional
Mã nhận dạng xe giao hàng để theo dõi ngay sau khi trình cung cấp vị trí được khởi tạo. Nếu bạn không chỉ định, trình cung cấp vị trí sẽ không bắt đầu theo dõi bất kỳ phương tiện nào; hãy dùng FleetEngineDeliveryVehicleLocationProvider.deliveryVehicleId để đặt mã nhận dạng và bắt đầu theo dõi.
deliveryVehicleMarkerCustomization 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 DeliveryVehicleMarkerCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng các tham số đó.
plannedStopMarkerCustomization optional
Loại:  (function(PlannedStopMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Tuỳ chỉnh được áp dụng cho một đ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à 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 PlannedStopMarkerCustomizationFunctionParams để 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 bạn đặt giá trị này thành 0, các bản cập nhật vị trí định kỳ sẽ bị tắt. 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ò mặc định là 5000 mili giây, đây là khoảng thời gian tối thiểu. Nếu bạn đặt khoảng thời gian thăm dò thành một giá trị khác 0 thấp hơn, thì 5000 sẽ được 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 DeliveryVehiclePolylineCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng các tham số đó.
shouldShowOutcomeLocations optional
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 optional
Loại:  boolean optional
Boolean để hiện hoặc ẩn các việc cần làm. Nếu bạn đặt giá trị này thành false, đ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 xe sắp tới mới xuất hiện.
staleLocationThresholdMillis optional
Loại:  number optional
Ngưỡng cho thông tin vị trí của xe không còn mới. 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 Vô cực, thì ngưỡng sẽ bị bỏ qua và vị trí của xe sẽ không được coi là cũ.
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 DeliveryVehiclePolylineCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng các tham số đó.
taskFilterOptions optional
Loại:  FleetEngineTaskFilterOptions optional
Các lựa chọn bộ lọc để áp dụng khi tìm nạp việc cần làm. Các lựa chọn có thể bao gồm thông tin cụ thể về xe, thời gian và trạng thái của việc cần làm.
taskMarkerCustomization optional
Loại:  (function(TaskMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Chế độ tuỳ chỉnh được áp dụng cho một điểm đánh dấu nhiệm vụ. Đ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à 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 TaskMarkerCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng các tham số đó.
taskOutcomeMarkerCustomization optional
Loại:  function(TaskMarkerCustomizationFunctionParams): void optional
Chế độ 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à 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 TaskMarkerCustomizationFunctionParams để 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 FleetEngineTaskFilterOptions

google.maps.journeySharing.FleetEngineTaskFilterOptionsgiao diện

Các lựa chọn lọc cho những việc cần làm trong Delivery Vehicle Location Provider.
completionTimeFrom optional
Loại:  Date optional
Cận dưới (không bao gồm) cho thời gian hoàn thành của việc cần làm. Dùng để lọc những tác vụ đã hoàn tất sau thời gian được chỉ định.
completionTimeTo optional
Loại:  Date optional
Cậ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 được chỉ định.
state optional
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

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderUpdateEventgiao diện

Đố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 optional
Loại:  Array<VehicleJourneySegment> optional
Các đoạn đường đã được xe này hoàn thành. Không thể sửa đổi.
deliveryVehicle optional
Loại:  DeliveryVehicle optional
Cấu trúc dữ liệu xe giao hàng do lệnh cập nhật trả về. Không thể sửa đổi.
tasks optional
Loại:  Array<Task> optional
Danh sách các việc cần làm mà xe giao hàng này thực hiện. Không thể sửa đổi.

Lớp FleetEngineDeliveryFleetLocationProvider

Lớp google.maps.journeySharing.FleetEngineDeliveryFleetLocationProvider

Nhà cung cấp vị trí của đội xe giao hàng.

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

Truy cập bằng cách gọi const {FleetEngineDeliveryFleetLocationProvider} = await google.maps.importLibrary("journeySharing").
Xem Thư viện trong Maps JavaScript API.
FleetEngineDeliveryFleetLocationProvider
FleetEngineDeliveryFleetLocationProvider(options)
Tham số: 
Tạo một trì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 các xe giao hàng. Nếu bạn không đặt ranh giới, thì sẽ không có xe giao hàng nào được 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
Loại:  number
Trường này ở chế độ chỉ đọc. Ngưỡng cho thông tin vị trí của xe không còn mới. 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
Kế thừa: addListener
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

Giao diện FleetEngineDeliveryFleetLocationProviderOptions

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderOptionsgiao diện

Các lựa chọn cho nhà cung cấp 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 trên Google Cloud Console.
deliveryVehicleFilter optional
Loại:  string optional
Một truy vấn bộ lọc để áp dụng khi tìm nạp xe giao hàng. Bộ lọc này được chuyể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 optional
Loại:  function(DeliveryVehicleMarkerCustomizationFunctionParams): void optional
Chế độ tuỳ chỉnh được áp dụng cho một đ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 DeliveryVehicleMarkerCustomizationFunctionParams để biết danh sách các tham số được cung cấp và cách sử dụng các tham số đó.
locationRestriction optional
Ranh giới vĩ độ/kinh độ để theo dõi các phương tiện ngay sau khi trình cung cấp vị trí được khởi tạo. Nếu bạn không đặt, trình cung cấp vị trí sẽ không bắt đầu theo dõi bất kỳ phương tiện 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 optional
Loại:  number optional
Ngưỡng cho thông tin vị trí của xe không còn mới. 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 sẽ bị bỏ qua và vị trí của xe sẽ không được coi là cũ.

Giao diện FleetEngineDeliveryFleetLocationProviderUpdateEvent

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderUpdateEventgiao diện

Đố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 optional
Loại:  Array<DeliveryVehicle> optional
Danh sách xe giao hàng do truy vấn trả về. Không thể sửa đổi.