Tài liệu tham khảo hạng GMTSTrip

Tài liệu tham khảo về hạng GMTSTrip

Tổng quan

Đối tượng chứa thông tin hậu cần về một chuyến đi, chẳng hạn như "vehicleId", loại chuyến đi, thời gian đón khách hoặc trả khách cũng như tuyến đường.

Kế thừa GMTCImmutableData.

Hàm thành viên công khai

(có thể nhận giá trị rỗng
GMTCFleetEngineIDString *)
tripID
 Trả về TripID cho chuyến đi hiện tại, được chuyển đổi từ TripName.
(có thể có giá trị rỗng GMTSTripWaypoint *)- nextTripWaypoint
 Trả về điểm tham chiếu đầu tiên trong danh sách điểm tham chiếu còn lại.
(có thể có giá trị rỗng GMTSTripWaypoint *)nextWaypoint
 Trả về điểm tham chiếu tiếp theo cần được truy cập.
(nullable NSArray< GMTSLatLng * > *) activeRoute
 Trả về tuyến đường đang hoạt động của chuyến đi cụ thể.
(nullable NSArray< GMTSLatLng * > *) - remainingRoute
 Trả về tuyến đường còn lại của chuyến đi cho trước.
(GMTSTrafficData có giá trị rỗng *)activeRouteTraffic
 Trả về dữ liệu giao thông cho tuyến đường đang hoạt động của chuyến đi này.
(GMTSTrafficData có giá trị rỗng *)- remainingRouteTraffic
 Trả về dữ liệu giao thông cho tuyến đường còn lại của chuyến đi này.
(int32_t)- remainingDistanceOfActiveRouteInMeters
 Trả về quãng đường còn lại của tuyến đường đang hoạt động.
(int32_t)distanceOfRemainingRouteInMeters
 Trả về quãng đường của tuyến đường còn lại.
(instancetype)- initWithTripName:vehicleID:tripType:tripStatus:pickupLocation:pickupTime:dropoffLocation:dropoffTime:lastVehicleLocation:numberOfPassengers:remainingWaypoints:intermediateDestinations:intermediateDestinationIndex:
 Tạo thực thể của lớp này.

Hàm thành viên công khai tĩnh

(GMTSTripPropertyFields)+ thuộc tínhGiá trịSự khác biệtgiữaTrip1:vàChuyến2:
 Tính mức chênh lệch giữa hai chuyến đi cho trước.

Thuộc tính

NSString * tripName
 Tên của chuyến đi.
GMTCFleetEngineIDStringvehicleID
 Mã của xe phục vụ chuyến đi.
GMTSTripTypetripType
 Loại chuyến đi hiện tại, hãy xem GMTSTripType để biết tất cả các lựa chọn.
GMTSTripStatustripStatus
 Trạng thái chuyến đi hiện tại, GMTSTripStatus được liệt kê cho tất cả trạng thái có thể có.
GMTSTerminalLocationpickupLocation
 Vị trí đón của chuyến đi.
Khoảng thời gian NSTimepickupTime
 Thời gian dự kiến tới địa điểm đón khách.
GMTSTerminalLocationdropoffLocation
 Vị trí trả khách của chuyến đi.
Khoảng thời gian NSTimedropoffTime
 Thời gian dự kiến đến tại địa điểm trả khách.
GMTSVehicleLocationlastVehicleLocation
 Thông tin về vị trí cuối cùng của xe trong chuyến đi.
NSUIntegernumberOfPassengers
 Số lượng hành khách được phép cho chuyến đi hiện tại.
NSArray< GMTSTripWaypoint * > * remainingWaypoints
 Mảng các điểm tham chiếu trên tuyến đường chuyến đi.
NSArray< GMTSTerminalLocation * > * intermediateDestinations
 Mảng gồm các điểm tham chiếu còn lại của người tiêu dùng.
int32_tintermediateDestinationIndex
 Chỉ số của điểm trung gian mà xe sẽ đến tiếp theo.

Tài liệu về hàm thành phần

– (có thể nhận giá trị rỗng GMTCFleetEngineIDString *) tripID

Trả về TripID cho chuyến đi hiện tại, được chuyển đổi từ TripName.

– (có thể có giá trị rỗng GMTSTripWaypoint *) nextTripWaypoint

Trả về điểm tham chiếu đầu tiên trong danh sách điểm tham chiếu còn lại.

– (có thể nhận giá trị rỗng có thể là GMTSTripWaypoint *) nextWaypoint

Trả về điểm tham chiếu tiếp theo cần được truy cập.

Điểm tham chiếu tiếp theo có thể không thuộc về chuyến đi này nếu chuyến đi này được nối chuỗi hoặc chia sẻ.

- (nullable NSArray<GMTSLatLng *> *) activeRoute

Trả về tuyến đường đang hoạt động của chuyến đi cụ thể.

Tuyến đường này tính từ vị trí hiện tại của xe đến điểm đến tiếp theo của người dùng hiện tại. Không giống như điểm tham chiếu tiếp theo trong chuyến đi ngược lại hoặc đi chung xe, điểm tham chiếu tiếp theo có thể không liên quan đến người dùng hiện tại. Giá trị trả về được tạo trong lần truy cập đầu tiên, sau đó được lưu vào bộ nhớ đệm.

- (nullable NSArray<GMTSLatLng *> *) remainingRoute

Trả về tuyến đường còn lại của chuyến đi cho trước.

Tuyến đường còn lại là đoạn tuyến đường từ điểm đến tiếp theo của người dùng hiện tại đến điểm đến cuối cùng của người dùng.

– (GMTSTrafficData có giá trị rỗng *) activeRouteTraffic

Trả về dữ liệu giao thông cho tuyến đường đang hoạt động của chuyến đi này.

