Kiểu bản đồ mới sắp xuất hiện trên Nền tảng Google Maps. Bản cập nhật này để tạo kiểu bản đồ bao gồm một bảng màu mặc định mới và các cải tiến về trải nghiệm bản đồ cũng như khả năng hữu dụng. Tất cả kiểu bản đồ sẽ được cập nhật tự động vào tháng 3 năm 2025. Để biết thêm thông tin về phạm vi cung cấp và cách chọn tham gia sớm hơn, hãy xem bài viết Kiểu bản đồ mới cho Nền tảng Google Maps.

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

Thông báo lỗi

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.