Fleet Tracking - On Demand Rides & Delivery (beta)

Lớp FleetEngineVehicleLocationProvider

Lớp google.maps.journeySharing.FleetEngineVehicleLocationProvider

Nhà cung cấp vị trí xe.

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

Truy cập bằng cách gọi const {FleetEngineVehicleLocationProvider} = await google.maps.importLibrary("journeySharing"). Xem Thư viện trong API JavaScript của Maps.
FleetEngineVehicleLocationProvider
FleetEngineVehicleLocationProvider(options)
Thông số: 
Tạo một nhà cung cấp vị trí mới cho xe chạy trên Fleet Engine.
staleLocationThresholdMillis
Loại:  number
Trường này là trường chỉ đọc. Ngưỡng dành cho vị trí xe cũ. Nếu vị trí mới nhất được cập nhật gần đây nhất cho xe, thì xe sẽ không xuất hiện.
vehicleId
Loại:  string
Mã nhận dạng cho xe mà nhà cung cấp vị trí này đã quan sát. Hãy thiết lập trường này để theo dõi một phương tiện.
Kế thừa: isPolling, pollingIntervalMillis
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 trên Fleet Engine hoàn tất.
Kế thừa: ispollingchange

Giao diện FleetEngineVehicleLocationProviderOptions

Giao diện google.maps.journeySharing.FleetEngineVehicleLocationProviderOptions

Các tùy chọn cho nhà cung cấp vị trí xe.
authTokenFetcher
Cung cấp Mã thông báo Web JSON để xác thực ứng dụng cho Fleet Engine.
projectId
Loại:  string
Mã dự án của người tiêu dùng từ Google Cloud Console.
destinationMarkerCustomization optional
Tùy chỉnh được áp dụng cho điểm đánh dấu điểm đến của chuyến đi bằng xe.

Sử dụng trường này để chỉ định kiểu tùy 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 đối tượng MarkerOptions được chỉ định, những thay đổi 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 tượng đó nếu có.
  • Nếu hàm được chỉ định, hàm sẽ được gọi một lần khi điểm đánh dấu được tạo, trước khi hàm đượ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 đượ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 VehicleWaypointMarkerCustomizationFunctionParams để biết danh sách các tham số đã cho và công dụng của các tham số đó.
intermediateDestinationMarkerCustomization optional
Tùy chỉnh được áp dụng cho các điểm đến trung gian của chuyến đi xe.

Sử dụng trường này để chỉ định kiểu tùy 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 đối tượng MarkerOptions được chỉ định, những thay đổi 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 tượng đó nếu có.
  • Nếu hàm được chỉ định, hàm sẽ được gọi một lần khi điểm đánh dấu được tạo, trước khi hàm đượ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 đượ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 VehicleWaypointMarkerCustomizationFunctionParams để biết danh sách các tham số đã cho và công dụng của các tham số đó.
originMarkerCustomization optional
Tùy chỉnh được áp dụng cho điểm đánh dấu điểm khởi hành chuyến đi của xe.

Sử dụng trường này để chỉ định kiểu tùy 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 đối tượng MarkerOptions được chỉ định, những thay đổi 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 tượng đó nếu có.
  • Nếu hàm được chỉ định, hàm sẽ được gọi một lần khi điểm đánh dấu được tạo, trước khi hàm đượ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 đượ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 VehicleWaypointMarkerCustomizationFunctionParams để biết danh sách các tham số đã cho và công dụng của các tham số đó.
pollingIntervalMillis optional
Loại:  number optional
Thời gian tối thiểu giữa những 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 hơn pollingIntervalMillis để tìm nạp thông tin cập nhật vị trí, thì hệ thống sẽ không bắt đầu quy trình cập nhật vị trí tiếp theo cho đến khi cập nhật vị trí 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ỳ. Một lần cập nhật vị trí mới được tìm nạp nếu bất kỳ tham số nào được nhà cung cấp vị trí quan sát thấy thay đổi.