Tuyến đường này tính từ vị trí hiện tại của xe đến điểm đến tiếp theo của người dùng hiện tại. Không giống như điểm tham chiếu tiếp theo trong chuyến đi ngược lại hoặc đi chung xe, điểm tham chiếu tiếp theo có thể không liên quan đến người dùng hiện tại. Giá trị trả về được tạo trong lần truy cập đầu tiên, sau đó được lưu vào bộ nhớ đệm.

– (GMTSTrafficData có giá trị rỗng *) remainingRouteTraffic

Trả về dữ liệu giao thông cho tuyến đường còn lại của chuyến đi này.

Tuyến đường còn lại là đoạn tuyến đường từ điểm đến tiếp theo của người dùng hiện tại đến điểm đến cuối cùng của người dùng.

Trả về quãng đường còn lại của tuyến đường đang hoạt động.

Tuyến đường đang hoạt động là đoạn tuyến đường từ vị trí của xe đến điểm đến tiếp theo của người dùng hiện tại.

Trả về quãng đường của tuyến đường còn lại.

Tuyến đường còn lại nghĩa là đoạn tuyến đường từ điểm đến tiếp theo của người dùng hiện tại đến điểm đến cuối cùng của họ.

+ (GMTSTripPropertyFields) thuộc tính Giá trị khác biệt giữaTrip1: (GMTSTrip *) trip1
và Chuyến đi 2: (GMTSTrip *) trip2

Tính mức chênh lệch giữa hai chuyến đi cho trước.

Từng chênh lệch về cơ sở lưu trú sẽ được tích luỹ vào kết quả trả về.

Các tham số:
trip1Ứng cử viên cho chuyến đi đầu tiên.
trip2Ứng cử viên cho chuyến đi thứ hai.
- (instancetype) initWithTripName: (nullable NSString *)  tripName
mã xe: (có thể nhận giá trị rỗng GMTCFleetEngineIDString *) vehicleID
loại chuyến đi: (GMTSTripType) tripType
Trạng thái chuyến đi: (GMTSTripStatus) tripStatus
vị trí nhận hàng: (GMTSTerminalLocation rỗng *) pickupLocation
thời gian đến lấy hàng: (NSTimeInterval) pickupTime
địa điểm trả khách: (GMTSTerminalLocation rỗng *) dropoffLocation
thời gian bỏ ngang: (NSTimeInterval) dropoffTime
Loại xe cuối cùngVị trí: (có thể có giá trị rỗng GMTSVehicleLocation *) lastVehicleLocation
số lượng hành khách: (NSUInteger) numberOfPassengers
Điểm còn lại: (nullable NSArray< GMTSTripWaypoint * > *)  remainingWaypoints
mediumDestinations: (nullable NSArray< GMTSTerminalLocation * > *)  intermediateDestinations
mediumDestinationIndex: (int32_t) intermediateDestinationIndex

Tạo thực thể của lớp này.

Các tham số:
tripNameTên của chuyến đi.
vehicleIDMã của xe phục vụ chuyến đi.
tripTypeLoại chuyến đi, hãy xem enum GMTSTripType để biết tất cả các tùy chọn.
tripStatusTrạng thái chuyến đi, hãy xem enum GMTSTripStatus để biết tất cả trạng thái có thể có.
pickupLocationVị trí đến lấy hàng mục tiêu.
pickupTimeThời gian dự kiến để đến vị trí đón khách.
dropoffLocationVị trí trả khách mục tiêu.
dropoffTimeThời gian dự kiến để đến địa điểm trả khách.
lastVehicleLocationThông tin về vị trí của xe gần đây nhất.
numberOfPassengersSố lượng hành khách được phép trong chuyến đi.
remainingWaypointsMảng các điểm tham chiếu còn lại trong chuyến đi.
intermediateDestinationsMảng gồm các điểm tham chiếu còn lại của người tiêu dùng.
intermediateDestinationIndexChỉ số của điểm trung gian mà xe sẽ đến tiếp theo.

Tài liệu về tài sản

– (NSString*) tripName [read, assign]

Tên của chuyến đi.

– (GMTCFleetEngineIDString*) vehicleID [read, assign]

Mã của xe phục vụ chuyến đi.

– (GMTSTripType) tripType [read, assign]

Loại chuyến đi hiện tại, hãy xem GMTSTripType để biết tất cả các lựa chọn.

– (GMTSTripStatus) tripStatus [read, assign]

Trạng thái chuyến đi hiện tại, GMTSTripStatus được liệt kê cho tất cả trạng thái có thể có.

– (GMTSTerminalLocation*) pickupLocation [read, assign]

Vị trí đón của chuyến đi.

- (NSTimeInterval) pickupTime [read, assign]

Thời gian dự kiến tới địa điểm đón khách.

– (GMTSTerminalLocation*) dropoffLocation [read, assign]

Vị trí trả khách của chuyến đi.

– (NSTimeInterval) dropoffTime [read, assign]

Thời gian dự kiến đến tại địa điểm trả khách.

Thông tin về vị trí cuối cùng của xe trong chuyến đi.

– (NSUInteger) numberOfPassengers [read, assign]

Số lượng hành khách được phép cho chuyến đi hiện tại.

– (NSArray<GMTSTripWaypoint *>*) remainingWaypoints [read, assign]

Mảng các điểm tham chiếu trên tuyến đường chuyến đi.

– (NSArray<GMTSTerminalLocation *>*) intermediateDestinations [read, assign]

Mảng gồm các điểm tham chiếu còn lại của người tiêu dùng.

– (int32_t) intermediateDestinationIndex [read, assign]

Chỉ số của điểm trung gian mà xe sẽ đến tiếp theo.

Nếu không có điểm tham chiếu trung gian, trường này sẽ được bỏ qua.