Hãy tham gia Ngày cộng đồng nhà phát triển Google Maps Platform tiếp theo của chúng tôi tại San Francisco vào tháng 12! Đăng ký ngay để tham dự.

Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

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 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 các lỗi mà bạn có thể gặp phải khi sử dụng 2D Tiles và hình ảnh trong Chế độ xem đường phố.

Danh sách lỗi

Danh sách sau đây trình bày chi tiết các lỗi 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 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 Ô Chế độ xem phố, mức thu phóng phải nằm trong khoảng từ 0 đến 5, bao gồm cả hai giá trị này.
Đối với Ô Chế độ xem phố, phạm vi toạ độ x và y giống như đối với ô bản đồ thông thường, cho đến khi thu phóng cấp 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 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.

Mảnh bản đồ vệ tinh 2D không có trong các 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ã phiên có hiệu lực trong hai 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 nhận được lỗi này, thì bạn phải lấy mã 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. 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 một loại bản đồ không phải là bản đồ đường đi.
Bạn đã gửi một giá trị vĩ độ/kinh độ, cũng như một mã nhận dạng ả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 được 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"
  }
}

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 diện rộng không làm quá tải máy chủ của Google, vì nhiều ứng dụng khách cố gắng thử lại yêu cầu liên tiếp. Điều này có nghĩa là bạn nên sử dụng thuật toán đợi luỹ tuyến khi thử lại các yêu cầu. Thời gian đợi luỹ thừa buộc bạn phải phân bổ 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. 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 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 bổ hiệu quả mỗi 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.

Ô 3D

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

Kỹ thuật bạn sử dụng để gỡ lỗi lỗi phía 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ụ đượ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 Chrome DevTools.

Lỗi thường gặp

Danh sách sau đây trình bày 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ã nhận dạng thẻ thông tin/nhóm thẻ thông tin 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 của ô tiếp theo. Ví dụ: bạn không thể sử dụng mã phiên streetview để yêu cầu một ô roadmap.

403: Permission denied