Fleet Tracking - Last Mile Fleet

Lớp FleetEngineDeliveryVehicleLocationProvider

Lớp google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProvider

Nhà cung cấp 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 phần Thư viện trong API Maps JavaScript.
FleetEngineDeliveryVehicleLocationProvider
FleetEngineDeliveryVehicleLocationProvider(options)
Thông số: 
Tạo một nhà cung cấp vị trí mới cho xe giao hàng của Công cụ quản lý đội xe.
deliveryVehicleId
Loại:  string
Mã nhận dạng của xe mà nhà cung cấp vị trí này quan sát được. Đặt trường này để theo dõi một xe.
shouldShowOutcomeLocations
Loại:  boolean optional
Cho phép người dùng hiển thị vị trí kết quả của tác vụ (không bắt buộc).
shouldShowTasks
Loại:  boolean optional
Cho phép người dùng hiển thị các tác vụ đã 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ậ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 để áp dụng khi tìm nạp việc cần làm.
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 của Công cụ quản lý đội xe đã hoàn tất.
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í xe giao hàng.
authTokenFetcher
Cung cấp mã thông báo web JSON để xác thực ứng dụng với Công cụ của đội xe.
projectId
Loại:  string
Mã dự án của người dùng trong Google Cloud Console.
activePolylineCustomization optional
Tuỳ chỉnh được áp dụng cho đường đa tuyến đang hoạt động. Một đường đa tuyến đ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 đường đa tuyế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ì các thay đổi được chỉ định trong đối tượng đó sẽ được áp dụng cho đa giác sau khi đa giác được tạo, ghi đè các tuỳ chọn mặc định của đa giác nếu có.
  • Nếu bạn chỉ định một hàm, hàm đó sẽ được gọi một lần khi tạo đa tuyế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 toạ độ của đường đa tuyến thay đổi hoặc khi nhà cung cấp vị trí nhận dữ liệu từ Công cụ xe, bất kể dữ liệu tương ứng với đường đa tuyến này có thay đổi hay không.

    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 tải để theo dõi ngay sau khi tạo thực thể trình cung cấp vị trí. Nếu không 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 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à 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ì 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, hàm đó sẽ được gọi một lần khi tạo điểm đánh dấu, 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ừ Công cụ của đội xe, 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 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
Nội dung tuỳ chỉnh được áp dụng cho điểm dừng đã lên 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ì 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, hàm đó sẽ được gọi một lần khi tạo điểm đánh dấu, 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ừ Công cụ của đội xe, 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 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 quá trình tìm nạp thông tin cập nhật vị trí mất nhiều thời gian hơn pollingIntervalMillis, thì quá trình cập nhật vị trí tiếp theo sẽ không bắt đầu cho đến khi quá trình 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 cập nhật vị trí định kỳ. 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ò ý kiến mặc định là 5000 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ò ý kiến thành một giá trị khác 0 thấp hơn, thì 5000 sẽ được sử dụng.
remainingPolylineCustomization optional
Tuỳ chỉnh được áp dụng cho đường đa tuyến 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 đường đa tuyế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ì các thay đổi được chỉ định trong đối tượng đó sẽ được áp dụng cho đa giác sau khi đa giác được tạo, ghi đè các tuỳ chọn mặc định của đa giác nếu có.
  • Nếu bạn chỉ định một hàm, hàm đó sẽ được gọi một lần khi tạo đa tuyế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 toạ độ của đường đa tuyến thay đổi hoặc khi nhà cung cấp vị trí nhận dữ liệu từ Công cụ xe, bất kể dữ liệu tương ứng với đường đa tuyến này có thay đổi hay không.

    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 tác vụ đã tìm nạp.
