Lỗi xử lý

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

Thẻ thông tin 2D và hình ảnh trong Chế độ xem đường 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 Thẻ thông tin 2D và hình ảnh trong Chế độ xem đường phố.

Liệt kê lỗi

Danh sách sau đây nêu chi tiết các lỗi mà bạn có thể gặp phải khi sử dụng Map Tiles API.

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 tham số nào bị thiếu.

notFound, invalid

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

• Đối với ô bản đồ thông thường, mức thu phóng tối đa phụ thuộc vào ô bản đồ cụ thể và 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^zoom)-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 Thẻ thông tin trong Chế độ xem đường 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 đường phố, phạm vi toạ độ x và y giống như đối với các ô bản đồ thông thường, cho đến khi thu phóng cấp 5. Khi đó, giá trị tối đa sẽ là imageHeight hoặc imagewidth chia cho tileHeight hoặc tileWidth.

forbidden: Yêu cầu thiếu 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 2 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 nhận một mã thông báo phiên mới, như mô tả trong phần Sử dụng mã phiên.

badRequest

Yêu cầu của bạn không đúng định dạng. Sau đây là một số lý do phổ biến dẫn đến vấn đề này:

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

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

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

quotaExceeded, rateLimitExceeded

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

Lỗi ví dụ

{
  "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ành công với quotaExceeded và rateLimitExceeded, bạn nên thử lại yêu cầu của mình, chẳng hạn như để các yêu cầu bị lỗi hoặc lỗi trên quy mô lớn không làm tràn máy chủ Goodle – vì nhiều ứng dụng cố gắng thử lại các yêu cầu một cách nhanh chóng liên tiếp. Điều này có nghĩa là bạn có thể sử dụng tính năng thời gian đợi luỹ thừa khi thử lại các yêu cầu của mình. Thuật toán thời gian đợi luỹ thừa buộc bạn phải đưa ra các yêu cầu của mình kịp thời để máy chủ có thời gian khôi phục.

Ví dụ: nếu yêu cầu không thành công thì sẽ thử lại sau một giây. Tuy nhiên, nếu cách đó cũng không thành công, hãy thử lại yêu cầu của bạn sau 2 giây. Nếu yêu cầu đó cũng không thành công, hãy thử lại sau 4 giây. Vì vậy, bạn đã phân bổ hiệu quả từng yêu cầu liên tiếp bằng cách tăng gấp đôi khoảng thời gian giữa các yêu cầu đó.

Gạch 3D

Bạn có thể không thấy rõ các lỗi trên máy chủ của Google vì bạn truy cập vào các thẻ thông tin ảnh thực tế thông qua trình kết xuất. Trình kết xuất này chịu trách nhiệm xử lý các 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 tự động không tải được khi xảy ra lỗi máy chủ. Điều này có thể dẫn đến sự cố, màn hình trống và một số thẻ thông tin không tải được.

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 cụ thể mà 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ụ tích hợp trong 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.

Các lỗi phổ biến

Danh sách sau đây chứa thông tin chi tiết về các lỗi phổ biến nhất mà bạn có thể 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 thẻ thông tin không hợp lệ hoặc mã thông báo của phiên đã hết hạn.

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

Thiếu khoá API, thiếu kết nối SSL hoặc khoá API chưa được thêm vào danh sách cho phép đối với Thẻ thông tin 3D. Hãy liên hệ với Nhóm hỗ trợ Google bằng mã dự án của bạn để được thêm 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. Hãy liên hệ với Nhóm hỗ trợ Google để tăng hạn mức của bạn.