Thông báo: Kiểu bản đồ cơ sở mới sắp ra mắt trên Nền tảng Google Maps. Bản cập nhật này về kiểu bản đồ bao gồm bảng màu mặc định mới, ghim hiện đại và các điểm cải tiến về trải nghiệm và khả năng sử dụng bản đồ. Tất cả kiểu bản đồ sẽ được tự động cập nhật 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 sử dụng 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.

Khắc phục sự cố

Lỗi thanh toán và lỗi liên quan đến khoá API

Trong một số trường hợp nhất định, bản đồ được làm tối hoặc hình ảnh "âm" trong Chế độ xem đường phố có hình mờ "chỉ dành cho mục đích phát triển" có thể xuất hiện. Hành vi này thường cho thấy các vấn đề về khoá API hoặc thanh toán. Để sử dụng các sản phẩm của Google Maps Platform, bạn phải bật tính năng thanh toán trên tài khoản của mình và tất cả các yêu cầu phải có một khoá API hợp lệ. Quy trình sau đây sẽ giúp bạn khắc phục vấn đề này:

Bạn có đang sử dụng khoá API không?

Tôi không chắc. Làm cách nào để kiểm tra xem tôi có đang sử dụng khoá API hay không?

Khoá API được truyền dưới dạng tham số key trong URL dùng để tải API JavaScript của Maps. Sau đây là một số cách để kiểm tra xem bạn có đang sử dụng khoá API hay không:

Sử dụng tiện ích Chrome Google Maps Platform API Checker (Trình kiểm tra API Nền tảng Google Maps). Điều này cho phép bạn xác định xem trang web của mình có triển khai đúng cách các API Maps được cấp phép của Google hay không.
Nếu bạn đang sử dụng một thư viện hoặc trình bổ trợ để tải API JavaScript của Maps, hãy kiểm tra chế độ cài đặt của thư viện đó và tìm tuỳ chọn khoá API.
Kiểm tra lỗi trong trình duyệt của bạn. Nếu thấy các thông báo sau, tức là bạn đang sử dụng khoá API không đúng cách:

Cảnh báo về API JavaScript của Google Maps: NoApiKeys
Lỗi API JavaScript của Google Maps: MissingKeyMapError

Đối với nhà phát triển web:

Nếu bạn có quyền truy cập vào mã nguồn của ứng dụng, hãy tìm thẻ <script> dùng để tải API JavaScript của Maps. Khi tải API JavaScript của Maps, hãy thay thế YOUR_API_KEY trong mã bên dưới bằng khoá API của bạn.
```
  <script async defer
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
  </script>
```
Kiểm tra lưu lượng truy cập mạng do trang web của bạn tạo ra trong trình duyệt. Trong Chrome, bạn có thể xem thông tin này bằng cách sử dụng thẻ Mạng trong DevTools. Tại đây, bạn sẽ thấy các yêu cầu mạng do trang web của bạn thực hiện. Các yêu cầu được thực hiện bằng API JavaScript của Maps sẽ nằm trong đường dẫn maps/api/js. Tại đây, bạn có thể xác nhận xem các yêu cầu có đang sử dụng tham số key hay không. Bạn nên lọc lưu lượng truy cập mạng theo maps/api/js khi xem thẻ Mạng.

Không, tôi không sử dụng khoá API.

Để nhận khoá API, hãy nhấp vào nút bên dưới. Nếu bạn không thấy hướng dẫn thiết lập, hãy làm theo hướng dẫn đầy đủ tại bài viết Bắt đầu sử dụng Nền tảng Google Maps.
Bắt đầu

Có, tôi đang sử dụng khoá API.

Tuyệt vời! Hãy tiếp tục và kiểm tra xem dự án của bạn đã được liên kết với tài khoản thanh toán hay chưa.

Tài khoản thanh toán có được đính kèm vào dự án của bạn không?

Tôi không chắc. Làm cách nào để kiểm tra xem tài khoản thanh toán có được liên kết với dự án của tôi hay không?

Chuyển đến trang Thanh toán trong Google Cloud Console rồi chọn dự án mà bạn đã tạo khoá API. Cách xác nhận khoá đã được liên kết với dự án:

