Thông báo bảo mật: Chúng tôi đã nhận thấy một vấn đề bảo mật có thể ảnh hưởng đến các trang web sử dụng các thư viện cụ thể của bên thứ ba (bao gồm cả polyfill.io). Vấn đề này đôi khi có thể chuyển hướng khách truy cập khỏi trang web mong muốn mà chủ sở hữu trang web không biết hoặc không cho phép. Nhiều mẫu JavaScript của chúng tôi trước đây đã bao gồm phần khai báo tập lệnh polyfill.io. Chúng tôi đã xoá phương thức này khỏi các mẫu của mình. Nếu đã sử dụng các mẫu JavaScript có chứa nội dung khai báo này, bạn nên xoá nội dung khai báo.

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 JavaScript cho Maps. API JavaScript của Maps ghi lỗi và cảnh báo đến bảng điều khiển JavaScript. Lỗi nhất định điều kiện khác cũng có thể xảy ra, dẫn đến việc màn hình hiển thị bản đồ có hình mờ.

Khoá API và lỗi thanh toán

Khắc phục sự cố

Trong một số trường hợp nhất định, bản đồ tối hoặc "âm" Hình ảnh trong Chế độ xem đường phố, có hình mờ với văn bản "chỉ dành cho mục đích phát triển", có thể được hiển thị. Hành vi này thường cho biết có vấn đề với khoá API hoặc vấn đề về thanh toán. Để sử dụng các sản phẩm trên Nền tảng Google Maps, 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ả yêu cầu phải bao gồm một 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 trên cách 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 đề 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 cho Maps. Dưới đây là một vài cách để kiểm tra xem bạn có đang sử dụng khoá API hay không:

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

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

