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 mà API nhúng Maps có thể trả về. Khi xảy ra lỗi, API nhúng Maps sẽ hiển thị văn bản thông báo lỗi thay vì bản đồ. Một số điều kiện lỗi cũng có thể xảy ra, dẫn đến việc bản đồ có hình mờ bị tối.

Yêu cầu không hợp lệ

Trong trường hợp yêu cầu không hợp lệ, API nhúng Maps sẽ trả về một mã trạng thái 4xx HTTP và một 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ề để biết 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 có một tham số không hợp lệ hoặc thiếu một tham số bắt buộc. Ví dụ: tham số `zoom` không nằm trong phạm vi giá trị số dự kiến hoặc thiếu một tham số bắt buộc trong yêu cầu.	`400 BAD REQUEST`
Khoá API trong yêu cầu là không hợp lệ.	`403 FORBIDDEN`

Lỗi hạn mức và khoá API

Lỗi khoá API và lỗi hạn mức được coi là yêu cầu không hợp lệ. Có thể là do một số nguyên nhân sau:

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 yêu cầu của bạn có chứa khoá API hợp lệ. Lấy khoá API.
Bạn chưa bật API nhúng Maps cho dự án của mình. Tìm hiểu về cách bật và tắt API.
Khoá API có lỗi vi phạm quy tắc 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à lỗi liên quan đến HTTP referer

Hệ thống sẽ trả về một bản đồ bị làm tối hoặc hình ảnh "âm" của Chế độ xem đường phố, có hình mờ"chỉ dành cho mục đích phát triển" khi xảy ra một trong những trường hợp sau:

Tài khoản của bạn chưa được bật tính năng thanh toán. Bật tính năng thanh toán.
Phương thức thanh toán bạn cung cấp không hợp lệ (ví dụ: thẻ 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ệ.
Bạn đã vượt quá giới hạn hằng ngày do chính bạn đặt ra. Tìm hiểu cách xem hoặc thay đổi hạn mức tính phí hằng ngày.
Yêu cầu thiếu một trình giới thiệu HTTP và bạn đang sử dụng khoá API bị hạn chế về trình giới thiệu. Tìm hiểu thêm về cách thêm trình giới thiệu.

Kiểm tra lỗi trong trình duyệt

Đối với lỗi liên quan đến trình giới thiệu Billing và HTTP, API nhúng Maps sẽ ghi thông báo lỗi vào window.console. Đối với các yêu cầu không hợp lệ (bao gồm cả lỗi khoá API và hạn mức), chỉ mã trạng thái HTTP 4xx mới đượ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 đầu ra của bảng điều khiển trong Google Chrome. Nếu bạn đang sử dụng trình duyệt nào khác, vui lòng kiểm tra tài liệu dành cho nhà phát triển của trình duyệt đó. Để bạn tham khảo, sau đây là danh sách các công cụ để kiểm tra đầu ra của bảng điều khiển trong một số trình duyệt khác.

Console dành cho Internet Explorer.
Web Console dành cho Firefox.
Gỡ lỗi từ xa cho Android.
Công cụ 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 thẻ Console (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 Console JavaScript.