Tài liệu tham khảo về giao thức <GMTCTripModelsubscription>
Tổng quan
Giao thức dành cho người đăng ký để cập nhật sự kiện của GMTCTripModel.
Hàm thành viên công khai | |
| (void) | – tripModel:didUpdateModelState: |
| Được gọi khi trạng thái phiên chuyến đi đã được cập nhật. | |
| (void) | – tripModel:didUpdateTrip:updatedPropertyFields: |
| Được gọi khi chuyến đi hiện tại được cập nhật. | |
| (void) | – tripModel:didUpdateTripStatus: |
| Được gọi khi trạng thái chuyến đi hiện tại đã được cập nhật. | |
| (void) | – tripModel:didUpdatevehicleLocation: |
| Được gọi khi vị trí của xe đã được cập nhật. | |
| (void) | – tripModel:didUpdatePickupLocation: |
| Được gọi khi vị trí đến lấy hàng đã được cập nhật. | |
| (void) | – tripModel:didUpdateDropoffLocation: |
| Được gọi khi vị trí trả xe đã được cập nhật. | |
| (void) | – tripModel:didUpdateETAToNextWaypoint: |
| Được gọi khi cập nhật thời gian ETA đến điểm tham chiếu tiếp theo. | |
| (void) | – tripModel:didUpdatePickupETA: |
| Được gọi khi thời gian đến dự kiến của người lái xe đến điểm đón khách được cập nhật. | |
| (void) | – tripModel:didUpdateDropoffETA: |
| Được gọi khi cập nhật thời gian đến dự kiến của người lái xe đến điểm trả xe. | |
| (void) | – tripModel:didUpdateActiveRouteRemainingDistance: |
| Được gọi khi quãng đường còn lại của tuyến đường đang hoạt động của chuyến đi đã được cập nhật. | |
| (void) | – tripModel:didUpdateActiveRoute: |
| Được gọi khi đoạn tuyến đường đang hoạt động của chuyến đi được cập nhật. | |
| (void) | – tripModel:didUpdateRemainingRoute: |
| Được gọi khi đoạn tuyến đường còn lại của chuyến đi đã được cập nhật. | |
| (void) | – tripModel:didUpdateRemainingRouteDistance: |
| Được gọi khi quãng đường còn lại của chuyến đi đã được cập nhật. | |
| (void) | – tripModel:didUpdateRemainingWaypoints: |
| Được gọi khi điểm tham chiếu trung gian của chuyến đi đã được cập nhật. | |
| (void) | – tripModel:didUpdateMiddleDestinations: |
| Được gọi khi điểm tham chiếu của chuyến đi đã được cập nhật. | |
| (void) | – tripModel:didUpdateActiveRouteTraffic: |
| Được gọi khi dữ liệu giao thông đã được cập nhật cho đoạn tuyến đường đang hoạt động của chuyến đi. | |
| (void) | – tripModel:didUpdateRemainingRouteTraffic: |
| Được gọi khi dữ liệu giao thông đã được cập nhật cho đoạn tuyến đường còn lại của chuyến đi. | |
| (void) | – tripModel:didFailUpdateTripWithError: |
| Được gọi khi lỗi yêu cầu giám sát chuyến đi được cập nhật. | |
Tài liệu về hàm thành phần
| - (vô hiệu) TripModel: | (GMTCTripModel *) | tripModel | |
| wasUpdateModelState: | (enum GMTCTripModelState) | sessionState | |
[optional] |
Được gọi khi trạng thái phiên chuyến đi đã được cập nhật.
- Các tham số:
-
tripModel Thực thể của GMTCTripModel đã tạo ra sự kiện. sessionState Trạng thái phiên mới.
| - (vô hiệu) TripModel: | (GMTCTripModel *) | tripModel | |
| wasUpdateTrip: | (không có giá trị GMTSTrip *) | chuyến đi | |
| Các trường thuộc tính được cập nhật: | (GMTSTripPropertyFields) | updatedPropertyFields | |
[optional] |
Được gọi khi chuyến đi hiện tại được cập nhật.
- Các tham số:
-
tripModel Thực thể của GMTCTripModel đã tạo ra sự kiện. chuyến đi Chuyến đi đã thay đổi. updatedPropertyFields Các cơ sở lưu trú đã cập nhật.
| - (vô hiệu) TripModel: | (GMTCTripModel *) | tripModel | |
| wasUpdateTripStatus: | (GMTSTripStatus) | tripStatus | |
[optional] |
Được gọi khi trạng thái chuyến đi hiện tại đã được cập nhật.
- Các tham số:
-
tripModel Thực thể của GMTCTripModel đã tạo ra sự kiện. tripStatus Trạng thái mới cập nhật của chuyến đi.
| - (vô hiệu) TripModel: | (GMTCTripModel *) | tripModel | |
| đã cập nhật phương tiệnLocation: | (có thể truy cập vào GMTSVehicleLocation không chứa thông tin) *) | vehicleLocation | |
[optional] |
Được gọi khi vị trí của xe đã được cập nhật.
Vị trí mới không được khác với vị trí trước đó.
- Các tham số:
-
tripModel Thực thể của GMTCTripModel đã tạo ra sự kiện. vehicleLocation Vị trí chiếc xe đã biết gần đây nhất của chuyến đi hiện tại.
| - (vô hiệu) TripModel: | (GMTCTripModel *) | tripModel | |
| wasUpdatePickupLocation: | (GMTSTerminalLocation rỗng *) | pickupLocation | |
[optional] |
Được gọi khi vị trí đến lấy hàng đã được cập nhật.
- Các tham số:
-
tripModel Thực thể của GMTCTripModel đã tạo ra sự kiện. pickupLocation Vị trí lấy hàng hiện tại. Giá trị này có thể không có giá trị nếu chuyến đi được đặt lại hoặc bị huỷ.
| - (vô hiệu) TripModel: | (GMTCTripModel *) | tripModel | |
| wasUpdateDropoffLocation: | (GMTSTerminalLocation rỗng *) | dropoffLocation | |
[optional] |
Được gọi khi vị trí trả xe đã được cập nhật.
- Các tham số:
-
tripModel Thực thể của GMTCTripModel đã tạo ra sự kiện. dropoffLocation Vị trí trả xe hiện tại. Giá trị này có thể không có giá trị nếu chuyến đi được đặt lại hoặc bị huỷ.
| - (vô hiệu) TripModel: | (GMTCTripModel *) | tripModel | |
| DidUpdateETAToNextWaypoint: | (Khoảng thời gian NSTime) | nextWaypointETA | |
[optional] |
Được gọi khi cập nhật thời gian ETA đến điểm tham chiếu tiếp theo.
- Các tham số:
-
tripModel Thực thể của GMTCTripModel đã tạo ra sự kiện. nextWaypointETA Thời gian đến dự kiến hiện tại của tài xế đến điểm đón. Giá trị này có thể là 0 nếu chuyến đi được đặt lại hoặc bị huỷ.
| - (vô hiệu) TripModel: | (GMTCTripModel *) | tripModel | |
| wasUpdatePickupETA: | (Khoảng thời gian NSTime) | pickupETA | |
[optional] |
Được gọi khi thời gian đến dự kiến của người lái xe đến điểm đón khách được cập nhật.
- Các tham số:
-
tripModel Thực thể của GMTCTripModel đã tạo ra sự kiện. pickupETA Thời gian đến dự kiến hiện tại của tài xế đến điểm đón. Giá trị này có thể là 0 nếu chuyến đi được đặt lại hoặc bị huỷ.
| - (vô hiệu) TripModel: | (GMTCTripModel *) | tripModel | |
| wasUpdateDropoffETA: | (Khoảng thời gian NSTime) | dropoffETA | |
[optional] |
Được gọi khi cập nhật thời gian đến dự kiến của người lái xe đến điểm trả xe.
- Các tham số:
-
tripModel Thực thể của GMTCTripModel đã tạo ra sự kiện. dropoffETA Thời gian đến dự kiến hiện tại của người lái xe đến điểm trả xe. Giá trị này có thể là 0 nếu chuyến đi được đặt lại hoặc bị huỷ.
| - (vô hiệu) TripModel: | (GMTCTripModel *) | tripModel | |
| wasUpdateActiveRouteRemainingDistance: | (int32_t) | activeRouteRemainingDistance | |
[optional] |
Được gọi khi quãng đường còn lại của tuyến đường đang hoạt động của chuyến đi đã được cập nhật.
- Các tham số:
-
tripModel Thực thể của GMTCTripModel đã tạo ra sự kiện. activeRouteRemainingDistance Khoảng cách tính bằng mét còn lại trên tuyến đường đang hoạt động giữa vị trí hiện tại của xe và vị trí quan trọng tiếp theo. Vị trí quan trọng tiếp theo tuỳ thuộc vào trạng thái của chuyến đi hiện tại. Nếu trạng thái của chuyến đi là `GMTSTripStatusEnrouteToPickup`, thì đây là khoảng cách tới vị trí đón khách. Nếu trạng thái của chuyến đi là `GMTSTripStatusEnrouteToDropoff`, thì đây là khoảng cách đến địa điểm trả xe. Ứng dụng của bạn phải cung cấp mọi lượt chuyển đổi đo lường cần thiết.
| - (vô hiệu) TripModel: | (GMTCTripModel *) | tripModel | |
| wasUpdateActiveRoute: | (nullable NSArray< GMTSLatLng * > *) | activeRoute | |
[optional] |
Được gọi khi đoạn tuyến đường đang hoạt động của chuyến đi được cập nhật.
- Các tham số:
-
tripModel Thực thể của GMTCTripModel đã tạo ra sự kiện. activeRoute Đoạn tuyến đường đang hoạt động của chuyến đi hiện tại. Đoạn này bao gồm tuyến đường từ vị trí hiện tại của xe đến vị trí quan trọng tiếp theo. Nếu trạng thái của chuyến đi là "GMTSTripStatusEnrouteToPickup", thì vị trí quan trọng tiếp theo là vị trí đón khách. Nếu trạng thái của chuyến đi là "GMTSTripStatusEnrouteToDropoff", thì vị trí quan trọng tiếp theo là vị trí trả xe.
| - (vô hiệu) TripModel: | (GMTCTripModel *) | tripModel | |
| wasUpdateRemainingRoute: | (nullable NSArray< GMTSLatLng * > *) | remainingRoute | |
[optional] |
Được gọi khi đoạn tuyến đường còn lại của chuyến đi đã được cập nhật.
- Các tham số:
-
tripModel Thực thể của GMTCTripModel đã tạo ra sự kiện. remainingRoute Đoạn tuyến đường còn lại của chuyến đi hiện tại. Phân đoạn này bao gồm tuyến đường từ đích đến tiếp theo của người dùng hiện tại tới đích đến cuối cùng của người dùng. Nếu trạng thái của chuyến đi là `GMTSTripStatusEnrouteToPickup`, thì đoạn đường còn lại sẽ là đoạn từ vị trí đón khách đến điểm trả xe.
| - (vô hiệu) TripModel: | (GMTCTripModel *) | tripModel | |
| wasUpdateRemainingRouteDistance: | (int32_t) | remainingRouteDistance | |
[optional] |
Được gọi khi quãng đường còn lại của chuyến đi đã được cập nhật.
- Các tham số:
-
tripModel Thực thể của GMTCTripModel đã tạo ra sự kiện. remainingRouteDistance Khoảng cách tính bằng mét của tuyến đường còn lại từ điểm đến tiếp theo của người dùng hiện tại tới điểm đến cuối cùng của họ. Điểm đến tiếp theo phụ thuộc vào trạng thái của chuyến đi hiện tại. Nếu trạng thái của chuyến đi là `GMTSTripStatusEnrouteToPickup`, thì điểm đến tiếp theo là vị trí trả xe. Ứng dụng của bạn phải cung cấp mọi lượt chuyển đổi đo lường cần thiết.
| - (vô hiệu) TripModel: | (GMTCTripModel *) | tripModel | |
| wasUpdateRemainingWaypoints: (Điểm chính tắc) | (nullable NSArray< GMTSTripWaypoint * > *) | remainingWaypoints | |
[optional] |
Được gọi khi điểm tham chiếu trung gian của chuyến đi đã được cập nhật.
- Các tham số:
-
tripModel Thực thể của GMTCTripModel đã tạo ra sự kiện. remainingWaypoints Các điểm tham chiếu còn lại hiện tại.
| - (vô hiệu) TripModel: | (GMTCTripModel *) | tripModel | |
| wasUpdatemiddleDestinations: | (nullable NSArray< GMTSTerminalLocation * > *) | intermediateDestinations | |
[optional] |
Được gọi khi điểm tham chiếu của chuyến đi đã được cập nhật.
- Các tham số:
-
tripModel Thực thể của GMTCTripModel đã tạo ra sự kiện. intermediateDestinations Các điểm tham chiếu trung gian còn lại hiện tại cho chuyến đi này.
| - (vô hiệu) TripModel: | (GMTCTripModel *) | tripModel | |
| wasUpdateActiveRouteTraffic: | (GMTSTrafficData có giá trị rỗng *) | activeRouteTraffic | |
[optional] |
Được gọi khi dữ liệu giao thông đã được cập nhật cho đoạn tuyến đường đang hoạt động của chuyến đi.
- Các tham số:
-
tripModel Thực thể của GMTCTripModel đã tạo ra sự kiện. activeRouteTraffic Phân đoạn lưu lượng truy cập tuyến đường đang hoạt động của chuyến đi hiện tại. Đoạn này bao gồm tuyến đường từ vị trí hiện tại của xe đến vị trí quan trọng tiếp theo. Nếu trạng thái của chuyến đi là "GMTSTripStatusEnrouteToPickup", thì vị trí quan trọng tiếp theo là vị trí đón khách. Nếu trạng thái của chuyến đi là "GMTSTripStatusEnrouteToDropoff", thì vị trí quan trọng tiếp theo là vị trí trả xe.
| - (vô hiệu) TripModel: | (GMTCTripModel *) | tripModel | |
| wasUpdateRemainingRouteTraffic: | (GMTSTrafficData có giá trị rỗng *) | remainingRouteTraffic | |
[optional] |
Được gọi khi dữ liệu giao thông đã được cập nhật cho đoạn tuyến đường còn lại của chuyến đi.
- Các tham số:
-
tripModel Thực thể của GMTCTripModel đã tạo ra sự kiện. remainingRouteTraffic Dữ liệu giao thông của đoạn tuyến đường còn lại của chuyến đi hiện tại.
| - (vô hiệu) TripModel: | (GMTCTripModel *) | tripModel | |
| wasFailUpdateTripWithError: | (nullable NSError *) | lỗi | |
[optional] |
Được gọi khi lỗi yêu cầu giám sát chuyến đi được cập nhật.
- Các tham số:
-
tripModel Thực thể của GMTCTripModel đã tạo ra sự kiện. error Lỗi của yêu cầu giám sát chuyến đi hiện tại. Giá trị có thể là nil.