Khoảng thời gian bỏ phiếu mặc định là 5.000 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ò là một giá trị khác 0 thì 5000 sẽ được sử dụng.
staleLocationThresholdMillis optional
Loại:  number optional
Ngưỡng dành cho vị trí xe cũ. Nếu vị trí mới nhất được cập nhật gần đây nhất cho xe này là ngưỡng này, thì xe sẽ không được hiển thị. Mặc định là 24 giờ tính bằng mili giây. Nếu ngưỡng này 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 bị coi là cũ.
vehicleId optional
Loại:  string optional
Mã nhận dạng xe để theo dõi ngay sau khi nhà cung cấp vị trí tạo bản sao. Nếu không được chỉ định, nhà cung cấp vị trí không bắt đầu theo dõi bất kỳ xe nào; hãy sử dụng FleetEngineVehicleLocationProvider.vehicleId để đặt mã nhận dạng và bắt đầu theo dõi.
vehicleMarkerCustomization optional
Loại:  (function(VehicleMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Tùy chỉnh được áp dụng cho điểm đánh dấu xe.

Sử dụng trường này để chỉ định kiểu tùy 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 đối tượng MarkerOptions được chỉ định, những thay đổi 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 tượng đó nếu có.
  • Nếu hàm được chỉ định, hàm sẽ được gọi một lần khi điểm đánh dấu được tạo, trước khi hàm đượ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 đượ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 VehicleMarkerCustomizationFunctionParams để biết danh sách các tham số đã cho và công dụng của các tham số đó.

Giao diện FleetEngineVehicleLocationProviderUpdateEvent

Giao diện google.maps.journeySharing.FleetEngineVehicleLocationProviderUpdateEvent

Đối tượng sự kiện được chuyển đến trình xử lý sự kiện khi sự kiện FleetEngineVehicleLocationProvider.update được kích hoạt.
trips optional
Loại:  Array<Trip> optional
Danh sách các chuyến đi mà xe này đã hoàn thành. Không thể sửa đổi.
vehicle optional
Loại:  Vehicle optional
Cấu trúc dữ liệu của xe được bản cập nhật trả về. Không thể sửa đổi.

FleetEngineFleetLocationProvider

Lớp google.maps.journeySharing.FleetEngineFleetLocationProvider

Nhà cung cấp vị trí nhóm xe.

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

Truy cập bằng cách gọi const {FleetEngineFleetLocationProvider} = await google.maps.importLibrary("journeySharing"). Xem Thư viện trong API JavaScript của Maps.
FleetEngineFleetLocationProvider
FleetEngineFleetLocationProvider(options)
Thông số: 
Tạo một nhà cung cấp vị trí mới cho các phương tiện được Fleet Engine theo dõi.
locationRestriction
Giới hạn để theo dõi phương tiện. Nếu không có giới hạn nào được đặt, sẽ không có phương tiện nào được theo dõi. Để theo dõi tất cả các phương tiện 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 là trường chỉ đọc. Ngưỡng dành cho vị trí xe cũ. Nếu vị trí mới nhất được cập nhật gần đây nhất cho xe, thì xe sẽ không xuất hiện.
vehicleFilter
Loại:  string optional
Bộ lọc được áp dụng khi tìm nạp phương tiệ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 trên Fleet Engine hoàn tất.
Kế thừa: ispollingchange

Giao diện FleetEngineFleetLocationProviderOptions

Giao diện google.maps.journeySharing.FleetEngineFleetLocationProviderOptions

Các tùy chọn cho nhà cung cấp vị trí nhóm.
authTokenFetcher
Cung cấp Mã thông báo Web JSON để xác thực ứng dụng cho Fleet Engine.
projectId
Loại:  string
Mã dự án của người tiêu dùng từ Google Cloud Console.
locationRestriction optional
Giới hạn vĩ độ/kinh độ trong đó để theo dõi xe ngay sau khi nhà cung cấp vị trí được tạo bản sao. Nếu bạn không đặt chính sách này, 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 FleetEngineFleetLocationProvider.locationRestriction để đặt ranh giới và bắt đầu theo dõi. Để theo dõi tất cả các phương tiện 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 dành cho vị trí xe cũ. Nếu vị trí mới nhất được cập nhật gần đây nhất cho xe, 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 bị coi là cũ.
vehicleFilter optional
Loại:  string optional
Truy vấn bộ lọc sẽ áp dụng khi tìm nạp xe. Bộ lọc này được chuyển trực tiếp đến Fleet Engine.

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

Xin lưu ý rằng bộ lọc hợp lệ cho thuộc tính phải có tiền tố "attribute". Ví dụ: attributes.x = "y" hoặc attributes."x y" = "z".
vehicleMarkerCustomization optional
Loại:  function(VehicleMarkerCustomizationFunctionParams): void optional
Tùy chỉnh được áp dụng cho một điểm đánh dấu xe.

Sử dụng trường này để chỉ định kiểu tùy 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 đối tượng MarkerOptions được chỉ định, những thay đổi 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 tượng đó nếu có.
  • Nếu hàm được chỉ định, hàm sẽ được gọi một lần khi điểm đánh dấu được tạo, trước khi hàm đượ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 đượ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 VehicleMarkerCustomizationFunctionParams để biết danh sách các tham số đã cho và công dụng của các tham số đó.

Giao diện FleetEngineFleetLocationProviderUpdateEvent

Giao diện google.maps.journeySharing.FleetEngineFleetLocationProviderUpdateEvent

Đối tượng sự kiện được chuyển đến trình xử lý sự kiện khi sự kiện FleetEngineFleetLocationProvider.update được kích hoạt.
vehicles optional
Loại:  Array<Vehicle> optional
Danh sách xe được trả lại theo truy vấn. Không thể sửa đổi.