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.
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ả |
---|---|---|
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. |
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. |
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.
|
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.
|
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. |
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.
|
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ố 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.
|
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ố Nếu là khách hàng sử dụng Gói Premium, bạn phải
sử dụng thông số 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 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ố 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ố |
InvalidClientId
|
Nhắc nhở |
Có vẻ như tham số 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.
|
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. |
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 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ố 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ố
Để nhận khoá API, hãy nhấp vào nút bên dưới để 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 |
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. |
SensorNotRequired
|
Nhắc nhở |
Tham số |
SignatureNotRequired
|
Nhắc nhở |
Không bắt buộc phải có tham số |
SignedInNotSupported
|
Nhắc nhở |
Tham số |
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ị.
- Xác nhận rằng bạn đã chỉ định
- 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ợ.