Xử lý lỗi

Sau khi gửi 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.

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

Lỗi khi đăng

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 Thẻ thông tin trên bản đồ.

required

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

notFound, invalid

Giá trị x, y hoặc z nằm ngoài dải ô.

• Đố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 đồ 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 khoảng [0, (2^(zoom-1))-1].

• Đối với Thẻ thông tin 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 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, thì 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ã thông báo 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:

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

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

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

quotaExceeded, rateLimitExceeded

Ứng dụng của bạn đã vượt quá hạn mức được phép hoặc vượt quá số lượng truy vấn được phép 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"
  }
}

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 theo cách mà các yêu cầu bị hỏng hoặc lỗi trên quy mô lớn không làm ngập máy chủ Google – vì nhiều ứng dụng cố gắng thử lại yêu cầu liên tiếp một cách nhanh chóng. Điều này có nghĩa là sử dụng thời gian đợi luỹ thừa khi bạn thử lại các yêu cầu. Thời gian đợi luỹ thừa buộc bạn phải trải đều các yêu cầu theo thời gian để cho máy chủ có thời gian khôi phục.

Ví dụ: nếu một yêu cầu không thành công, hãy thử lại sau một giây. Tuy nhiên, nếu lần thử đó 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 có thể phân tán từng yêu cầu liên tiếp một cách hiệu quả bằng cách tăng gấp đôi khoảng thời gian giữa chúng.

Gạch 3D

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

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