Câu hỏi thường gặp về Nền tảng Google Maps

Bắt đầu

Hiểu rõ điều khoản dịch vụ

Hạn mức sử dụng và việc thanh toán

Sử dụng Nền tảng Google Maps

Lỗi và cách khắc phục

Dịch vụ của Nền tảng Google Maps

API JavaScript cho Maps

Google Maps SDK cho iOS

Google Maps SDK dành cho Android

Ký URL

Bắt đầu

Nền tảng Google Maps là gì?

Nền tảng Google Maps là một tập hợp các API và SDK cho phép nhà phát triển nhúng Google Maps vào các ứng dụng di động và trang web, hoặc truy xuất dữ liệu từ Google Maps. Có một số sản phẩm. Tuỳ thuộc vào nhu cầu của mình, bạn có thể sử dụng một hoặc kết hợp các API và SDK sau:

Maps:

Tuyến đường:

Địa điểm:

Môi trường:

Làm cách nào để bắt đầu sử dụng Nền tảng Google Maps?

Hãy xem bài viết Bắt đầu sử dụng Nền tảng Google Maps.

Tôi cần API nào?

Để được trợ giúp tìm API phù hợp dựa trên các yêu cầu về chức năng, hãy xem Capabilities Explorer (Công cụ khám phá các chức năng).

Làm cách nào để bắt đầu sử dụng các API trên trang web của tôi?

Hãy xem phần Tổng quan, Nhà phát triển và Bắt đầu để biết hướng dẫn về API hoặc SDK cụ thể mà bạn quan tâm. Ví dụ: hãy xem hướng dẫn về SDK Maps dành cho Android hoặc API JavaScript của Maps.

Nền tảng Google Maps hỗ trợ những quốc gia nào?

Nhóm Google Maps liên tục cung cấp dữ liệu bản đồ mới và mở rộng phạm vi cung cấp trên toàn cầu. Hãy tham khảo dữ liệu về phạm vi cung cấp của Google Maps để biết thông tin mới nhất về phạm vi cung cấp. Bạn có thể lọc dữ liệu bằng hộp bộ lọc ở đầu trang. Dữ liệu về phạm vi cung cấp có thể thay đổi nếu thoả thuận cấp phép với nhà cung cấp dữ liệu thay đổi.

Xem thêm:

Tôi có thể đặt Google Maps trên trang web của mình mà không cần sử dụng các sản phẩm của Nền tảng Google Maps không?

Có. Google Maps hiện cho phép nhúng bản đồ mà bạn đang xem vào trang web hoặc blog của mình mà không cần lập trình hay sử dụng Nền tảng Google Maps. Bạn có thể xem thêm thông tin tại đây.

Làm cách nào để phân phối các ứng dụng Maps trên thiết bị di động?

Để tích hợp bản đồ vào một ứng dụng Android, hãy sử dụng SDK Bản đồ dành cho Android.

Để tích hợp bản đồ vào một ứng dụng iOS, hãy sử dụng SDK Maps dành cho iOS.

Maps JavaScript API được phát triển để phục vụ các thiết bị di động và phù hợp với các ứng dụng trình duyệt nhắm đến cả máy tính và những thiết bị có trình duyệt web với chế độ triển khai JavaScript đầy đủ, chẳng hạn như Apple iPhone.

Đối với những ứng dụng nhắm đến các thiết bị không phù hợp để sử dụng Maps JavaScript API, Maps Static API sẽ phân phối hình ảnh bản đồ ở định dạng GIF, JPG và PNG, bao gồm cả điểm đánh dấu và đường nhiều đoạn. Xin lưu ý rằng việc sử dụng Maps Static API bên ngoài các ứng dụng dựa trên trình duyệt yêu cầu hình ảnh bản đồ phải được liên kết với Google Maps.

API JavaScript của Maps và Maps Embed API hỗ trợ trình duyệt web nào?

Maps JavaScript API và Maps Embed API hỗ trợ các trình duyệt web sau:

Máy tính
  • Phiên bản hiện tại của Microsoft Edge (Windows), ngoại trừ chế độ IE.
  • Hai phiên bản chính ổn định mới nhất của Firefox (Windows, macOS, Linux).
  • Hai phiên bản chính ổn định mới nhất của Chrome (Windows, macOS, Linux).
  • Hai phiên bản chính ổn định mới nhất của Safari (macOS).
Android
  • Phiên bản Chrome hiện tại trên Android 4.1 trở lên.
  • Chrome WebView trên Android 4.4 trở lên.
iOS
  • Mobile Safari trên các phiên bản chính hiện tại và trước đó của iOS.
  • UIWebView và WKWebView trên các phiên bản chính hiện tại và trước đó của iOS.
  • Phiên bản Chrome hiện tại dành cho iOS.
Tôi có thể in bản đồ từ Maps JavaScript API không?

Không hỗ trợ in từ Maps JavaScript API. Điều này là do khả năng hỗ trợ in không nhất quán giữa các trình duyệt thường dùng.

Làm cách nào để nhận được thông báo khi có thay đổi đối với các sản phẩm của Google Maps Platform?

Bạn nên đăng ký theo dõi Blog của Nền tảng Google Maps để nhận tin tức cập nhật về nhiều sản phẩm của Google Geo dành cho nhà phát triển.

Làm cách nào để liên hệ với nhóm hỗ trợ kỹ thuật?

Hãy xem phần Tài nguyên và dịch vụ hỗ trợ của Google Maps Platform để biết thông tin về các lựa chọn hỗ trợ hiện có.

