Xử lý lỗi

Sau khi đưa ra yêu cầu, có thể bạn sẽ nhận được phản hồi có chứa lỗi chi tiết.

Ô 2D và hình ảnh trong Chế độ xem phố

Danh sách sau đây trình bày chi tiết các lỗi mà bạn có thể gặp phải khi sử dụng mô hình 2D Ô và hình ảnh trong Chế độ xem đường phố.

Liệt kê lỗi

Danh sách sau đây trình bày chi tiết các lỗi mà bạn có thể gặp phải khi sử dụng API Bản đồ ô.

required

Yêu cầu của bạn thiếu tham số URL. Xin lưu ý rằng thông báo lỗi cho biết thiếu thông số nào.

notFound, invalid

x, y hoặc Các giá trị z nằm ngoài phạm vi.

• Đối với các ô bản đồ thông thường, mức thu phóng tối đa phụ thuộc vào ô bản đồ và trên các tuỳ chọn bản đồ mà bạn đã yêu cầu.

• Đối với các ô bản đồ thông thường, toạ độ x phải nằm trong phạm vi [0, (2^thu phóng)-1].

• Đối với các ô bản đồ thông thường, toạ độ y phải nằm trong phạm vi [0, (2^(zoom-1))-1].

• Đối với các Ô Chế độ xem phố, mức thu phóng phải nằm trong khoảng từ 0 đến 5.

• Đối với Thẻ thông tin Chế độ xem phố, phạm vi toạ độ x và y giống như cho các ô bản đồ thông thường, cho đến thu phóng cấp 5. Vào thời điểm đó, tối đa giá trị là imageHeight hoặc imagewidth chia cho tileHeight hoặc tileWidth.

forbidden: Yêu cầu thiếu một khoá API hợp lệ.

expired

Mã thông báo session của bạn đã hết hạn. Mã thông báo phiên có hiệu lực trong hai tuần kể từ thời điểm tạo. Xin lưu ý rằng điều này có thể thay đổi mà không cần thông báo. Nếu gặp lỗi này, bạn phải tạo một phiên mới mã thông báo, như được mô tả trong Sử dụng mã thông báo phiên.

badRequest

Yêu cầu của bạn không đúng định dạng. Lý do phổ biến dẫn đến điều này bao gồm:

• Bạn đã chỉ định loại bản đồ terrain mà không bao gồm lớp roadmap.

• Bạn đã thêm một mảng styles cho loại bản đồ không phải là lộ trình.

• Bạn đã gửi giá trị vĩ độ/kinh độ và mã nhận dạng ảnh toàn cảnh trong siêu dữ liệu của Chế độ xem đường phố của bạn.

quotaExceeded, rateLimitExceeded

Ứng dụng của bạn đã vượt quá hạn mức được cho phép hoặc vượt quá hạn mức cho phép số truy vấn mỗi giây.

Ví dụ về lỗi

{
  "error": {
    "code": 403,
    "message": "The request is missing a valid API key.",
    "errors": [
      {
        "message": "The request is missing a valid API key.",
        "domain": "global",
        "reason": "forbidden"
      }
    ],
    "status": "PERMISSION_DENIED"
  }
}

Đang thử lại yêu cầu

Khi yêu cầu không thực hiện được bằng quotaExceeded và rateLimitExceeded, bạn nên thử lại yêu cầu của mình, chẳng hạn như theo cách các yêu cầu bị hỏng hoặc lỗi trên quy mô rộng đừng làm ngập các máy chủ Goodle vì nhiều khách hàng cố gắng thử lại các yêu cầu một cách nhanh chóng kế thừa. Điều này có nghĩa là việc sử dụng thuật toán thời gian đợi luỹ thừa khi bạn thử yêu cầu lại. Thuật toán thời gian đợi luỹ thừa buộc bạn phải mở rộng kịp thời để máy chủ có thời gian phục hồi.

Ví dụ: nếu yêu cầu không thành công thì hãy thử lại sau một giây. Nhưng nếu việc đó không thành công, thì hãy thử yêu cầu lại sau 2 giây. Nếu có cũng không thành công, rồi thử lại sau 4 giây. Như vậy, bạn có thể quảng bá hiệu quả mỗi yêu cầu liên tiếp bằng cách nhân đôi khoảng thời gian giữa chúng.

Gạch 3D

Lỗi từ máy chủ của Google có thể không rõ ràng với bạn vì bạn truy cập ô ảnh chân thực thông qua trình kết xuất đồ hoạ, chịu trách nhiệm xử lý lỗi máy chủ.

Lỗi trình kết xuất thẻ thông tin

Ví dụ: trình kết xuất CesiumJS thường không hoạt động một cách âm thầm khi lỗi máy chủ và có thể dẫn đến bất kỳ điều gì từ sự cố, màn hình trống, cho đến không tải được thẻ thông tin.

Kỹ thuật mà bạn sử dụng để gỡ lỗi máy chủ sẽ phụ thuộc vào trình kết xuất đồ hoạ bạn sử dụng. Đối với các trình kết xuất dựa trên trình duyệt như CesiumJS, bạn có thể kiểm tra lưu lượng truy cập mạng bằng các công cụ được tích hợp vào hầu hết các trình duyệt. Ví dụ: bạn có thể sử dụng Công cụ của Chrome cho nhà phát triển.

Lỗi phổ biến

Danh sách sau đây chứa thông tin chi tiết về những lỗi phổ biến nhất mà bạn có thể gặp phải gặp phải.

400: Đối số không hợp lệ

Khoá API, tham số truy vấn, mã thẻ thông tin/nhóm ô không hợp lệ hoặc phiên đã hết hạn mã thông báo.

403: Quyền bị từ chối

Thiếu khoá API, thiếu kết nối SSL hoặc bạn chưa thêm khoá API vào danh sách cho phép dành cho Thẻ thông tin 3D. Liên hệ với Google Hỗ trợ bằng mã dự án của bạn để được thêm vào vào danh sách cho phép sử dụng chức năng Thẻ thông tin 3D của API Thẻ thông tin bản đồ.

429: Quá nhiều yêu cầu

Hạn mức của bạn đã hết. Thông tin liên hệ Nhóm hỗ trợ Google để tăng hạn mức của bạn.