shouldShowTasks optional
Loại:  boolean optional
Boolean để hiển thị hoặc ẩn các việc cần làm. Việc đặt giá trị này thành false sẽ ngăn việc gọi điểm cuối ListTasks để tìm nạp các tác vụ. Chỉ những điểm dừng sắp tới của xe mới xuất hiện.
staleLocationThresholdMillis optional
Loại:  number optional
Ngưỡng cho vị trí xe cũ. Nếu vị trí 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ũ.
takenPolylineCustomization optional
Nội dung tuỳ chỉnh được áp dụng cho đường đa tuyến đã chụp. Hình nhiều đường đã chụp 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 đường đa tuyế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ì các thay đổi được chỉ định trong đối tượng đó sẽ được áp dụng cho đa giác sau khi đa giác được tạo, ghi đè các tuỳ chọn mặc định của đa giác nếu có.
  • Nếu bạn chỉ định một hàm, hàm đó sẽ được gọi một lần khi tạo đa tuyế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 toạ độ của đường đa tuyến thay đổi hoặc khi nhà cung cấp vị trí nhận dữ liệu từ Công cụ xe, bất kể dữ liệu tương ứng với đường đa tuyến này có thay đổi hay không.

    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 tuỳ chọn bộ lọc để áp dụng khi tìm nạp việc cần làm. Các tuỳ chọn có thể bao gồm xe, thời gian và trạng thái công việc cụ thể.
taskMarkerCustomization optional
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 công việc được hiển thị tại vị trí dự kiến của từng công việc đượ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ì 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, hàm đó sẽ được gọi một lần khi tạo điểm đánh dấu, 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ừ Công cụ của đội xe, 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 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
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ông việc được hiển thị tại vị trí kết quả thực tế của từng công việc được chỉ định 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ì 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, hàm đó sẽ được gọi một lần khi tạo điểm đánh dấu, 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ừ Công cụ của đội xe, 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 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

Giao diện google.maps.journeySharing.FleetEngineTaskFilterOptions

Các tuỳ chọn lọc cho tác vụ trong Nhà cung cấp vị trí xe giao hàng.
completionTimeFrom optional
Loại:  Date optional
Giới hạn dưới riêng biệt cho thời gian hoàn thành tác vụ. Dùng để lọc các tác vụ đã hoàn tất sau thời gian đã chỉ định.
completionTimeTo optional
Loại:  Date optional
Giới hạn trên không bao gồm thời gian hoàn thành tác vụ. Dùng để lọc các việc cần làm đã hoàn thành trước thời gian đã chỉ định.
state optional
Loại:  string optional
Trạng thái của tác vụ. Các giá trị hợp lệ là MỞ hoặc ĐÃ KHOÁ.

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 optional
Loại:  Array<VehicleJourneySegment> optional
Các phân đoạn hành trình mà 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 bản cập nhật trả về. Không thể sửa đổi.
tasks optional
Loại:  Array<Task> optional
Danh sách các công việc do xe tải 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 phần Thư viện trong API Maps JavaScript.
FleetEngineDeliveryFleetLocationProvider
FleetEngineDeliveryFleetLocationProvider(options)
Thông số: 
Tạo một nhà cung cấp vị trí mới cho các xe do Công cụ quản lý đội xe theo dõi.
deliveryVehicleFilter
Loại:  string optional
Bộ lọc được áp dụng khi tìm nạp xe phân phối.
locationRestriction
Ranh giới để theo dõi xe tải giao hàng. Nếu bạn không đặt giới hạn, thì hệ thống sẽ không theo dõi xe phân phối nào. Để theo dõi tất cả xe giao hàng bất kể vị trí, hãy đặt giới hạn 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ậ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.
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 của Công cụ quản lý đội xe đã hoàn tất.
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 thông tin 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 Công cụ của đội xe.
projectId
Loại:  string
Mã dự án của người dùng trong Google Cloud Console.
deliveryVehicleFilter optional
Loại:  string optional
Truy vấn bộ lọc để áp dụng khi tìm nạp xe phân phối. Bộ lọc này được chuyển trực tiếp đến Công cụ quản lý đội xe.

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

Lưu ý rằng bộ lọc hợp lệ cho các 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
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à 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ì 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, hàm đó sẽ được gọi một lần khi tạo điểm đánh dấu, 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ừ Công cụ của đội xe, 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 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
Giới hạn vĩ độ/kinh độ để theo dõi xe ngay sau khi tạo thực thể cho trình cung cấp vị trí. 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 giới hạn 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 giới hạn tương đương với toàn bộ trái đất.
staleLocationThresholdMillis optional
Loại:  number optional
Ngưỡng cho vị trí xe cũ. Nếu vị trí 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

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