Khi nào thì có dịch vụ hỗ trợ kỹ thuật?
Nhóm hỗ trợ hoạt động 24/5 (các ngày trong tuần từ 9 giờ sáng thứ Hai theo giờ Tokyo đến 5 giờ chiều thứ Sáu theo giờ Thái Bình Dương), trừ các ngày lễ trong khu vực đối với các vấn đề "không sử dụng được dịch vụ".
Làm cách nào để lấy lại quyền truy cập vào Tài khoản Google của tôi?

Nếu mất quyền truy cập vào Tài khoản Google (ví dụ: [email protected] hoặc [email protected]), bạn có thể thử khôi phục quyền truy cập vào tài khoản bằng cách truy xuất hoặc đặt lại mật khẩu. Hãy xem bài viết Cách khôi phục Tài khoản Google hoặc Gmail trong phần Trợ giúp về Tài khoản Google.

Làm cách nào để khôi phục quyền truy cập vào một dự án cụ thể?

Nếu mất quyền truy cập vào dự án mà bạn quản lý việc triển khai Nền tảng Google Maps, bạn có thể thử khôi phục quyền truy cập đó.

Nếu bạn có quyền truy cập vào Tài khoản Google được liên kết với dự án của mình:

Nếu bạn không có quyền truy cập vào Tài khoản Google liên kết với dự án của mình:

Tôi có thể sử dụng Maps và Places SDK cho iOS trên máy Mac dựa trên Arm không?

Bạn có thể phát triển trên máy Mac mới dựa trên Arm, tuy nhiên, bạn cần tạo và chạy trên một thiết bị iOS thực. Đây là một hạn chế tạm thời trong khi chúng tôi xem xét việc bổ sung thêm tính năng hỗ trợ để phát triển trên trình mô phỏng.

Hiểu rõ điều khoản dịch vụ

Điều khoản dịch vụ của các sản phẩm thuộc Nền tảng Google Maps là gì?

Điều khoản dịch vụ của Nền tảng Google Maps có tại:

https://cloud.google.com/maps-platform/terms

Trang web của tôi có đáp ứng Điều khoản dịch vụ của Nền tảng Google Maps không?

Bạn có thể sử dụng Nền tảng Google Maps trong các ứng dụng của mình miễn là trang web của bạn đáp ứng Điều khoản dịch vụ của Nền tảng Google Maps.

Tuy nhiên, có một số trường hợp sử dụng Google Maps Platform mà chúng tôi không muốn thấy. Ví dụ: bản đồ xác định những nơi mua bán thuốc bất hợp pháp trong một thành phố hoặc bất kỳ hoạt động bất hợp pháp nào khác. Chúng tôi cũng tôn trọng quyền riêng tư của mọi người, vì vậy, bạn không được sử dụng Nền tảng Google Maps để xác định thông tin riêng tư về cá nhân.

Bạn nên tự mình tìm hiểu để xác định xem ứng dụng của bạn có tuân thủ Điều khoản dịch vụ của Google Maps Platform hay không trước khi phát triển và ra mắt ứng dụng. Các kỹ sư của Google chỉ có thể hỗ trợ kỹ thuật và không đủ trình độ để tư vấn pháp lý. Google giữ quyền tạm ngưng hoặc chấm dứt quyền sử dụng dịch vụ của bạn bất cứ lúc nào, vì vậy, hãy đọc kỹ Điều khoản dành cho các API của Maps.

Tôi có thể truy cập trực tiếp vào các ô bản đồ và hình ảnh vệ tinh không?

Bạn không được truy cập vào các ô bản đồ hoặc hình ảnh vệ tinh thông qua bất kỳ cơ chế nào ngoài Nền tảng Google Maps (chẳng hạn như việc tạo API lập bản đồ của riêng bạn hoặc sử dụng tập lệnh tải ô xuống hàng loạt). Ứng dụng của bạn sẽ bị chặn truy cập vào các ô nếu ứng dụng truy cập vào các ô đó bên ngoài Nền tảng Google Maps. Hãy xem Điều khoản dịch vụ của Nền tảng Google Maps để biết thêm thông tin chi tiết.

Tôi có thể sử dụng các sản phẩm của Nền tảng Google Maps cho các ứng dụng theo dõi không?

Không có hạn chế nào đối với việc hiển thị dữ liệu theo thời gian thực (theo dõi) bằng các sản phẩm của Nền tảng Google Maps, miễn là ứng dụng tuân thủ Điều khoản dịch vụ của Nền tảng Google Maps.

Tôi có thể sử dụng Google Maps trong ứng dụng không phải ứng dụng web của mình không?

Có, giờ đây, bạn có thể sử dụng các sản phẩm của Nền tảng Google Maps trong các ứng dụng không phải ứng dụng web, miễn là các sản phẩm đó tuân thủ những quy định hạn chế khác trong Điều khoản dịch vụ của Nền tảng Google Maps.

Maps JavaScript API chỉ được hỗ trợ khi chạy trong một trong các trình duyệt được hỗ trợ.

Tôi có thể sử dụng các sản phẩm của Nền tảng Google Maps trên một trang web được bảo vệ bằng mật khẩu không?

Có, bạn có thể sử dụng các dịch vụ Google Maps, Tuyến đường, Địa điểm và Môi trường với các ứng dụng có quyền truy cập riêng tư. Hãy xem Điều khoản dịch vụ của Nền tảng Google Maps để biết thêm thông tin chi tiết.

Tôi có thể tạo một ứng dụng có chứa dữ liệu của Google Maps Platform trong một tài liệu không?

