Trang này được dịch bởi Cloud Translation API.

Xử lý lỗi

Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)

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

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

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

Lỗi khi liệt kê

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 Map Tiles API.

required

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

notFound, invalid

Giá trị x, y hoặc z của bạn 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 đồ cụ thể và các lựa chọn về 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 ô Chế độ xem đường phố, mức thu phóng phải nằm trong khoảng từ 0 đến 5.
Đối với Ô Chế độ xem đường phố, phạm vi toạ độ x và y giống như đối với ô bản đồ thông thường, cho đến khi đạt mức thu phóng 5. Tại thời điểm đó, giá trị tối đa là imageHeight hoặc imagewidth chia cho tileHeight hoặc tileWidth.

forbidden:

Nguyên nhân có thể có:

Yêu cầu thiếu một khoá API hợp lệ.
Tin nhắn: Your request cannot be served. Please ensure the parameters and request type are valid for your account and region.

Các ô vệ tinh 2D không có trong những dự án được liên kết với một tài khoản thanh toán có địa chỉ ở Khu vực kinh tế Châu Âu (EEA). Để biết thêm thông tin, hãy xem bài viết Điều chỉnh Map Tiles API cho khách hàng ở Khu vực kinh tế Châu Âu (EEA).

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 thông tin 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 lấy 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. Lỗi này thường xảy ra vì các nguyên nhân sau:

Bạn đã chỉ định loại bản đồ terrain mà không thêm lớp roadmap.
Bạn đã thêm một mảng styles cho loại bản đồ không phải là bản đồ đường đi.
Bạn đã gửi giá trị vĩ độ/kinh độ cũng như mã nhận dạng toàn cảnh trong một 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 đượ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 các 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 diện rộng không làm tràn ngập máy chủ của Google – vì nhiều ứng dụng cố gắng thử lại các yêu cầu liên tục. Điều này có nghĩa là bạn phải sử dụng thuật toán thời gian đợi luỹ thừa khi 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 để 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. Nhưng nếu lần thử đó cũng không thành công, hãy thử lại yêu cầu 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ể trải đều từng yêu cầu liên tiếp bằng cách chỉ cần tăng gấp đôi khoảng thời gian giữa các yêu cầu.

Ô 3D

Bạn có thể không nhận thấy các lỗi từ máy chủ của Google vì bạn truy cập vào các ô có độ chân thực cao thông qua một 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 ô

Ví dụ: trình kết xuất CesiumJS thường gặp lỗi âm thầm khi xảy ra lỗi máy chủ, điều này có thể dẫn đến mọi thứ, từ sự cố, màn hình trống cho đến các ô cụ thể 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ụ đượ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.

Lỗi phổ biến

Danh sách sau đây chứa thông tin chi tiết về những lỗi thường gặp 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ã nhận dạng ô/tập hợp ô không hợp lệ hoặc mã thông báo phiên đã hết hạn.
400: Giá trị không hợp lệ: Đảm bảo rằng mapType mà yêu cầu createSessionToken được thực hiện khớp với mapType được dùng trong điểm cuối ô tiếp theo. Ví dụ: bạn không thể dùng mã thông báo phiên streetview để yêu cầu một ô roadmap.

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