Dành cho 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 Maps JavaScript API. 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.
```
  <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 bằng cách sử dụng Thẻ DevTools Mạng. Tại đây, bạn sẽ thấy các yêu cầu mạng do trang web của bạn đưa ra. 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 thông số key hay không. 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 phần thiết lập theo hướng dẫn, hãy làm theo hướng dẫn đầy đủ tại bài viết Bắt đầu sử dụng Google Maps Nền tảng.
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 tài khoản thanh toán có được liên kết với dự án của bạn hay không.

Tài khoản thanh toán có liên kết với 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 dùng để tạo khoá API. Cách xác nhận khoá đã 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 xác thực.
Kiểm tra để đảm bảo khoá API bạn đang sử dụng trên trang web của mình có trong danh sách. Nếu trường hợp đó không xảy ra, 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 thể tìm 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 được 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 New Project (Dự án mới) từ danh sách dự án hoặc bằng cách chọn Create Project (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 đăng nhập. Sau đó, hãy nhấp vào Create credentials (Tạo thông tin xác thực) rồi chọn API key (khoá API).

Sau khi xác định được vị trí của dự án 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 mục Thanh toán trong trình đơn bên trái.

Không, tài khoản thanh toán không được liên kết với dự án của tôi.

Chuyển đến trang Bật thanh toán trong Cloud Console rồi thêm tài khoản thanh toán vào dự án. Để biết thêm thông tin, hãy xem Bắt đầu sử dụng Nền tảng Google Maps.

Có, 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.

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

Nếu bạn đã đặt giới hạn hàng ngày cho bất kỳ API nào của mình, điều này thường để 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 giới hạn hằng ngày bằng cách chuyển đến API và Trang tổng quan 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 được nhắc.
Chọn một API trong danh sách, sau đó nhấp vào thẻ Hạn mức.

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

Bạn chỉ có thể sử dụng khoá API bị hạn chế về địa chỉ IP với những dịch vụ web nhằm mục đích sử 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 Maps JavaScript API (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 phải tạo một khoá API riêng có thể được bảo mật bằng quy tắc hạn chế liên kết giới thiệu HTTP (xem Nhận, thêm và hạn chế khoá API).

Mã lỗi API Maps JavaScript 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 trả về bởi API JavaScript của Maps, với nội dung mô tả nguyên nhân và cách bạn có thể khắc phục sự cố. Để được trợ giúp về cách tìm các thông báo lỗi, hãy xem phần trên cách kiểm tra lỗi trong trình duyệt.

Lỗi tải bản đồ

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

Mã lỗi Thông điệp Mô tả

Mã lỗi	Thông điệp	Mô tả
`NotLoadingAPIFromGoogleMapsError`	API JavaScript của Maps phải được tải xuống trực tiếp từ máy chủ.	Phần tử tập lệnh tải API JavaScript của Maps là không được đưa vào chính xác trên trang của bạn. Để API hoạt động đúng cách, nó phải được tải trực tiếp từ https://maps.googleapis.com. Xem Đang tải API JavaScript cho Maps.
`TOSViolationMapError`	Có vẻ như trang web này vi phạm Điều khoản dịch vụ của API Google Maps. API Google Maps đã bị tắt đố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 Nền tảng Google Maps, sau một số thông báo qua email. Cách khiếu nại chặn và 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 Gói cao cấp của Nền tảng Google Maps, vui lòng sử dụng Thông tin đăng nhập vào Gói cao cấp của Nền tảng Google Maps để giải quyết lỗi này. Xem hướng dẫn về Xác thực gói Premium.
`UnauthorizedURLForClientIdMapError`	URL này không được phép sử dụng ID ứng dụng khách Google Maps được cung cấp.	API gói Premium hoặc API Maps for Work client ID trong lượt 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 các URL được uỷ quyền. Xem Đăng ký các URL được uỷ quyền.

NotLoadingAPIFromGoogleMapsError

API JavaScript của Maps phải được tải xuống trực tiếp từ máy chủ.

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

Xem Đang tải API JavaScript cho Maps.

TOSViolationMapError

Có vẻ như trang web này vi phạm Điều khoản dịch vụ của API Google Maps. API Google Maps đã bị tắt đố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 Nền tảng Google Maps, sau một số thông báo qua email. Cách khiếu nại chặn và 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 Gói cao cấp của Nền tảng Google Maps, vui lòng sử dụng Thông tin đăng nhập vào Gói cao cấp của Nền tảng Google Maps để giải quyết lỗi này. Xem hướng dẫn về Xác thực gói Premium.

UnauthorizedURLForClientIdMapError

URL này không được phép sử dụng ID ứng dụng khách Google Maps được cung cấp.

API gói Premium hoặc API Maps for Work client ID trong lượt 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 các URL được uỷ quyền.

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

Mã lỗi API Maps JavaScript

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

API JavaScript của Maps trả về cả lỗi và cảnh báo. Lỗi cho biết sự cố nghiêm trọng đã xảy ra khi tải API JavaScript cho Maps. Trang của bạn không thể tải API chính xác, 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ề việc tải API JavaScript cho Maps. Cảnh báo này mô tả các lý do có thể xảy ra hoặc đề xuất các vấn đề tiềm ẩn trong mã có thể tải API JavaScript cho Maps. Nếu bạn chỉ nhận được cảnh báo mà không có lỗi nào, API sẽ hoạt động chính xác trên trang đó. Tuy nhiên, bạn nên khắc phục các lỗi vấn đề khác.

Mã lỗi của nhà phát triển	Loại	Mô tả
`ApiNotActivatedMapError`	Lỗi	API JavaScript của Maps chưa được kích hoạt trên dự án API của bạn. Bạn có thể cần bật API JavaScript cho Maps trong API trong bảng điều khiển Google Cloud. Để kích hoạt API JavaScript của Maps 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
`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 các hạn chế về API cho khoá API của bạn trong Google Cloud Console để đảm bảo rằng tất cả API và dịch vụ mà bạn cần cần sử dụng được chỉ định chính xác trong danh sách API đã bật. Xem Khoá API trong Cloud Console. Để biết thêm thông tin, hãy xem Các phương pháp hay nhất về bảo mật API.
`DeletedApiProjectMapError`	Lỗi	Dự án API của bạn có thể đã bị xoá khỏi Cloud Console. 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 khoá mới trong Cloud Console. Để 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
`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 trên Google Cloud Dự án đượ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. Điều này gây ra 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 nếu bạn cố gắng sử dụng khoá này trước khi hệ thống nhận dạng được. Đợi một vài phút rồi thử lại, hoặc bạn có thể cần phải tạo khoá API mới trong Cloud Console. Để nhận khoá API, hãy nhấp vào nút bên dưới. Bắt đầu
`InvalidClientIdMapError`	Lỗi	Mã ứng dụng khách trong phần tử tập lệnh tải API không hợp lệ hoặc đã hết hạn. Hãy đảm bảo rằng bạn đang sử dụng mã ứng dụng khách của mình chính xác. Mã ứng dụng khách phải bắt đầu bằng " Microsoft-" tiền tố. Nếu bạn thấy lỗi này ngay cả khi bạn sử dụng chính xác ID ứng dụng khách, ID ứng dụng khách có thể đã hết hạn. Vui lòng liên hệ với Người quản lý Tài khoản Google của bạn. Nếu bạn không có gói Premium hoặc Giấy phép API Maps for Work, bạn cần sử dụng Tham số `key` bằng khoá API thay vì tham số `client`. Xem hướng dẫn về Xác thực gói Premium.
`InvalidKeyMapError`	Lỗi	Khoá API có trong phần tử tập lệnh tải API không đã tìm thấy. Hãy đảm bảo rằng bạn đang sử dụng đúng khoá API. Bạn có thể tạo khoá API mới trong Cloud Console. Để nhận 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 dùng giao thứ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ư xác định trong RFC 3986.
`MissingKeyMapError`	Lỗi	Phần tử tập lệnh tải API thiếu thông số xác thực bắt buộc. Nếu bạn đang sử dụng API Maps JavaScript 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ắt đầu sử dụng Nền tảng Google Maps. Nếu là khách hàng sử dụng Gói Premium, bạn phải sử dụng thông số `client` với mã ứng dụng khách của bạn hoặc `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 khách. Nếu KHÔNG phải là chủ sở hữu trang web, thì bạn không thể làm gì để khắc phục vấn đề 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ể tìm thấy thông tin chi tiết về lỗi trong Bảng điều khiển Cloud. Hãy 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 Nền tảng Google Maps, sau một số thông báo qua email. Cách khiếu nại chặn và 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 tải Maps JavaScript API chưa được thêm vào danh sách đường liên kết giới thiệu được phép. Vui lòng kiểm tra đường liên kết giới thiệu chế độ cài đặt của khoá API trong Cloud Console. Hãy xem API JavaScript của Maps và Tải khoá API.
`OverQuotaMapError`	Lỗi	Số lượng yêu cầu đã vượt quá giới hạn sử dụng dành cho API JavaScript cho Maps. 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ể làm gì để sửa 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 chi tiết, 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ể lên cấp cao hơn hạn mức sử dụng.
`ApiProjectMapError`	Lỗi	Khoá API được cung cấp hoặc dự án API có liên kết với khoá API đó, Không thể giải quyết. Lỗi này có thể chỉ là tạm thời. Nếu thông báo lỗi này bạn có thể cần phải có 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ắt đầu sử dụng Nền tảng Google Maps.
`ClientIdLooksLikeCryptoKey`	Nhắc nhở	Có thể bạn đã cung cấp một khoá mã hoá trong `client` . Nếu bạn dùng gói Premium hoặc Giấy phép API Maps for Work, vui lòng nêu rõ mã ứng dụng khách của bạn làm tham số `client`. Bạn không cần sử dụng khoá mã hoá của bạn cho API JavaScript của Maps. Xem hướng dẫn về khách hàng Mã nhận dạng của Gói cao cấp và Khách hàng của API Maps for Work.
`ClientIdLooksLikeKey`	Nhắc nhở	Có thể bạn đã cung cấp khoá API trong tham số `client`. Nếu bạn dùng gói Premium hoặc Giấy phép API Maps for Work, vui lòng nêu rõ ứng dụng của bạn Mã nhận dạng cho tham số `client`. Nếu bạn có Gói đặc biệt của Nền tảng Google Maps, bạn có thể sử dụng thông số `client` hoặc tham số `key`. Nếu bạn 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`	Nhắc nhở	Bạn có thể đã cung cấp tham số `channel` không hợp lệ. Chiến lược phát hành đĩa đơn kênh phải là chuỗi ký tự chữ-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 chỉ định tham số `channel` hợp lệ. Xem Báo cáo \| Gói cao cấp của Nền tảng Google Maps.
`InvalidClientId`	Nhắc nhở	Có vẻ như tham số `client` không chứa giá trị chính xác mã ứng dụng khách. Mã ứng dụng khách phải bắt đầu bằng "coi-". Xem hướng dẫn về Xác thực gói Premium.
`InvalidKey`	Nhắc nhở	Khoá API có trong phần tử tập lệnh tải API không có vẻ chính xác. Hãy đảm bảo rằng bạn đang sử dụng đúng khoá API. Bạn có thể tạo khoá API mới trong Cloud Console. Để nhận khoá API, hãy nhấp vào nút bên dưới. Bắt đầu
`InvalidVersion`	Nhắc nhở	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 của mình. Hãy đảm bảo rằng bạn đang sử dụng số phiên bản chính xác. Xem Tạo phiên bản \| API JavaScript của Google Maps.
`KeyLooksLikeClientId`	Nhắc nhở	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 Premium hoặc Giấy phép API Maps for Work, vui lòng nêu rõ ID ứng dụng khách của bạn làm Tham số `client` thay vì tham số `key`. Nếu bạn có Gói đặc biệt của Nền tảng Google Maps, bạn có thể sử dụng thông số `client` hoặc tham số `key`. Nếu bạn 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`	Nhắc nhở	Có thể bạn đã cung cấp một khoá mã hoá hoặc khoá bí mật ký làm `key` . Nếu bạn dùng gói Premium hoặc Giấy phép API Maps for Work, vui lòng nêu rõ mã ứng dụng khách của bạn dưới dạng tham số `client` và xoá tham số `key` khỏi phần tử tập lệnh của bạn. Khoá mã hoá là không bắt buộc đối với API JavaScript của Maps. Nếu bạn có Gói đặc biệt của Nền tảng Google Maps, bạn có thể sử dụng thông số `client` hoặc tham số `key`. Nếu chưa có giấy phép nào, bạn có thể nhận khoá API trong Cloud Console. Xem hướng dẫn về Chỉ định một mã ứng dụng khách khi tải API.
`KeyLooksLikeProjectNumber`	Nhắc nhở	Có thể bạn đã cung cấp số dự án dưới dạng tham số `key`. Hãy đảm bảo rằng bạn đang sử dụng đúng khoá API. Bạn có thể tạo một Khoá API trong Cloud Console. Tìm hiểu cách lấy khoá API.
`NoApiKeys`	Nhắc nhở	Phần tử tập lệnh tải API không có khoá API. Hãy đảm bảo rằng bạn thêm khoá API hợp lệ làm tham số `key`. Bạn có thể tạo khoá API mới trong Cloud Console. Để nhận khoá API, hãy nhấp vào nút bên dưới để bắt đầu. Bắt đầu Nếu bạn đang tải Maps JavaScript API từ phiên bản 2 không được dùng nữa path, bạn sẽ nhận được cảnh báo `NoApiKeys`, ngay cả khi bạn đã chỉ định tham số `key`. Vui lòng kiểm tra Hướng dẫn nâng cấp 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 v3.
`RetiredVersion`	Nhắc nhở	Có thể bạn đã cung cấp một phiên bản đã ngừng hoạt động trong phần tử tập lệnh của mình. Vui lòng cập nhật ứng dụng của bạn để sử dụng một trong các phiên bản có sẵn. Xem Tạo phiên bản \| API JavaScript của Google Maps.
`SensorNotRequired`	Nhắc nhở	Tham số `sensor` không còn cần thiết cho API JavaScript cho Maps. Việc này sẽ không ngăn API Maps JavaScript không hoạt động chính xác, nhưng chúng tôi khuyên bạn rằng bạn xoá tham số `sensor` khỏi phần tử của tập lệnh.
`SignatureNotRequired`	Nhắc nhở	Không bắt buộc phải có tham số `signature` cho API JavaScript cho Maps. Việc này sẽ không ngăn API JavaScript của Maps không hoạt động đúng cách, nhưng có thể gây ra rủi ro bảo mật. Vui lòng xoá phương diện/chỉ số đó khỏi phần tử tập lệnh của bạn.
`SignedInNotSupported`	Nhắc nhở	Tham số `signed_in` không được dùng nữa và không được hỗ trợ trên phiên bản này của API Maps JavaScript mà bạn đang sử dụng. Việc này sẽ không ngăn API JavaScript của Maps không 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 dành cho người dùng đã đăng nhập.
`UrlAuthenticationCommonError`	Lỗi	Đã xảy ra lỗi không phù hợp với các danh mục khác trên . Việc này có thể là do một sự cố tạm thời gây ra. Vui lòng thử lại yêu cầu của bạn sau một khoảng thời gian chờ 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 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 của bạn