Nếu ứng dụng của bạn tạo ra một tài liệu (dưới dạng điện tử hoặc bản in), thì không được đưa dữ liệu nào từ Google Maps Platform (kể cả hình ảnh) vào tài liệu đó. Hãy xem phần "Không được trích xuất dữ liệu" trong Điều khoản dịch vụ của Nền tảng Google Maps để biết thêm thông tin.

Làm cách nào để chọn không đưa nội dung của tôi vào kết quả tìm kiếm trên Google?

Chúng tôi không còn thu thập dữ liệu này nữa. Việc sử dụng tham số indexing không còn được dùng và không có hiệu lực. Bạn không cần phải chọn không sử dụng một cách rõ ràng nữa, nhưng bạn nên xoá thông số này vào thời điểm sớm nhất có thể.

Để xoá trang hoặc trang web của bạn khỏi kết quả tìm kiếm, hãy làm theo hướng dẫn trong trung tâm trợ giúp của chúng tôi.

Tôi có thể tạo hình ảnh bản đồ bằng Maps Static API mà tôi lưu trữ và phân phát từ trang web của mình không?

Bạn không được lưu trữ và phân phát bản sao của hình ảnh được tạo bằng Maps Static API trên trang web của mình. Tất cả các trang web yêu cầu hình ảnh tĩnh phải liên kết thuộc tính src của thẻ img HTML hoặc thuộc tính background-image CSS của thẻ div HTML trực tiếp với Maps Static API để tất cả hình ảnh bản đồ đều xuất hiện trong nội dung HTML của trang web và được Google phân phát trực tiếp cho người dùng cuối.

Hạn mức sử dụng và việc thanh toán

Làm cách nào để thiết lập thông tin thanh toán cho dự án của tôi?
Xem phần Bắt đầu sử dụng Nền tảng Google Maps.
Khách hàng sử dụng Bậc miễn phí của Google Cloud có thể nâng cấp lên tài khoản trả phí bằng cách nào?
Chương trình Gói miễn phí của Google Cloud cung cấp cho khách hàng bản dùng thử miễn phí với khoản tín dụng 300 USD để sử dụng với bất kỳ dịch vụ nào của Google Cloud, kể cả các API của Google Maps Platform (GMP). Khi thời gian dùng thử miễn phí kết thúc, bạn phải nâng cấp lên tài khoản có tính phí để tiếp tục sử dụng các dịch vụ này. Để nâng cấp lên tài khoản trả phí, hãy truy cập vào Cloud Console.
Nền tảng Google Maps có hạn mức sử dụng không?

Không có giới hạn tối đa hằng ngày về số lượng yêu cầu bạn có thể gửi đến các sản phẩm của Google Maps Platform và giới hạn sử dụng duy nhất là liên quan đến số lượng truy vấn tối đa mỗi phút (QPM).

Bảng sau đây cho biết hạn mức sử dụng cho từng API. Bạn có thể xem và sửa đổi hạn mức trong Cloud Console.

API Hạn mức sử dụng
Xác thực địa chỉ 6.000 QPM
Chế độ xem từ trên không: Video tra cứu 180 QPM và 100.000 QPD
Chế độ xem từ trên không: Kết xuất video 100 QPM và 100 QPD
Chất lượng không khí 6.000 QPM
Maps JavaScript API: Bản đồ 3D 30.000 QPM
Maps JavaScript API: Dynamic Maps 30.000 QPM
Độ cao 6.000 QPM
Mã hoá địa lý 3.000 QPM
Vị trí địa lý 6.000 QPM
Map Tiles API: Ô bản đồ 2D 6.000 QPM và 15.000 QPD
Map Tiles API: Ô Chế độ xem phố 6.000 QPM và 15.000 QPD
Map Tiles API: Ô 3D ảnh thực tế 12.000 QPM và 10.000 yêu cầu gốc mỗi ngày.
Điều hướng: Đặt yêu cầu về đích đến 30.000 QPM
Địa điểm 6.000 QPM
Places Aggregate 1.200 QPM
Phấn hoa 6.000 QPM
Đường 30.000 QPM
Tuyến đường: Tính toán tuyến đường 3.000 QPM
Tuyến đường: Tính toán ma trận tuyến đường 3.000 EPM
Năng lượng mặt trời 600 QPM
Bản đồ tĩnh 30.000 QPM
API hình ảnh chế độ xem đường phố 30.000 QPM
Múi giờ 30.000 QPM
Thời tiết 6.000 QPM

Để quản lý chi tiêu, bạn có thể giám sát mức sử dụng APIđặt hạn mức hằng ngày cho tất cả các yêu cầu đối với mọi API có tính phí.

Bạn phải triển khai các sản phẩm của Nền tảng Google Maps theo tiêu chuẩn Điều khoản dịch vụ của Nền tảng Google Maps.

Chi phí sử dụng được tính như thế nào?

Để biết thông tin tổng quan về giá của các sản phẩm trên Google Maps Platform, hãy xem bảng giá.

Để tìm hiểu thêm về cách tính phí API của Nền tảng Google Maps, hãy xem Thông tin tổng quan về việc tính phí và định giá của Nền tảng Google Maps.

Số lượt tải bản đồ được tính như thế nào trên Nền tảng Google Maps?

Một lần tải bản đồ sẽ bị tính phí khi xảy ra bất kỳ trường hợp nào sau đây:

  • Một trang web hoặc ứng dụng hiển thị bản đồ bằng Maps JavaScript API.
  • Một ứng dụng yêu cầu một hình ảnh bản đồ duy nhất từ Maps Static API.

