Khắc phục sự cố

Sau đây là một số mẹo về cách khắc phục các vấn đề thường gặp.

Tại sao bán kính độ chính xác lại rất lớn?

Nếu phản hồi về Vị trí địa lý cho thấy một giá trị rất cao trong trường độ chính xác, thì dịch vụ này có thể xác định vị trí địa lý dựa trên IP yêu cầu thay vì các điểm truy cập Wi-Fi hoặc trạm di động. Các loại phản hồi này có thể xảy ra nếu dịch vụ không nhận dạng được bất kỳ trạm di động hoặc điểm truy cập nào.

Để xác nhận rằng dịch vụ không thể xác định vị trí địa lý của các điểm truy cập, hãy đặt considerIp thành false trong yêu cầu của bạn. Nếu phản hồi là 404, thì bạn đã xác nhận rằng các đối tượng wifiAccessPoints và cellTowers không thể được xác định vị trí địa lý.

Làm cách nào để khắc phục lỗi phản hồi?

Nếu yêu cầu của bạn tạo ra lỗi, hệ thống sẽ trả về một nội dung phản hồi lỗi ở định dạng tiêu chuẩn và đặt mã trạng thái HTTP thành trạng thái lỗi.

Phản hồi lỗi chứa một đối tượng có một đối tượng lỗi duy nhất với các khoá sau:

  • code: Khoá này giống với trạng thái HTTP của phản hồi.
  • message: Nội dung mô tả ngắn gọn về lỗi.
  • errors: Danh sách các lỗi đã xảy ra. Mỗi lỗi chứa một mã nhận dạng cho loại lỗi (lý do) và nội dung mô tả ngắn gọn (thông báo).

Ví dụ: việc gửi JSON không hợp lệ sẽ trả về lỗi sau:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "parseError",
    "message": "Parse Error",
   }
  ],
  "code": 400,
  "message": "Parse Error"
 }
}

Thu thập thông tin kiểm thử từ các thiết bị

Để kiểm thử thêm, bạn có thể thu thập thông tin từ thiết bị của mình bằng các dịch vụ vị trí tích hợp do từng nền tảng cung cấp:

Nội dung mô tả về lỗi

Sau đây là các lỗi có thể xảy ra mà bạn có thể gặp phải cùng với nội dung mô tả.

Lý do Miền Mã trạng thái HTTP Mô tả
dailyLimitExceeded usageLimits 403 Bạn đã vượt quá giới hạn hằng ngày.
keyInvalid usageLimits 400 Khoá API của bạn không hợp lệ đối với API Vị trí địa lý. Hãy nhớ đưa toàn bộ khoá và đảm bảo rằng bạn đã mua API hoặc đã bật tính năng thanh toán và kích hoạt API để nhận hạn mức miễn phí.
userRateLimitExceeded usageLimits 403 Bạn đã vượt quá giới hạn yêu cầu mà bạn đã định cấu hình trong bảng điều khiển Cloud. Giới hạn này thường được đặt là số yêu cầu mỗi ngày, số yêu cầu mỗi 100 giây, và số yêu cầu mỗi 100 giây cho mỗi người dùng. Bạn nên định cấu hình giới hạn để ngăn một người dùng hoặc một nhóm nhỏ người dùng sử dụng hết hạn mức hằng ngày, đồng thời vẫn cho phép tất cả người dùng truy cập một cách hợp lý. Hãy xem bài viết Giới hạn mức sử dụng API để định cấu hình các giới hạn này.
notFound geolocation 404 Yêu cầu này hợp lệ nhưng không có kết quả nào được trả về.
parseError global 400 Nội dung yêu cầu không phải là JSON hợp lệ. Hãy tham khảo phần Nội dung yêu cầu để biết thông tin chi tiết về từng trường.