API JavaScript của Maps 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 của bạn, vui lòng xem tài liệu dành cho nhà phát triển về trình duyệt của bạn. Dành cho tham chiếu, đây là danh sách 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 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 đầu ra window.console 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, nhấn phím ESC trên bàn phím của bạn. 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, nhấn phím ESC lần nữa để mở.

Nếu xảy ra lỗi hoặc cảnh báo khi tải API JavaScript của Maps, chúng xuất hiện dưới dạng một hoặc nhiều dòng trong Google Play. Thông báo lỗi hoặc cảnh báo có định dạng như 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ể xem 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ề trong tài liệu API được liên kết từ thông báo.

Lưu ý:Bạn có thể theo dõi 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 bạn đang sử dụng là hiện được hỗ trợ bởi API JavaScript cho Maps.

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 sử dụng dựa trên WebView2 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ã của bạn vẫn không hoạt động

Brendan Kenny và Mano Marks chỉ ra rằng để giúp bạn thiết lập và chạy mã bản đồ 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 có phân biệt chữ hoa chữ thường ngôn ngữ.
Kiểm tra các khái niệm cơ bản - một số vấn đề phổ biến nhất xảy ra với tạo bản đồ ban đầu. Chẳng hạn như:
- Xác nhận rằng bạn đã chỉ định zoom và center cơ sở lưu trú trong bản đồ của bạn .
- Đảm bảo rằng bạn đã khai báo phần tử div trong đó 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 với chiều cao bằng 0 và do đó không hiển thị.
Hãy tham khảo ví dụ của chúng tôi về tham chiếu triển khai.
Sử dụng trình gỡ lỗi JavaScript để giúp xác định sự cố, chẳng hạn như sự cố hiện có trong Chrome Công cụ cho nhà phát triển. 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 Nhóm câu hỏi Tràn. Hướng dẫn về cách đăng câu hỏi hay trên trang Hỗ trợ.