Ảnh toàn cảnh trong Chế độ xem đường phố được tính phí riêng biệt với lượt tải bản đồ:

  • Ảnh toàn cảnh tĩnh trong Chế độ xem đường phố được tính phí cho mỗi yêu cầu gửi đến Street View Static API để nhúng ảnh toàn cảnh tĩnh (không tương tác) trong Chế độ xem đường phố.
  • Ảnh toàn cảnh linh động trong Chế độ xem đường phố được tính phí cho mỗi lần tạo một đối tượng ảnh toàn cảnh trong ứng dụng Maps JavaScript API, Maps SDK dành cho Android hoặc Maps SDK dành cho iOS.

Sau khi một trang web hoặc ứng dụng tải bản đồ, hình ảnh bản đồ tĩnh hoặc ảnh toàn cảnh Chế độ xem đường phố, mọi hoạt động tương tác của người dùng với bản đồ, chẳng hạn như thao tác xoay, thu phóng hoặc chuyển đổi lớp bản đồ, đều không tạo thêm lượt tải bản đồ hoặc ảnh hưởng đến hạn mức sử dụng.

Việc thêm một điểm đánh dấu sẽ không tạo thêm lượt tải bản đồ, nhưng có thể phát sinh các khoản phí liên quan đến cách xác định vị trí của ghim (chẳng hạn như tải hoặc tải lại lớp google.maps.Map()).

Làm cách nào để theo dõi mức sử dụng của tôi?

Bạn có thể theo dõi mức sử dụng của từng API trong Google Cloud Console.

  1. Chọn dự án có chứa API mà bạn muốn xem xét.
  2. Trong danh sách API trên Trang tổng quan, hãy nhấp vào tên của API.
  3. Ở gần đầu trang, hãy nhấp vào Chỉ số hoặc Hạn mức.

Để xem báo cáo lưu lượng truy cập và thông tin thanh toán cho toàn bộ dự án, hãy làm theo các bước sau:

  1. Nếu bạn chưa làm, hãy thiết lập thông tin thanh toán.
  2. Chuyển đến trang thanh toán trên Cloud Console.
  3. Chọn một dự án.
  4. Trong thanh bên trái, hãy nhấp vào Báo cáo. Sử dụng bộ lọc trên thanh bên phải để xem báo cáo về tài khoản thanh toán của bạn.

Để tìm hiểu thêm, hãy xem Báo cáo của Nền tảng Google Maps cũng như Hoạt động giám sát Nền tảng Google MapsĐặt hạn mức.

Điều gì xảy ra nếu tôi vượt quá giới hạn tốc độ yêu cầu (QPM)?

Nếu bạn vượt quá giới hạn QPM của một sản phẩm cụ thể trên Nền tảng Google Maps, thì API sẽ trả về một thông báo lỗi. Nếu bạn liên tục vượt quá các giới hạn này, thì quyền truy cập của bạn vào API có thể tạm thời bị chặn.

Nếu bạn vượt quá giới hạn QPM của yêu cầu hoặc sử dụng dịch vụ theo cách khác, các yêu cầu sẽ trả về một thông báo lỗi cụ thể. Nếu bạn tiếp tục vượt quá hạn mức, thì bạn có thể bị chặn truy cập vào Nền tảng Google Maps.

Lưu ý: Các API dịch vụ web sau đây có dịch vụ phía máy khách tương đương trong Maps JavaScript API: Độ cao, Mã hoá địa lý.

Đã vượt quá hạn mức sử dụng

Nếu vượt quá hạn mức sử dụng, bạn sẽ nhận được mã trạng thái OVER_QUERY_LIMIT làm phản hồi.

Thông báo này có nghĩa là dịch vụ web đã ngừng cung cấp các phản hồi thông thường và chuyển sang chỉ trả về mã trạng thái OVER_QUERY_LIMIT cho đến khi được phép sử dụng lại. Trường hợp này có thể xảy ra trong vòng vài giây, nếu bạn nhận được lỗi do ứng dụng của bạn gửi quá nhiều yêu cầu mỗi phút.

Nếu bạn thường xuyên vượt quá hạn mức sử dụng QPM, hãy cân nhắc giảm mức sử dụng bằng cách tối ưu hoá các ứng dụng để sử dụng các sản phẩm của Nền tảng Google Maps hiệu quả hơn hoặc yêu cầu tăng hạn mức. Hãy xem Hướng dẫn tối ưu hoá để biết thêm thông tin.

Trang web của tôi có nhiều lưu lượng truy cập. Tôi có thể sử dụng các sản phẩm của Nền tảng Google Maps không?

Có. Tuy nhiên, bạn nên tìm hiểu về hạn mức sử dụng cho mọi Nền tảng Google Maps mà ứng dụng của bạn dựa vào.

Sau khi bạn có một tài khoản thanh toán, nếu bạn vượt quá hạn mức sử dụng miễn phí và không có phương thức thanh toán hợp lệ trong tài khoản thanh toán (chẳng hạn như thẻ tín dụng hoặc chuyển khoản ngân hàng), thì API sẽ ngừng hoạt động cho đến khi bạn thêm một phương thức thanh toán hợp lệ.

Mức sử dụng sẽ được tính và tính phí như thế nào?

Mức sử dụng được tính vào cuối mỗi ngày và được định giá như trong bảng giá. Vào cuối mỗi tháng, tổng mức sử dụng sẽ được tính vào phương thức thanh toán liên kết với tài khoản thanh toán của bạn. Để biết thêm thông tin, hãy xem phần Thanh toán cho Nền tảng Google Maps.

Chi phí sử dụng Nền tảng Google Maps là bao nhiêu?

