Places UI Kit: Một thư viện có thể sử dụng ngay, cung cấp không gian tuỳ chỉnh và kiểm soát cho nhà phát triển. Hãy dùng thử và chia sẻ ý kiến của bạn về trải nghiệm dùng Bộ giao diện người dùng.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Thông báo lỗi

Trang này mô tả các thông báo lỗi mà Maps JavaScript API có thể trả về. Maps JavaScript API ghi thông báo lỗi và cảnh báo vào bảng điều khiển JavaScript. Một số điều kiện lỗi cũng có thể xảy ra, dẫn đến việc hiển thị bản đồ có hình mờ bị tối.

Lỗi về khoá API và lỗi thanh toán

Khắc phục sự cố

Trong một số trường hợp, một bản đồ tối hoặc hình ảnh Chế độ xem đường phố "âm bản", có đóng dấu bản quyền bằng văn bản "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 đề liên quan đến khoá API hoặc thông tin thanh toán. Để sử dụng các sản phẩm của Google Maps Platform, bạn phải bật thông tin thanh toán trong tài khoản của mình và tất cả các yêu cầu phải có khoá API hợp lệ. Để được trợ giúp về cách tìm thông báo lỗi, hãy xem phần kiểm tra lỗi trong trình duyệt.

Quy trình sau đây sẽ giúp bạn khắc phục vấn đề.

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 của Chrome Google Maps Platform API Checker. Điều này giúp bạn xác định xem trang web của mình có đang 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 Maps JavaScript API, hãy kiểm tra chế độ cài đặt cho thư viện đó và tìm lựa chọn khoá API.
Kiểm tra lỗi trong trình duyệt. 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ề Google Maps JavaScript API: NoApiKeys
Lỗi Google Maps JavaScript API: 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 củ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 trong trình duyệt. Trong Chrome, bạn có thể xem thông tin này bằng thẻ DevTools của Công cụ cho nhà phát triển. Tại đây, bạn sẽ thấy các yêu cầu mạng do trang web của mình 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 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 quy trình thiết lập có hướng dẫn, hãy làm theo hướng dẫn đầy đủ tại Làm quen với Nền tảng Google Maps.
Bắt đầu

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

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

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 đính kèm vào dự án của tôi hay không?

Chuyển đến trang Thanh toán trong bảng điều khiển Google Cloud 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 mục Thông tin xác thực. Bạn có thể truy cập vào mục này từ thanh bên trái trong phần Google Maps Platform > Thông tin xác thực.
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 phải như vậy, hãy chuyển sang một dự án khác và kiểm tra thông tin đăng nhập ở đó.
Nếu không tìm thấy dự án cho khoá API của mình, có thể bạn đã mất quyền truy cập vào dự án này. Yêu cầu những 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 gốc, 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 bằng cách chọn Tạo dự án thông qua trang Trình quản lý tài nguyên.
2. Tạo một khoá API mới. Bạn có thể thực hiện việc này trên trang Thông tin đăng nhập. 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 bảng điều khiển Cloud, 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 mục Thanh toán trong trình đơn bên trái.

Không, dự án của tôi không có tài khoản thanh toán.

Chuyển đến trang Bật tính năng thanh toán trong bảng điều khiển Cloud và thêm một 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 Nền tảng Google Maps.

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

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

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 bảng điều khiển Cloud.

Có vượt quá giới hạn hằng ngày tự đặt trên API không?

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

Bạn có thể kiểm tra hạn mức hằng ngày bằng cách truy cập vào Trang tổng quan về API và dịch vụ trong bảng điều khiển Cloud. Sau khi truy cập vào trang tổng quan này, hãy làm như sau:

