จัดการข้อผิดพลาด SDK ของผู้บริโภค

Consumer SDK จะส่งข้อผิดพลาดในการอัปเดตการเดินทางไปยังแอปของผู้บริโภคโดยใช้กลไกการติดต่อกลับ พารามิเตอร์โค้ดเรียกกลับเป็นประเภทผลตอบแทนเฉพาะแพลตฟอร์ม (TripUpdateError ใน Android และ NSError ใน iOS)

การแยกรหัสสถานะ

ข้อผิดพลาดที่ส่งไปยังโค้ดเรียกกลับมักจะเป็นข้อผิดพลาด gRPC และคุณยังดึงข้อมูลเพิ่มเติมจากข้อผิดพลาดในรูปแบบรหัสสถานะได้ด้วย ดูรายการรหัสสถานะทั้งหมดได้ที่รหัสสถานะและการใช้รหัสใน gRPC

Java

คุณแยกรหัสสถานะ gRPC ที่มีรายละเอียดเกี่ยวกับข้อผิดพลาดจาก TripUpdateError ที่แสดงผลจาก onTripUpdateError() ได้

// Called when there is a trip update error.
@Override
public void onTripUpdateError(TripInfo tripInfo, TripUpdateError error) {
  Status.Code code = error.getStatusCode();
}

Kotlin

คุณแยกรหัสสถานะ gRPC ที่มีรายละเอียดเกี่ยวกับข้อผิดพลาดจาก TripUpdateError ที่แสดงผลจาก onTripUpdateError() ได้

// Called when there is a trip update error.
override fun onTripUpdateError(tripInfo: TripInfo, error: TripUpdateError) {
  val code = error.getStatusCode()
}

Swift

NSError จะโทรกลับใน tripModel(_:didFailUpdateTripWithError:)

// Called when there is a trip update error.
func tripModel(_ tripModel: GMTCTripModel, didFailUpdateTripWithError error: Error?) {
  // Check to see if the error comes from gRPC.
  if let error = error as NSError?, error.domain == "io.grpc" {
    let gRPCErrorCode = error.code
    ...
  }
}

Objective-C

NSError จะโทรกลับใน tripModel:didFailUpdateTripWithError:

// Called when there is a trip update error.
- (void)tripModel:(GMTCTripModel *)tripModel didFailUpdateTripWithError:(NSError *)error {
  // Check to see if the error comes from gRPC.
  if ([error.domain isEqualToString:@"io.grpc"]) {
    NSInteger gRPCErrorCode = error.code;
    ...
  }
}

การแปลรหัสสถานะ

รหัสสถานะครอบคลุมข้อผิดพลาด 2 ประเภท ได้แก่ ข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์และเครือข่าย และข้อผิดพลาดฝั่งไคลเอ็นต์

ข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์และเครือข่าย

รหัสสถานะต่อไปนี้มีไว้สำหรับข้อผิดพลาดเกี่ยวกับเครือข่ายหรือเซิร์ฟเวอร์ และคุณไม่จำเป็นต้องดำเนินการใดๆ เพื่อแก้ไข Consumer SDK จะ กู้คืนโดยอัตโนมัติ

รหัสสถานะ	คำอธิบาย
ล้มเลิก	เซิร์ฟเวอร์หยุดส่งการตอบกลับ ซึ่งโดยปกติจะเกิดจากปัญหาของเซิร์ฟเวอร์
ยกเลิกแล้ว	เซิร์ฟเวอร์ยุติการตอบกลับขาออก โดยปกติ กรณีนี้จะเกิดขึ้นเมื่อ มีการส่งแอปไปยังเบื้องหลัง หรือเมื่อมีการเปลี่ยนแปลงสถานะใน แอปสำหรับผู้บริโภค
ขัดข้อง
DEADLINE_EXCEEDED	เซิร์ฟเวอร์ใช้เวลาตอบสนองนานเกินไป
UNAVAILABLE	เซิร์ฟเวอร์ไม่พร้อมใช้งาน ซึ่งโดยปกติจะเกิดจากปัญหาของเครือข่าย

ข้อผิดพลาดของไคลเอ็นต์

รหัสสถานะต่อไปนี้จะใช้สำหรับข้อผิดพลาดของไคลเอ็นต์ และคุณต้องดำเนินการแก้ไข SDK ผู้บริโภคจะพยายามรีเฟรชการเดินทางอย่างต่อเนื่องจนกว่าคุณจะสิ้นสุดการแชร์เส้นทาง แต่จะกู้คืนไม่ได้จนกว่าคุณจะดำเนินการ

รหัสสถานะ	คำอธิบาย
INVALID_ARGUMENT	แอป Consumer ระบุชื่อการเดินทางไม่ถูกต้อง ชื่อการเดินทางต้องอยู่ในรูปแบบ providers/{provider_id}/trips/{trip_id}
NOT_FOUND	ไม่เคยสร้างการเดินทางนี้
PERMISSION_DENIED	แอป Consumer มีสิทธิ์ไม่เพียงพอ ข้อผิดพลาดนี้เกิดขึ้นเมื่อ แอป Consumer ไม่มีสิทธิ์ ไม่ได้เปิดใช้ Consumer SDK สำหรับโปรเจ็กต์ใน Google Cloud Console ไม่มีโทเค็น JWT หรือโทเค็นไม่ถูกต้อง โทเค็น JWT มีการลงนามด้วยรหัสการเดินทางที่ไม่ตรงกับการเดินทางที่ขอ
RESOURCE_EXHAUSTED	โควต้าทรัพยากรเป็น 0 หรืออัตราการรับส่งข้อมูลเกินขีดจำกัดความเร็ว
ไม่ได้ตรวจสอบสิทธิ์	คำขอตรวจสอบสิทธิ์ไม่สำเร็จเนื่องจากโทเค็น JWT ไม่ถูกต้อง ข้อผิดพลาดนี้เกิดขึ้นเมื่อโทเค็น JWT ได้รับการลงนามโดยไม่มีรหัสการเดินทาง หรือเมื่อโทเค็น JWT หมดอายุ