Hãy xem bảng giá để biết thông tin tổng quan về chi phí cho mỗi API. Nếu ứng dụng của bạn tạo ra các yêu cầu hoặc số lượng tải bản đồ lên đến hạn mức sử dụng miễn phí cho một tháng nhất định, thì bạn sẽ không bị tính phí cho mức sử dụng đó. Mức sử dụng vượt quá hạn mức sử dụng miễn phí sẽ được tính phí vào tài khoản thanh toán của bạn. Để biết thêm thông tin, hãy xem phần Thanh toán cho Nền tảng Google Maps.

Giá có được cung cấp bằng các đơn vị tiền tệ khác không?

Các đơn vị tiền tệ khác có thể có trong bảng điều khiển. Khi bạn chọn một đơn vị tiền tệ khác, tỷ giá sẽ được chuyển đổi từ giá trị tương đương bằng USD được nêu trong Bảng giá của chúng tôi.

Tôi đã thiết lập thông tin thanh toán. Làm cách nào để xem hoá đơn?

Google sẽ tính phí bạn vào đầu mỗi tháng cho hoạt động của tháng trước bằng phương thức thanh toán mà bạn đã chỉ định. Để biết thông tin chi tiết về hoá đơn, hãy xem phần Thanh toán cho Google Maps Platform.

Tài nguyên khác:

Làm thế nào để tránh được hóa đơn cao nếu mức sử dụng của tôi tăng bất ngờ?

Google Maps Platform cung cấp các cách để đặt giới hạn yêu cầu hằng ngày và đặt giới hạn tối đa có thể tính phí hằng ngày. Bạn có thể giới hạn mức sử dụng tối đa hằng ngày để tránh trường hợp mức sử dụng tăng đột ngột. Bạn cũng có thể đặt cảnh báo về ngân sách để nhận thông báo qua email khi các khoản phí trong tài khoản thanh toán đạt đến một ngưỡng mà bạn đặt.

Giới hạn mức tối đa có thể tính phí hằng ngày:

Để tránh hoá đơn lớn, bạn có thể đặt hạn mức sử dụng hằng ngày để tránh trường hợp mức sử dụng tăng đột ngột. Bạn có thể thay đổi hạn mức này trong bảng điều khiển Cloud

Đặt và quản lý thông báo về ngân sách:

Thiết lập cảnh báo về ngân sách để gửi thông báo qua email cho quản trị viên thanh toán khi các khoản phí trong tài khoản thanh toán đạt đến một ngưỡng mà bạn đặt. Quản trị viên thanh toán sẽ nhận được thông báo qua email khi các khoản phí ước tính trên tài khoản thanh toán vượt quá 50%, 90% và 100% ngưỡng.

Tôi nhận được thông báo cho biết dự án của tôi được liên kết với "Tài khoản chuyển đổi Google Maps Platform", nhưng tôi không có quyền truy cập vào tài khoản đó. Tôi cần làm gì?

"Tài khoản chuyển đổi Nền tảng Google Maps" được tạo ra để giúp một số khách hàng chuyển sang gói định giá trả theo mức sử dụng. Tài khoản chuyển đổi này cho phép Google cung cấp cho những khách hàng này một khoản tín dụng dùng một lần để họ có thể tiếp tục sử dụng Nền tảng Google Maps cho đến giới hạn của cấp miễn phí. Khi vượt quá hạn mức này, tài khoản thanh toán sẽ ngừng hoạt động và bạn sẽ mất quyền truy cập vào dịch vụ. Để tránh bị gián đoạn dịch vụ, bạn nên thiết lập tài khoản thanh toán của riêng mình và tiếp tục tận hưởng hạn mức sử dụng miễn phí hằng tháng. Cách thay đổi tài khoản thanh toán cho dự án của bạn:

  1. Tạo tài khoản thanh toán mới (nếu đã có tài khoản thanh toán, bạn có thể bỏ qua bước này).
  2. Liên kết tài khoản thanh toán với dự án của bạn.
Tại sao hạn mức của tôi được đặt thành 1 yêu cầu mỗi ngày? Làm cách nào để tăng hạn mức này?

Nếu bạn chưa tạo và liên kết tài khoản thanh toán với dự án của mình, thì các API Nền tảng Maps sẽ bị giới hạn ở mức 1 yêu cầu mỗi ngày. Bạn có thể nhận được hạn mức cao hơn bằng cách tạo và đính kèm một tài khoản thanh toán. Để thực hiện việc này, hãy xem bài viết Bắt đầu sử dụng Nền tảng Google Maps.

Sau khi bạn tạo và đính kèm một tài khoản thanh toán, hạn mức sử dụng hằng ngày sẽ bị xoá. Bạn có thể quyết định đặt hạn mức để ngăn chặn mức chi tiêu ngoài dự kiến trong Cloud Console.

Tôi nhận được thông báo về lỗi vi phạm liên quan đến việc thanh toán. Làm cách nào để giải quyết vấn đề này?

Bạn nhận được thông báo này vì Google xác định rằng tài khoản của bạn đang sử dụng nhiều tài khoản thanh toán. Đây là hành vi vi phạm các điều khoản của Google, theo định nghĩa trong Điều khoản dịch vụ của Nền tảng Google Maps. Theo các điều khoản này, bạn không được phép tạo nhiều tài khoản thanh toán. Để tìm hiểu thêm, hãy xem Câu hỏi thường gặp về lỗi vi phạm đối với tài khoản thanh toán.

Sử dụng Nền tảng Google Maps

Tôi nên sử dụng khoá hoặc thông tin đăng nhập nào cho các sản phẩm khác nhau của Maps?