Chọn một dự án nếu được 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 khoá API có chế độ hạn chế địa chỉ IP với những dịch vụ web được dùng ở phía máy chủ (chẳng hạn như Geocoding API và các API Dịch vụ web khác). Hầu hết các dịch vụ web này đều có các dịch vụ tương đương trong API Maps JavaScript (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 Maps JavaScript API, bạn cần tạo một khoá API riêng biệt có thể được bảo mật bằng chế độ hạn chế HTTP referrers (xem phần Lấy, thêm và hạn chế khoá API).

Mã lỗi Maps JavaScript API dành cho nhà phát triển và chủ sở hữu trang web

Các bảng sau đây liệt kê các mã lỗi có thể được Maps JavaScript API trả về, kèm theo nội dung mô tả về nguyên nhân và cách bạn có thể khắc phục vấn đề. Để được trợ giúp về cách tìm thông báo lỗi, hãy xem phần kiểm tra lỗi trong trình duyệt.

Lỗi khi tải bản đồ

Nếu bạn gặp lỗi khi tải Maps JavaScript API, vui lòng xem bảng bên dưới để biết nội dung giải thích về mã lỗi.

Mã lỗi Nhắn tin Mô tả

Mã lỗi	Nhắn tin	Mô tả
`NotLoadingAPIFromGoogleMapsError`	Bạn phải tải Maps JavaScript API xuống trực tiếp từ các máy chủ của Google.	Phần tử tập lệnh tải Maps JavaScript API không được đưa vào đúng cách trên trang của bạn. Để API hoạt động chính xác, bạn phải tải API này trực tiếp từ https://maps.googleapis.com. Xem phần Tải Maps JavaScript API.
`TOSViolationMapError`	Trang web này có vẻ vi phạm Điều khoản dịch vụ của Google Maps API. Google Maps API đã bị vô hiệu hoá đối với trang web này.	Ứng dụng của bạn đã bị chặn do không tuân thủ Điều khoản dịch vụ của Google Maps Platform, sau khi chúng tôi gửi cho bạn một số thông báo qua email. Để kháng nghị quyết định chặn và yêu cầu xem xét việc triển khai của bạn, vui lòng hoàn tất biểu mẫu này. Bạn sẽ nhận được phản hồi qua email trong vòng vài ngày làm việc. Nếu bạn có giấy phép sử dụng gói đặc biệt của Google Maps Platform, vui lòng sử dụng thông tin đăng nhập gói đặc biệt của Google Maps Platform để giải quyết lỗi này. Hãy xem hướng dẫn về xác thực gói đặc biệt.
`UnauthorizedURLForClientIdMapError`	URL này không được phép sử dụng Client ID Google Maps mà bạn cung cấp.	Mã ứng dụng Premium Plan hoặc Maps API cho Doanh nghiệp có trong quá trình tải tập lệnh không hợp lệ, đã hết hạn hoặc địa chỉ hiện tại đang tải Maps JavaScript API chưa được thêm vào danh sách URL được uỷ quyền. Xem phần Đăng ký URL được uỷ quyền.

NotLoadingAPIFromGoogleMapsError

Bạn phải tải Maps JavaScript API xuống trực tiếp từ các máy chủ của Google.

Phần tử tập lệnh tải Maps JavaScript API không được đưa vào đúng cách trên trang của bạn. Để API hoạt động chính xác, bạn phải tải API này trực tiếp từ https://maps.googleapis.com.

Xem phần Tải Maps JavaScript API.

TOSViolationMapError

Trang web này có vẻ vi phạm Điều khoản dịch vụ của Google Maps API. Google Maps API đã bị vô hiệu hoá đối với trang web này.

Ứng dụng của bạn đã bị chặn do không tuân thủ Điều khoản dịch vụ của Google Maps Platform, sau khi chúng tôi gửi cho bạn một số thông báo qua email. Để kháng nghị quyết định chặn và yêu cầu xem xét việc triển khai của bạn, vui lòng hoàn tất biểu mẫu này. Bạn sẽ nhận được phản hồi qua email trong vòng vài ngày làm việc.

Nếu bạn có giấy phép sử dụng gói đặc biệt của Google Maps Platform, vui lòng sử dụng thông tin đăng nhập gói đặc biệt của Google Maps Platform để giải quyết lỗi này. Hãy xem hướng dẫn về xác thực gói đặc biệt.

UnauthorizedURLForClientIdMapError

URL này không được phép sử dụng Client ID Google Maps mà bạn cung cấp.

Mã ứng dụng Premium Plan hoặc Maps API cho Doanh nghiệp có trong quá trình tải tập lệnh không hợp lệ, đã hết hạn hoặc địa chỉ hiện tại đang tải Maps JavaScript API chưa được thêm vào danh sách URL được uỷ quyền.

Xem phần Đăng ký URL được uỷ quyền.

Mã lỗi Maps JavaScript API

Nếu bạn thấy lỗi trên Bảng điều khiển JavaScript của Chrome, Bảng điều khiển web của Firefox hoặc bất kỳ công cụ tương đương nào khác trên trình duyệt, vui lòng xem bảng bên dưới để tìm nội dung giải thích về mã lỗi.

Maps JavaScript API trả về cả lỗi và cảnh báo. Lỗi cho biết đã xảy ra vấn đề nghiêm trọng trong khi tải Maps JavaScript API. Trang của bạn không thể tải API đúng cách và API sẽ không hoạt động trên trang đó. Cảnh báo là một thông báo bổ sung về quá trình tải Maps JavaScript API. Cảnh báo này mô tả những lý do có thể gây ra lỗi hoặc đề xuất các vấn đề tiềm ẩn trong mã của bạn khi tải Maps JavaScript API. Nếu bạn chỉ nhận được cảnh báo mà không có lỗi nào, thì API sẽ hoạt động chính xác trên trang đó. Tuy nhiên, bạn cũng nên khắc phục những vấn đề tiềm ẩn này.

Mã lỗi của nhà phát triển	Loại	Mô tả
`ApiNotActivatedMapError`	Lỗi	Maps JavaScript API chưa được kích hoạt trên dự án API của bạn. Bạn có thể cần bật Maps JavaScript API trong phần API trên bảng điều khiển Cloud của Google. Để kích hoạt Maps JavaScript API cho dự án của bạn, hãy nhấp vào nút bên dưới. Tìm hiểu cách thực hiện
`ApiTargetBlockedMapError`	Lỗi	Khoá API này không được phép sử dụng dịch vụ hoặc API này. Vui lòng kiểm tra chế độ cài đặt hạn chế API của khoá API trong Google Cloud Console để đảm bảo rằng tất cả API và dịch vụ bạn cần sử dụng đều được chỉ định chính xác trong danh sách API đã bật. Xem khoá API trong bảng điều khiển Cloud. Để biết thêm thông tin, hãy xem các phương pháp bảo mật tốt nhất cho API.
`DeletedApiProjectMapError`	Lỗi	Dự án API của bạn có thể đã bị xoá khỏi bảng điều khiển Cloud. Vui lòng kiểm tra dự án mà bạn đã tạo khoá API có trong trình tải API JavaScript. Bạn có thể tạo một dự án API mới và nhận một khoá mới trong bảng điều khiển Cloud. Để tạo một dự án mới và nhận khoá API cho dự án đó, hãy nhấp vào nút bên dưới. Tìm hiểu cách thực hiện
`ClientBillingNotEnabledMapError`	Lỗi	Bạn chưa bật tính năng thanh toán cho dự án của mình. Bạn phải bật tính năng Thanh toán trong Dự án trên Google Cloud được liên kết với mã ứng dụng khách này, tại đây.
`BillingNotEnabledMapError`	Lỗi	Bạn chưa bật tính năng thanh toán cho dự án của mình, dẫn đến lỗi này. Bạn phải bật tính năng Thanh toán trong Dự án trên Google Cloud tại đây. Tìm hiểu thêm
`ExpiredKeyMapError`	Lỗi	Khoá API có trong phần tử tập lệnh tải API đã hết hạn hoặc không được hệ thống nhận dạng. Bạn có thể gặp lỗi này sau khi tạo khoá API mới nếu cố gắng sử dụng khoá trước khi hệ thống nhận dạng khoá đó. Vui lòng đợi vài phút rồi thử lại, hoặc bạn có thể cần tạo một khoá API mới trong bảng điều khiển Cloud. Để lấy khoá API, hãy nhấp vào nút bên dưới. Bắt đầu
`InvalidAppCheckTokenMapError`	Lỗi	Mã thông báo Kiểm tra ứng dụng được cung cấp không hợp lệ hoặc đã hết hạn. Lỗi này chỉ có thể xảy ra nếu bạn đang sử dụng quy trình xác minh Kiểm tra ứng dụng. Xem hướng dẫn về quy trình xác minh bằng tính năng Kiểm tra ứng dụng.
`InvalidClientIdMapError`	Lỗi	Để tăng cường tính bảo mật và độ tin cậy của quy trình xác thực, mã ứng dụng khách của Maps Platform sẽ không được dùng nữa kể từ ngày 26 tháng 5 năm 2025 và không thể dùng sau ngày 31 tháng 5 năm 2026. Thay vì sử dụng mã ứng dụng khách, bạn phải sử dụng thông tin đăng nhập Khoá API để xác thực lưu lượng truy cập dịch vụ Google Maps API. Để biết thêm thông tin, hãy xem Hướng dẫn di chuyển mã nhận dạng ứng dụng khách. Làm theo các bước trong hướng dẫn để tạm thời khôi phục mã nhận dạng ứng dụng khách.
`InvalidKeyMapError`	Lỗi	Không tìm thấy khoá API có trong phần tử tập lệnh tải API. Vui lòng đảm bảo bạn đang sử dụng khoá API chính xác. Bạn có thể tạo một khoá API mới trong bảng điều khiển Cloud. Để lấy khoá API, hãy nhấp vào nút bên dưới. Bắt đầu
`MalformedCredentialsMapError`	Lỗi	Ứng dụng của bạn sử dụng một lược đồ URI không được hỗ trợ. Xác minh rằng ứng dụng sử dụng định dạng URI hợp lệ như được xác định trong RFC 3986.
`MissingKeyMapError`	Lỗi	Phần tử tập lệnh tải API bị thiếu tham số xác thực bắt buộc. Nếu đang sử dụng Maps JavaScript API tiêu chuẩn, thì bạn phải sử dụng tham số `key` có khoá API hợp lệ. Để biết thêm thông tin, hãy xem bài viết Bắt đầu sử dụng Google Maps Platform. Nếu là khách hàng sử dụng gói Premium, bạn phải sử dụng tham số `client` có mã ứng dụng hoặc tham số `key` có khoá API hợp lệ. Để biết thêm thông tin, hãy xem hướng dẫn về khoá API và mã ứng dụng. Nếu KHÔNG phải là chủ sở hữu trang web, thì bạn không thể thực hiện bất kỳ bước nào để khắc phục lỗi này. Tuy nhiên, bạn nên thông báo cho chủ sở hữu trang web nếu có thể.
`ProjectDeniedMapError`	Lỗi	Yêu cầu của bạn chưa được hoàn tất. Bạn có thể xem thêm thông tin chi tiết về lỗi này trong bảng điều khiển Cloud. Xem Bảng điều khiển Cloud.
`RefererDeniedMapError`	Lỗi	Ứng dụng của bạn đã bị chặn do không tuân thủ Điều khoản dịch vụ của Google Maps Platform, sau khi chúng tôi gửi cho bạn một số thông báo qua email. Để kháng nghị quyết định chặn và yêu cầu xem xét việc triển khai của bạn, vui lòng hoàn tất biểu mẫu này. Bạn sẽ nhận được phản hồi qua email trong vòng vài ngày làm việc.
`RefererNotAllowedMapError`	Lỗi	URL hiện tại đang tải Maps JavaScript API chưa được thêm vào danh sách các đường liên kết giới thiệu được phép. Vui lòng kiểm tra chế độ cài đặt đường liên kết giới thiệu của khoá API trong bảng điều khiển Cloud. Xem API JavaScript của Maps và Lấy khoá API.
`OverQuotaMapError`	Lỗi	Số lượng yêu cầu đã vượt quá giới hạn sử dụng đối với Maps JavaScript API. Các yêu cầu của ứng dụng sẽ hoạt động trở lại vào lần đặt lại hạn mức hằng ngày tiếp theo. Nếu KHÔNG phải là chủ sở hữu trang web, bạn không thể thực hiện bất kỳ bước nào để khắc phục lỗi này. Tuy nhiên, bạn nên thông báo cho chủ sở hữu trang web nếu có thể. Để biết thêm thông tin, hãy xem hướng dẫn về hạn mức sử dụng. Trang này cũng giải thích cách bạn có thể tăng hạn mức sử dụng.
`ApiProjectMapError`	Lỗi	Không thể phân giải khoá API đã cung cấp hoặc dự án API mà khoá đó được liên kết. Đây có thể là lỗi tạm thời. Nếu thông báo lỗi này vẫn xuất hiện, bạn có thể cần lấy một khoá API mới hoặc tạo một dự án API mới. Để biết thêm thông tin, hãy xem bài viết Bắt đầu sử dụng Google Maps Platform.
`ClientIdLooksLikeCryptoKey`	Cảnh báo	Có thể bạn đã cung cấp một khoá mã hoá trong tham số `client`. Nếu bạn có Gói cao cấp hoặc giấy phép Maps API for Work, vui lòng chỉ định mã ứng dụng của bạn làm tham số `client`. Bạn không cần sử dụng khoá mã hoá cho API JavaScript của Maps. Xem hướng dẫn về mã nhận dạng khách hàng cho khách hàng sử dụng Gói cao cấp và Maps API cho doanh nghiệp.
`ClientIdLooksLikeKey`	Cảnh báo	Có thể bạn đã cung cấp một khoá API trong tham số `client`. Nếu bạn có Gói cao cấp hoặc giấy phép Maps API for Work, vui lòng chỉ định mã ứng dụng của bạn làm tham số `client`. Nếu có Gói cao cấp của Nền tảng Google Maps, bạn có thể sử dụng tham số `client` hoặc tham số `key`. Nếu không có giấy phép nào, bạn phải sử dụng tham số `key` thay vì tham số `client`. Xem hướng dẫn về xác thực gói Premium.
`InvalidChannel`	Cảnh báo	Có thể bạn đã cung cấp một thông số `channel` không hợp lệ. Kênh phải là một chuỗi chữ và số ASCII, có thể bao gồm dấu chấm (.), dấu gạch dưới (_) và dấu gạch nối (-). Vui lòng đảm bảo rằng bạn đang chỉ định một tham số `channel` hợp lệ. Xem phần Báo cáo \| Gói Premium của Google Maps Platform.
`InvalidClientId`	Cảnh báo	Tham số `client` có vẻ không chứa mã ứng dụng chính xác. Mã ứng dụng khách phải bắt đầu bằng "gme-". Xem hướng dẫn về xác thực gói Premium.
`InvalidKey`	Cảnh báo	Khoá API có trong phần tử tập lệnh tải API có vẻ không chính xác. Vui lòng đảm bảo bạn đang sử dụng khoá API chính xác. Bạn có thể tạo một khoá API mới trong bảng điều khiển Cloud. Để lấy khoá API, hãy nhấp vào nút bên dưới. Bắt đầu
`InvalidVersion`	Cảnh báo	Có thể bạn đã cung cấp số phiên bản không chính xác trong phần tử tập lệnh. Vui lòng đảm bảo rằng bạn đang sử dụng đúng số phiên bản. Xem phần Tạo phiên bản \| API JavaScript của Google Maps.
`KeyLooksLikeClientId`	Cảnh báo	Bạn có thể đã cung cấp mã ứng dụng khách dưới dạng tham số `key`. Nếu bạn có Gói cao cấp hoặc giấy phép Maps API for Work, vui lòng chỉ định mã ứng dụng khách của bạn làm tham số `client` thay vì tham số `key`. Nếu có Gói cao cấp của Nền tảng Google Maps, bạn có thể sử dụng tham số `client` hoặc tham số `key`. Nếu không có giấy phép nào, bạn phải sử dụng tham số `key` thay vì tham số `client`. Xem hướng dẫn về xác thực gói Premium.
`KeyLooksLikeCryptoKey`	Cảnh báo	Bạn có thể đã cung cấp một khoá mã hoá hoặc bí mật ký dưới dạng tham số `key`. Nếu bạn có Gói Premium hoặc giấy phép Maps API for Work, vui lòng chỉ định mã ứng dụng của bạn làm tham số `client` và xoá tham số `key` khỏi phần tử tập lệnh. Bạn không cần khoá mã hoá cho Maps JavaScript API. Nếu có Gói cao cấp của Nền tảng Google Maps, bạn có thể sử dụng tham số `client` hoặc tham số `key`. Nếu không có giấy phép nào, bạn có thể lấy khoá API trong bảng điều khiển Cloud. Xem hướng dẫn về Chỉ định mã ứng dụng khi tải API.
`KeyLooksLikeProjectNumber`	Cảnh báo	Có thể bạn đã cung cấp số dự án dưới dạng tham số `key`. Vui lòng đảm bảo bạn đang sử dụng khoá API chính xác. Bạn có thể tạo khoá API mới trong bảng điều khiển Cloud. Tìm hiểu cách lấy khoá API.
`NoApiKeys`	Cảnh báo	Phần tử tập lệnh tải API không có khoá API. Vui lòng đảm bảo bạn thêm một khoá API hợp lệ làm tham số `key`. Bạn có thể tạo một khoá API mới trong bảng điều khiển Cloud. Để lấy khoá API, hãy nhấp vào nút bên dưới để bắt đầu. Bắt đầu Nếu đang tải Maps JavaScript API từ đường dẫn v2 không dùng nữa, bạn sẽ nhận được cảnh báo `NoApiKeys`, ngay cả khi bạn đã chỉ định tham số `key`. Vui lòng xem hướng dẫn nâng cấp từ phiên bản 2 lên phiên bản 3 và di chuyển ứng dụng của bạn sang Maps JavaScript API phiên bản 3.
`RetiredVersion`	Cảnh báo	Có thể bạn đã cung cấp một phiên bản không còn được hỗ trợ trong phần tử tập lệnh. Vui lòng cập nhật ứng dụng để dùng một trong các phiên bản hiện có. Xem phần Tạo phiên bản \| API JavaScript của Google Maps.
`SensorNotRequired`	Cảnh báo	Tham số `sensor` không còn bắt buộc đối với Maps JavaScript API. Thao tác này sẽ không ngăn Maps JavaScript API hoạt động đúng cách, nhưng bạn nên xoá tham số `sensor` khỏi phần tử tập lệnh.
`SignatureNotRequired`	Cảnh báo	Bạn không bắt buộc phải dùng tham số `signature` cho Maps JavaScript API. Thao tác này sẽ không ngăn Maps JavaScript API hoạt động đúng cách, nhưng có thể gây ra các rủi ro về bảo mật. Vui lòng xoá mã này khỏi phần tử tập lệnh.
`SignedInNotSupported`	Cảnh báo	Tham số `signed_in` đã không được dùng nữa và không được hỗ trợ trên phiên bản API JavaScript của Maps mà bạn đang sử dụng. Điều này sẽ không ngăn API JavaScript của Maps hoạt động, nhưng hành vi của ứng dụng có thể thay đổi nếu bạn dựa vào các tính năng đăng nhập.
`UrlAuthenticationCommonError`	Lỗi	Đã xảy ra lỗi không thuộc các danh mục khác trên trang này. Nguyên nhân có thể là do một vấn đề tạm thời. Vui lòng thử lại yêu cầu sau một khoảng thời gian ngắn. Nếu cách đó không giải quyết được vấn đề, vui lòng xem lại hướng dẫn dành cho nhà phát triển để đảm bảo yêu cầu có định dạng phù hợp.

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

Maps JavaScript API ghi thông báo lỗi vào window.console. Phần này giải thích cách bạn có thể kiểm tra đầu ra window.console 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 xem tài liệu dành cho nhà phát triển của trình duyệt đó. Để bạn tham khảo, đây là danh sách các công cụ để kiểm tra đầu ra window.console trong một số trình duyệt khác.

Bảng điều khiển web cho Firefox.
Gỡ lỗi từ xa cho Android.
Web Inspector cho iOS.

Trong Chrome, bạn có thể sử dụng Bảng điều khiển JavaScript để kiểm tra đầu ra window.console như sau.

Để mở Công cụ 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ụ cho nhà phát triển.
Để mở Bảng điều khiển JavaScript, hãy nhấn phím ESC trên bàn phím. Phím ESC sẽ bật/tắt Bảng điều khiển JavaScript. Nếu bạn đóng bảng điều khiển, hãy nhấn lại phím ESC để mở bảng điều khiển.

Nếu có lỗi hoặc cảnh báo xảy ra khi tải Maps JavaScript API, thì các lỗi hoặc cảnh báo đó sẽ xuất hiện dưới dạng một hoặc nhiều dòng trong bảng điều khiển. Thông báo lỗi hoặc cảnh báo có định dạng sau:

Google Maps API error: [ERROR CODE] [Link to API document]
hoặc
Google Maps API warning: [ERROR CODE] [Link to API document]

Bạn có thể kiểm tra bảng mã lỗi ở trên để tìm mã lỗi trong thông báo lỗi. Bạn cũng có thể tìm thấy thông tin chi tiết về thông báo lỗi trong tài liệu API được liên kết từ thông báo.

Lưu ý: Bạn có thể nghe các lỗi xác thực theo phương thức lập trình.

Xử lý các trình duyệt không được hỗ trợ

Đảm bảo rằng phiên bản trình duyệt mà bạn đang sử dụng hiện được Maps JavaScript API hỗ trợ.

Nếu bạn đang phát triển một ứng dụng Windows gốc chạy trong WebView, hãy đảm bảo rằng bạn đang sử dụng WebView2 dựa trên Edge. Các phiên bản WebView trước đây (dựa trên Internet Explorer) không còn được hỗ trợ nữa.

Nếu mã vẫn không hoạt động

Để giúp bạn thiết lập và chạy mã Maps, Brendan Kenny và Mano Marks sẽ chỉ ra một số lỗi thường gặp và cách khắc phục trong video này.

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