Chuyển đến phần Thông tin đăng nhập mà bạn có thể truy cập từ thanh bên trái trong Nền tảng Google Maps > Thông tin đăng nhập.
Kiểm tra để đảm bảo rằng khoá API mà bạn hiện đang sử dụng trên trang web của mình có trong danh sách. Nếu không, hãy chuyển sang một dự án khác và kiểm tra thông tin xác thực ở đó.
Nếu không thể tìm thấy dự án cho khoá API của mình, thì có thể bạn đã mất quyền truy cập vào dự án này. Hãy nhờ người khác trong tổ chức của bạn trợ giúp. Nếu không tìm thấy dự án ban đầu, bạn nên:
1. Tạo một dự án mới. Bạn có thể thực hiện việc này bằng cách chọn Dự án mới trong danh sách dự án hoặc chọn Tạo dự án thông qua trang Trình quản lý tài nguyên.
2. Tạo khoá API mới. Bạn có thể thực hiện việc này trên trang Thông tin xác thực. Sau đó, hãy nhấp vào Tạo thông tin xác thực rồi chọn Khoá API.

Sau khi bạn tìm thấy dự án của mình trong Cloud Console, hãy kiểm tra xem tài khoản thanh toán có được đính kèm hay không bằng cách chuyển đến phần Thanh toán trong trình đơn bên trái.

Không, tài khoản thanh toán không được đính kèm vào dự án của tôi.

Chuyển đến trang Bật tính năng thanh toán trong Cloud Console rồi thêm tài khoản thanh toán vào dự án của bạn. Để biết thêm thông tin, hãy xem bài viết Bắt đầu sử dụng Google Maps Platform.

Có, một tài khoản thanh toán đã được liên kết với dự án của tôi.

Tuyệt vời! Hãy đảm bảo phương thức thanh toán mà bạn cung cấp là hợp lệ.

Có phải phương thức thanh toán bạn cung cấp không còn hợp lệ (ví dụ: thẻ tín dụng đã hết hạn)?

Bạn có thể thêm, xoá hoặc cập nhật phương thức thanh toán trong Cloud Console.

API có giới hạn hằng ngày do chính bạn đặt ra và bạn đã vượt quá giới hạn đó không?

Nếu bạn đã đặt giới hạn hằng ngày cho bất kỳ API nào (điều này thường nhằm ngăn chặn mức tăng không mong muốn), bạn có thể giải quyết vấn đề này bằng cách tăng giới hạn hằng ngày.

Bạn có thể kiểm tra hạn mức hằng ngày bằng cách chuyển đến Trang tổng quan về API và dịch vụ trong Cloud Console. Sau khi chuyển đến đó, hãy làm như sau:

Chọn một dự án nếu bạn nhận được lời nhắc.
Chọn một API trong danh sách, rồi nhấp vào thẻ Định mức.

Khoá API của bạn có quy tắc hạn chế về địa chỉ IP không?

Bạn chỉ có thể sử dụng các khoá API có quy định hạn chế về địa chỉ IP với các dịch vụ web được dùng từ phía máy chủ (chẳng hạn như API Mã hoá địa lý và các API Dịch vụ web khác). Hầu hết các dịch vụ web này đều có dịch vụ tương đương trong API JavaScript của Maps (ví dụ: xem Dịch vụ mã hoá địa lý). Để sử dụng các dịch vụ phía máy khách của API Maps JavaScript, bạn cần tạo một khoá API riêng có thể được bảo mật bằng quy định hạn chế Trình giới thiệu HTTP (xem phần Lấy, thêm và hạn chế khoá API).

Nếu mã của bạn không hoạt động:

Trong video này, Brendan Kenny và Mano Marks sẽ chỉ ra một số lỗi phổ biến và cách khắc phục để giúp bạn thiết lập và chạy mã bản đồ.

Tìm lỗi chính tả. Hãy nhớ rằng JavaScript là một ngôn ngữ phân biệt chữ hoa chữ thường.
Kiểm tra các thông tin cơ bản - một số vấn đề phổ biến nhất xảy ra với việc tạo bản đồ ban đầu. Chẳng hạn như:
- Xác nhận rằng bạn đã chỉ định các thuộc tính zoom và center trong các tuỳ chọn bản đồ.
- Đảm bảo rằng bạn đã khai báo một phần tử div trong đó bản đồ sẽ xuất hiện trên màn hình.
- Đảm bảo phần tử div cho bản đồ có chiều cao. Theo mặc định, các phần tử div được tạo với chiều cao là 0 và do đó không hiển thị.
Hãy tham khảo các ví dụ của chúng tôi về cách triển khai tệp tham chiếu.
Sử dụng trình gỡ lỗi JavaScript để xác định vấn đề, chẳng hạn như trình gỡ lỗi có trong Công cụ dành cho nhà phát triển Chrome. Bắt đầu bằng cách tìm lỗi trong bảng điều khiển JavaScript.
Đăng câu hỏi lên Stack Overflow. Bạn có thể xem nguyên tắc về cách đăng câu hỏi hay trên trang Hỗ trợ.