Mỗi khi sử dụng các sản phẩm của Google Maps Platform, bạn phải thêm một khoá API để xác thực yêu cầu của mình. Google Maps Platform có sẵn cho các ứng dụng Android, iOS hoặc Web và cho các dịch vụ web HTTP.

Khoá API:

  • Khoá API là một giá trị nhận dạng riêng biệt mà bạn tạo bằng Cloud Console.
  • Ví dụ về cách tải một API bằng khoá: &key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo

Chữ ký số:

  • Chữ ký số được tạo bằng một khoá bí mật để ký URL do Google cung cấp cho bạn. Chữ ký số được dùng với Maps Static API và Street View Static API.

Các quy định hạn chế:

  • Bạn không bắt buộc phải đặt các quy tắc hạn chế đối với khoá API, nhưng bạn nên hạn chế tất cả khoá API để tăng cường tính bảo mật. Hãy xem các phương pháp bảo mật tốt nhất cho API để biết thêm thông tin chi tiết.
  • Bạn có thể thêm một quy tắc hạn chế đối với ứng dụng vào khoá API. Sau khi bị hạn chế, khoá sẽ chỉ hoạt động trên những nền tảng hỗ trợ loại hạn chế đó. Có 4 loại quy định hạn chế về ứng dụng. Các API thực thi cùng một loại hạn chế có thể sử dụng cùng một khoá bị hạn chế.
    • Địa chỉ IP (từng máy chủ) – để dùng với API dịch vụ web.
    • Giá trị giới thiệu HTTP (trang web) – để sử dụng với API web.
    • Hạn chế ứng dụng Android (theo tên gói và dấu vân tay) – dùng với SDK Maps dành cho Android.
    • Hạn chế ứng dụng iOS (theo mã nhận dạng gói iOS) – để dùng với Maps SDK cho iOS.
  • Bạn cũng có thể thêm một quy tắc hạn chế đối với khoá API. Để biết thêm thông tin, hãy xem bài viết Lấy, thêm và hạn chế khoá API.

Bảng dưới đây cho biết khoá/thông tin đăng nhập và hạn chế về ứng dụng cho từng API/SDK của Nền tảng Google Maps.

API/SDK Thông tin đăng nhập và hạn chế ứng dụng
Maps SDK cho Android Khoá API có hạn chế đối với Android1
Places SDK for Android Khoá API có hạn chế đối với Android1
Navigation SDK cho Android Khoá API có hạn chế đối với Android1
Maps SDK cho iOS Khoá API có hạn chế đối với iOS1
Places SDK for iOS Khoá API có hạn chế đối với iOS1
Navigation SDK cho iOS Khoá API có hạn chế đối với iOS1
Maps JavaScript API Khoá API có hạn chế về giá trị giới thiệu HTTP1
Map Tiles API Khoá API có hạn chế về địa chỉ IP1
Maps Datasets API Mã thông báo OAuth
Aerial View API Khoá API có hạn chế về địa chỉ IP1
Maps Static API Khoá API có hạn chế về giá trị giới thiệu HTTP1 + Chữ ký số2
Street View Static API Khoá API có hạn chế về giá trị giới thiệu HTTP1 + Chữ ký số2
Maps Embed API Khoá API có hạn chế về giá trị giới thiệu HTTP1
Address Validation API Khoá API có hạn chế về địa chỉ IP1
Elevation API Khoá API có hạn chế về địa chỉ IP1
Geocoding API Khoá API có hạn chế về địa chỉ IP1
Geolocation API Khoá API có hạn chế về địa chỉ IP1
Places API Khoá API có hạn chế về địa chỉ IP1
Places Aggregate API Khoá API có hạn chế về địa chỉ IP1
Roads API Khoá API có hạn chế về địa chỉ IP1
Routes API Khoá API có hạn chế về địa chỉ IP1
Time Zone API Khoá API có hạn chế về địa chỉ IP1
Air Quality API Khoá API có hạn chế về địa chỉ IP1
Pollen API Khoá API có hạn chế về địa chỉ IP1
Solar API Khoá API có hạn chế về địa chỉ IP1
Weather API Khoá API có hạn chế về địa chỉ IP1
1 Bạn không bắt buộc phải đặt các quy tắc hạn chế đối với khoá API, nhưng bạn nên hạn chế tất cả các khoá API để tăng cường bảo mật.
2 Tuỳ thuộc vào mức sử dụng, bạn có thể phải có chữ ký số cho Maps Static APIStreet View Static API. Bất kể cách sử dụng, bạn nên dùng cả khoá API và chữ ký số để xác thực các yêu cầu của mình.
Làm cách nào để chuyển loại hạn chế khoá từ giá trị giới thiệu HTTP sang hạn chế địa chỉ IP?

Quan trọng: Nếu bạn đang sử dụng bất kỳ API dịch vụ web nào có khoá API bị hạn chế theo giá trị giới thiệu, thì các yêu cầu của bạn sẽ gặp lỗi với thông báo lỗi: "API keys cannot have referer restrictions when used with this API." (Khoá API không được có các hạn chế theo giá trị giới thiệu khi được dùng với API này.) Bạn nên chuyển sang sử dụng khoá API có các quy tắc hạn chế về địa chỉ IP.

Trước khi chuyển loại quy tắc hạn chế đối với khoá API từ HTTP referer sang địa chỉ IP, hãy đảm bảo rằng tất cả API sử dụng khoá API đều hỗ trợ loại quy tắc hạn chế đối với địa chỉ IP. Các API thuộc cùng một loại hạn chế có thể sử dụng cùng một khoá bị hạn chế. Nếu bạn cần thực thi nhiều hạn chế, hãy thêm một khoá riêng biệt cùng với hạn chế bắt buộc. Xem cách thêm khoá API mới.

