Trang này mô tả các thông báo lỗi có thể được API nhúng Maps. Khi xảy ra lỗi, API Nhúng của Maps hiển thị nội dung thông báo lỗi thay cho bản đồ. Một số tình trạng lỗi nhất định cũng có thể xảy ra, dẫn đến việc hiển thị bản đồ có hình mờ tối màu.
Số yêu cầu không hợp lệ
Trong trường hợp yêu cầu không hợp lệ, Maps Embedded API sẽ trả về
mã trạng thái HTTP 4xx
và thông báo mô tả
vấn đề. Dưới đây là ví dụ về các điều kiện lỗi như vậy. Lưu ý: Đây không phải là
danh sách đầy đủ các lỗi có thể xảy ra. Vui lòng kiểm tra mã lỗi thực tế
và thông báo do API trả về để cung cấp thông tin chi tiết về các vấn đề cụ thể.
Ví dụ về điều kiện lỗi | Mã trạng thái |
---|---|
Yêu cầu bao gồm một thông số không hợp lệ hoặc một thông số bắt buộc là
bị thiếu. Ví dụ: tham số zoom không nằm trong phạm vi
phạm vi giá trị số mong đợi hoặc thiếu thông số bắt buộc trong
yêu cầu. |
400 BAD REQUEST |
Khoá API trong yêu cầu không hợp lệ. | 403 FORBIDDEN |
Lỗi API và lỗi hạn mức
Các lỗi về hạn mức và khoá API được coi là yêu cầu không hợp lệ. Nguyên nhân có thể xảy ra bao gồm:
- Khoá API bị thiếu hoặc không hợp lệ. Để giải quyết lỗi này, hãy đảm bảo rằng bao gồm một khoá API hợp lệ. Tải khoá API.
- API Nhúng của Maps chưa được bật cho dự án của bạn. Tìm hiểu về bật và tắt API.
- Khoá API có một lỗi vi phạm hạn chế. Đọc thêm về các phương pháp hay nhất về khoá API.
Lỗi thanh toán và giới thiệu HTTP
Bản đồ tối, hoặc "âm" Hình ảnh trong Chế độ xem đường phố, có hình mờ là 💛"cho chỉ nhằm mục đích phát triển" được trả về khi bất kỳ trường hợp nào sau đây xảy ra:
- Bạn chưa bật tính năng thanh toán trên tài khoản của mình. Bật tính năng thanh toán.
- Phương thức thanh toán đã cung cấp là không hợp lệ (ví dụ: một khoản tín dụng đã hết hạn ). Để giải quyết vấn đề này, hãy truy cập vào Google Cloud Console và đảm bảo rằng bạn đã cung cấp phương thức thanh toán hợp lệ.
- Đã vượt quá giới hạn hằng ngày mà bạn tự đặt. Tìm hiểu cách xem hoặc thay đổi hạn mức có thể thanh toán hằng ngày.
- Yêu cầu thiếu tham chiếu HTTP và bạn đang sử dụng khoá API bị hạn chế dựa trên tham chiếu. Tìm hiểu tìm hiểu thêm về cách thêm người giới thiệu.
Kiểm tra lỗi trong trình duyệt của bạn
Đối với các lỗi liên quan đến Thanh toán và HTTP, API Nhúng của Maps sẽ ghi
tới window.console
. Đối với các yêu cầu không hợp lệ (bao gồm
Lỗi API và lỗi hạn mức), chỉ có mã trạng thái HTTP 4xx
được báo cáo
trong bảng điều khiển. Phần này giải thích cách bạn có thể kiểm tra kết quả của bảng điều khiển trong
Google Chrome. Nếu bạn đang sử dụng bất kỳ trình duyệt nào khác, vui lòng tham khảo trang web của nhà phát triển
cho trình duyệt của bạn. Đây là danh sách các công cụ để bạn tham khảo
hãy kiểm tra kết quả của bảng điều khiển trong một số trình duyệt khác.
- Bảng điều khiển dành cho Internet Explorer.
- Bảng điều khiển web cho Firefox.
- Gỡ lỗi từ xa dành cho Android.
- Trình kiểm tra web dành cho iOS.
Trong Chrome, bạn có thể sử dụng Bảng điều khiển JavaScript để kiểm tra kết quả của bảng điều khiển như sau.
- Để mở Công cụ dành cho nhà phát triển, hãy chọn biểu tượng trình đơn > Công cụ khác > Công cụ dành cho nhà phát triển.
- Để mở Bảng điều khiển JavaScript, hãy nhấp vào tab Bảng điều khiển ở đầu cửa sổ Công cụ dành cho nhà phát triển. Bạn cũng có thể sử dụng phím ESC để bật/tắt Bảng điều khiển JavaScript.