Tìm hiểu thêm về các quy định hạn chế đối với khoá API liên quan đến các sản phẩm của Nền tảng Google Maps.

Để chuyển khoá API có quy tắc hạn chế về giá trị giới thiệu HTTP sang quy tắc hạn chế về địa chỉ IP, hãy làm như sau:

  1. Chuyển đến trang Thông tin đăng nhập của Cloud Console.
  2. Chọn dự án chứa khoá API mà bạn muốn chỉnh sửa.
  3. Trên trang Thông tin xác thực, trong danh sách khoá API, hãy chọn tên của khoá API để chỉnh sửa thông tin chi tiết của khoá.
  4. Trong phần Khoá hạn chế của trang, hãy chọn "Địa chỉ IP (máy chủ web, công việc định kỳ, v.v.)" rồi chèn địa chỉ IP máy chủ thích hợp, sau đó nhấp vào Lưu.
Làm cách nào để lấy khoá API mới?
Xem phần Bắt đầu sử dụng Nền tảng Google Maps.
Làm cách nào để biết những thay đổi được giới thiệu trong từng phiên bản của Google Maps API?

Thông tin về các thay đổi đối với phiên bản của nhiều Maps API có tại các đường liên kết sau:

Bạn cũng có thể kiểm tra phiên bản Nền tảng Google Maps mà một lỗi cụ thể đã được giới thiệu và khắc phục bằng Công cụ theo dõi vấn đề của Nền tảng Google Maps tại:

https://issuetracker.google.com/bookmark-groups/76561

Làm cách nào để tải API vào một trang không đồng bộ sau khi trang đã tải?

Bạn chỉ cần chỉ định tham số callback khi tải API. Bạn có thể tìm thêm thông tin và mã mẫu trong phần Bắt đầu của tài liệu Maps JavaScript API.

Làm cách nào để các sản phẩm của Google Maps Platform hiển thị bằng một ngôn ngữ khác ngoài tiếng Anh?

Theo mặc định, API sẽ cố gắng tải ngôn ngữ phù hợp nhất dựa trên vị trí hoặc chế độ cài đặt trình duyệt của người dùng. Một số API cho phép bạn đặt ngôn ngữ một cách rõ ràng khi đưa ra yêu cầu. Bạn có thể xem thêm thông tin về cách đặt ngôn ngữ trong tài liệu của từng API:

Ngôn ngữ được hỗ trợ:

Google thường xuyên cập nhật các ngôn ngữ được hỗ trợ. Danh sách này có thể chưa đầy đủ và có thể thay đổi.

Mã ngôn ngữ Ngôn ngữ Mã ngôn ngữ Ngôn ngữ
af Tiếng Afrikaans ja Tiếng Nhật
sq Tiếng Albania kn Tiếng Kannada
sáng Tiếng Amhara kk Tiếng Kazakh
ar Tiếng Ả Rập km Tiếng Khmer
hy Tiếng Armenia ko Tiếng Hàn
az Tiếng Azerbaijan ky Tiếng Kyrgyz
eu Tiếng Basque lo Tiếng Lào
be Tiếng Belarus lv Tiếng Latvia
bn Tiếng Bengal lt Tiếng Lithuania
bs Tiếng Bosnia mk Tiếng Macedonia
bg Tiếng Bungary ms Tiếng Malay
my Tiếng Myanmar ml Tiếng Malayalam
ca Tiếng Catalan mr Tiếng Marathi
zh Tiếng Trung mn Tiếng Mông Cổ
zh-CN Tiếng Trung (Giản thể) ne Tiếng Nepal
zh-HK Tiếng Trung (Hong Kong) không Tiếng Na Uy
zh-TW Tiếng Trung (Phồn thể) pl Tiếng Ba Lan
giờ Tiếng Croatia pt Tiếng Bồ Đào Nha
cs Tiếng Séc pt-BR Tiếng Bồ Đào Nha (Brazil)
da Tiếng Đan Mạch pt-PT Tiếng Bồ Đào Nha (Bồ Đào Nha)
nl Tiếng Hà Lan pa Tiếng Punjab
vi Tiếng Anh ro Tiếng Rumani
en-AU Tiếng Anh (Úc) ru Tiếng Nga
en-GB Tiếng Anh (Anh) sr Tiếng Serbia (Chữ Kirin)
et Tiếng Estonia sr-Latn Tiếng Serbia (chữ Latinh)
fa Tiếng Ba Tư si Tiếng Sinhala
fi Tiếng Phần Lan sk Tiếng Slovak
fil Tiếng Philippines sl Tiếng Slovenia
fr Tiếng Pháp es Tiếng Tây Ban Nha
fr-CA Tiếng Pháp (Canada) es-419 Tiếng Tây Ban Nha (Mỹ La Tinh)
gl Tiếng Galic sw Tiếng Swahili
ka Tiếng Gruzia sv Tiếng Thuỵ Điển
de Tiếng Đức ta Tiếng Tamil
el Tiếng Hy Lạp te Tiếng Telugu
gu Tiếng Gujarat th Tiếng Thái
iw Tiếng Do Thái tr Tiếng Thổ Nhĩ Kỳ
hi Tiếng Hindi uk Tiếng Ukraina
hu Tiếng Hungary ur Tiếng Urdu
Tiếng Iceland uz Tiếng Uzbek
id Tiếng Indonesia vi Tiếng Việt
it Tiếng Ý zu Tiếng Zulu

Bạn có thể xem bản đồ sẽ trông như thế nào bằng bất kỳ ngôn ngữ nào được liệt kê ở trên trong ứng dụng mẫu này.

Tôi có thể truy cập Google Maps Platform qua HTTPS (TLS) không?

Bạn có thể và nên truy cập vào tất cả các sản phẩm của Nền tảng Google Maps qua HTTPS. Để đảm bảo ứng dụng của bạn hoạt động trong tương lai, bạn nên sử dụng TLS 1.3 cho HTTPS. Mặc dù các phiên bản TLS cũ vẫn được hỗ trợ, nhưng bạn không nên dựa vào các phiên bản TLS 1.0 và 1.1 cũ không được dùng nữa.

Giao thức SSL không được dùng nữa và không còn được hỗ trợ.

Để biết thêm thông tin, hãy xem Câu hỏi thường gặp về việc di chuyển CA gốc của Nền tảng Google MapsCâu hỏi thường gặp về Google Trust Services.

Làm cách nào để báo cáo lỗi hoặc yêu cầu một tính năng mới trong Nền tảng Google Maps?

Nếu bạn gặp phải hành vi mà bạn cho là lỗi, hãy bắt đầu bằng cách nêu vấn đề đó trong diễn đàn có liên quan. Điều này sẽ cho phép các nhà phát triển khác xác thực lỗi và loại trừ mọi vấn đề tiềm ẩn với mã của bạn.

Để yêu cầu một tính năng, trước tiên, hãy nêu yêu cầu đó trong diễn đàn có liên quan để xác nhận rằng chưa có giải pháp nào đáp ứng yêu cầu của bạn.

Sau khi xác nhận rằng bạn đã xác định được một lỗi mới hoặc các yêu cầu của bạn không thể đáp ứng bằng chức năng hiện có của các sản phẩm thuộc Nền tảng Google Maps, hãy báo cáo lỗi hoặc yêu cầu tính năng bằng Công cụ theo dõi vấn đề của Nền tảng Google Maps.

Trước khi thêm một lỗi hoặc yêu cầu tính năng vào Trình theo dõi lỗi ,hãy nhớ kiểm tra để đảm bảo rằng lỗi hoặc tính năng có liên quan chưa được thêm. Nếu có, bạn có thể gắn dấu sao vào vấn đề đó để thể hiện sự quan tâm và nhận thông báo về các thông tin cập nhật.

Các API của Google Maps Platform sử dụng cookie trang web như thế nào?

Maps SDK cho Android và Maps SDK cho iOS sử dụng cookie theo Chính sách quyền riêng tư của Google, chẳng hạn như tính toán số người dùng hoạt động hằng ngày và trong 7 ngày, cũng như ngăn chặn hành vi sử dụng dịch vụ sai mục đích. Những cookie này không liên kết với bất kỳ Tài khoản Google nào đã đăng nhập và không được ghi lại cùng với phần còn lại của thông tin được thu thập từ các lệnh gọi API.

Tôi không tìm thấy câu trả lời cho câu hỏi của mình. Tôi nên liên hệ với ai?

Nhóm Quan hệ với nhà phát triển của Google có mặt trên Stack Overflow – một trang web hỏi và đáp do cộng đồng chỉnh sửa dành cho lập trình viên. Đây là nơi lý tưởng để đặt câu hỏi kỹ thuật về việc phát triển và duy trì các ứng dụng Google Maps. Bạn có thể xem thêm thông tin về cách đặt câu hỏi trên Stack Overflow trên trang Hỗ trợ.

Để đạt được kết quả tốt nhất khi yêu cầu trợ giúp, hãy lưu ý những điều sau:

  • Tìm kiếm các cuộc thảo luận hiện tại. Rất có thể đã có người khác gặp phải vấn đề tương tự và tìm ra cách khắc phục.
  • Gửi đường liên kết đến trang web của bạn nếu có thể. Chỉ đăng đoạn mã nếu bạn không xem được mã này trên mạng.
  • Cung cấp tất cả thông tin liên quan, bao gồm cả phiên bản trình duyệt, lỗi và tất cả các thông tin khác có thể hữu ích trong việc khắc phục vấn đề này.

Lỗi và cách khắc phục

Lỗi này có nghĩa là gì?

Nếu bạn gặp lỗi khi tải hoặc chạy Google Maps API, hãy xem các đường liên kết sau để tìm nội dung giải thích về mã lỗi:

Bản đồ của tôi xuất hiện tối hơn bình thường. Chuyện gì đang xảy ra?

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ó hình mờ là 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ó vấn đề với khoá API hoặc việc thanh toán. Để sử dụng các sản phẩm của Google Maps Platform, bạn phải có một tài khoản thanh toán và tất cả các yêu cầu đề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:


Làm cách nào để giải quyết mã lỗi OVER_DAILY_LIMIT hoặc OVER_QUERY_LIMIT?
Các mã lỗi này có thể được trả về vì bất kỳ lý do nào sau đây:
  • Yêu cầu thiếu khoá API.
  • Khoá API bạn cung cấp không hợp lệ.
  • Dự án không có tài khoản thanh toán nào được đính kèm.
  • Bạn đã vượt quá hạn mức sử dụng do chính mình đặt ra.
  • 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 đã vượt quá hạn mức cho một API nhất định.

Để sử dụng các sản phẩm của Google Maps Platform, bạn phải có một tài khoản thanh toán và tất cả các yêu cầu đều phải có một khoá API hợp lệ. Để khắc phục vấn đề này, hãy làm theo các bước sau: