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?

Xem phần 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 trình chọn API.

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 hoặc 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 những ứng dụng trình duyệt nhắm đến cả máy tính và các 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à API Maps Embed 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ề các sản phẩm dành cho nhà phát triển của Google Geo.

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

Hãy xem Thông tin hỗ trợ và tài nguyên của Nền tảng Google Maps để 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 để khôi phục 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ụ: joe@mycompany.com hoặc joe@gmail.com), 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 nên sử dụng Google Maps Platform để xác định thông tin riêng tư về cá nhân.

Bạn nên tự tìm hiểu để xác định xem ứng dụng của mình 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 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 ô 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. 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 đã bị ngừ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 bài viết 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 và đặ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à 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?

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 phần Báo cáo của Nền tảng Google Maps cũng như phần Giám sát Nền tảng Google Maps và Đặ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, thì 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 vì ứ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 phí 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 bài viết 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ờ?

Nền tảng Google Maps cung cấp các cách để đặt hạn mức yêu cầu hằng ngày và đặt hạn mức 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 phí tối đa 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 tình trạng tăng mức sử dụng ngoài dự kiến. 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 của chúng tôi. 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 khi đạt đến hạn mức 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 vượt quá 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 hay 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 Các quy tắc hạn chế đối với khoá API là không bắt buộc, 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 API và Street 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ẽ không thành công và nhận được thông báo lỗi: "API keys cannot have referer restrictions when used with this API." (Khoá API không được có hạn chế theo giá trị giới thiệu khi 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 bài viết 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 mỗi 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ể xem 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
là 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ả 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 Maps và Câ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 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 được 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 đã đăng nhập nào 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?
Bạn có thể nhận được các mã lỗi này vì bất kỳ lý do nào sau đây:
  • Yêu cầu thiếu khoá API.
  • Khoá API đã cung cấp không hợp lệ.
  • Dự án không có tài khoản thanh toán đượ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:

Làm cách nào để giải quyết mã lỗi kGMSPlacesRateLimitExceeded hoặc 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
Nếu thấy kGMSPlacesRateLimitExceeded hoặc 9005 PLACES_API_RATE_LIMIT_EXCEEDED, thì có thể bạn đang sử dụng phiên bản không dùng nữa của Places SDK cho Android hoặc Places SDK cho iOS. Tìm hiểu thêm và tìm các SDK mới tại https://goo.gle/places-sdk-deprecation.
Làm cách nào để khắc phục lỗi: "IP, trang web hoặc ứng dụng di động này không được phép sử dụng khoá API này"?

Có nhiều trường hợp có thể gây ra lỗi này:

  • Bạn đã bật chế độ hạn chế địa chỉ IP (máy chủ) trên khoá API và một địa chỉ IP không được uỷ quyền đang cố gắng đưa ra yêu cầu.
  • Bạn đã bật chế độ hạn chế liên kết giới thiệu HTTP (trang web) trên khoá API của mình và một liên kết giới thiệu không được phép đang cố gắng gửi yêu cầu.
  • Bạn đã hạn chế việc sử dụng cho các ứng dụng Android của mình bằng cách đặt tên gói và dấu vân tay, đồng thời một ứng dụng Android trái phép đang cố gắng thực hiện một yêu cầu.
  • Bạn đã hạn chế các yêu cầu từ ứng dụng iOS bằng cách chỉ định giá trị nhận dạng gói và một ứng dụng iOS không xác định đang cố gắng gửi yêu cầu.
  • Trước đây, bạn có thể gặp lỗi này nếu sử dụng bất kỳ API dịch vụ web nào, bằng khoá API có các hạn chế về giá trị giới thiệu HTTP. Các yêu cầu đối với những API đó phải được xác định bằng một khoá API có các quy tắc hạn chế về địa chỉ IP. Chuyển loại quy tắc hạn chế đối với khoá từ quy tắc hạn chế đối với HTTP Referer sang quy tắc hạn chế đối với địa chỉ IP. Để biết thêm thông tin về cách hạn chế khoá API, hãy xem phần Các phương pháp hay nhất về khoá API.

Xem và chỉnh sửa thông tin xác thực khoá API

Để xem khoá API và quản lý mọi quy tắc hạn chế, 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 có chứa khoá API mà bạn muốn xem.
  3. Để xem thông tin chi tiết về thông tin đăng nhập, bao gồm cả mọi quy tắc hạn chế được đặt cho khoá, hãy nhấp vào tên của khoá trong danh sách khoá API.
  4. Thông tin đăng nhập đầy đủ của khoá API đã chọn sẽ xuất hiện, bao gồm cả mọi quy tắc hạn chế được thiết lập cho khoá. Tại đây, bạn có thể thay đổi, xoá hoặc cập nhật các chế độ hạn chế nếu cần.
Làm cách nào để khắc phục lỗi: "Không thể sử dụng khoá API có hạn chế về giá trị giới thiệu với API này"?

Bạn đang sử dụng bất kỳ API dịch vụ web nào có khoá API bị hạn chế đối với một HTTP referer. Vì lý do bảo mật, các API dịch vụ web cần sử dụng khoá API bị hạn chế đối với địa chỉ IP. Chuyển loại quy tắc hạn chế đối với khoá từ 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 hoặc tạo khoá API mới nếu khoá của bạn đã được dùng với Maps JavaScript API.

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

Tôi cần chuyển đổi địa chỉ thành cặp vĩ độ/kinh độ. Tôi có thể làm việc đó bằng Nền tảng Google Maps không?

Có, quy trình này được gọi là "địa mã hoá". API Maps JavaScript bao gồm một lớp để thực hiện dịch vụ mã hoá địa lý. Lớp này là: google.maps.Geocoder.

Ngoài ra, Google cũng cung cấp Geocoding API. API này cung cấp một giao diện REST có thể phản hồi ở định dạng JSON và XML.

Dịch vụ mã hoá địa lý được cung cấp ở những quốc gia nào?

Để xem những quốc gia được bộ mã hoá địa lý của Nền tảng Google Maps hỗ trợ, hãy tham khảo dữ liệu về phạm vi của Google Maps.

Độ chính xác của vị trí được mã hoá địa lý có thể khác nhau tuỳ theo quốc gia, vì vậy, bạn nên cân nhắc sử dụng trường location_type được trả về để xác định xem có tìm thấy kết quả trùng khớp đủ tốt cho mục đích của ứng dụng hay không. Tính sẵn có của dữ liệu mã hoá địa lý phụ thuộc vào hợp đồng của chúng tôi với các nhà cung cấp dữ liệu, vì vậy, dữ liệu này có thể thay đổi.

Tại sao Trình mã hoá địa lý của Nền tảng Google Maps lại cung cấp các vị trí khác với Google Maps?

Bộ mã hoá địa lý API và bộ mã hoá địa lý Google Maps đôi khi sử dụng các tập dữ liệu khác nhau (tuỳ thuộc vào quốc gia). Đôi khi, trình mã hoá địa lý API được cập nhật dữ liệu mới, vì vậy, bạn có thể thấy kết quả thay đổi hoặc cải thiện theo thời gian.

Tôi nên định dạng các truy vấn của trình mã hoá địa lý như thế nào để tối đa hoá số lượng yêu cầu thành công?

Bộ mã hoá địa lý được thiết kế để liên kết địa chỉ đường phố với toạ độ địa lý. Do đó, bạn nên định dạng các yêu cầu của trình mã hoá địa lý theo các nguyên tắc sau để tối đa hoá khả năng truy vấn thành công:

  • Hãy chỉ định địa chỉ theo định dạng mà dịch vụ bưu chính quốc gia của quốc gia liên quan sử dụng.
  • không chỉ định các thành phần địa chỉ bổ sung như tên doanh nghiệp, số đơn vị, số tầng hoặc số phòng không có trong địa chỉ theo quy định của dịch vụ bưu chính của quốc gia liên quan. Nếu bạn làm như vậy, câu trả lời có thể chứa ZERO_RESULTS.
  • Định dạng mã cộng như minh hoạ ở đây (dấu cộng được thoát URL thành %2B và dấu cách được thoát URL thành %20):
    • mã toàn cầu là mã vùng gồm 4 ký tự và mã địa phương gồm 6 ký tự trở lên (849VCWC8+R9 là 849VCWC8%2BR9).
    • mã kết hợp là mã địa phương có từ 6 ký tự trở lên và có vị trí rõ ràng (CWC8+R9 Mountain View, CA, Hoa Kỳ là CWC8%2BR9%20Mountain%20View%20CA%20USA).
  • Ưu tiên sử dụng số nhà của một cơ sở thay vì tên toà nhà nếu có thể.
  • Ưu tiên sử dụng địa chỉ số nhà thay vì chỉ định đường giao nhau nếu có thể.
  • không cung cấp "gợi ý" như địa danh lân cận.
Tôi nên định dạng địa chỉ ở Hoa Kỳ trên đường cao tốc có đánh số như thế nào để mã hoá địa lý?

Trình mã hoá địa lý của Google Maps Platform yêu cầu bạn chỉ định đường cao tốc có số hiệu của Hoa Kỳ trong địa chỉ như sau:

  • Đường hạt: "Co Road NNN" trong đó NNN là số đường. Ví dụ: "Co Road 82"
  • Đường cao tốc tiểu bang: "State NNN", trong đó Tiểu bang là tên đầy đủ của tiểu bang và NNN là số đường cao tốc. Ví dụ: "California 82"
  • Đường cao tốc ở Hoa Kỳ: "US NNN", trong đó NNN là số đường cao tốc. Ví dụ: "US 101"
  • Đường cao tốc liên tiểu bang của Hoa Kỳ: "Interstate NNN" trong đó NNN là số đường cao tốc liên tiểu bang. Ví dụ: "Interstate 280"
Khi nào tôi nên sử dụng lớp bộ mã hoá địa lý API và khi nào tôi nên sử dụng Dịch vụ mã hoá địa lý HTTP?

Xem tài liệu: Chiến lược mã hoá địa lý, trong đó nêu chi tiết những ưu điểm và hạn chế của các chiến lược mã hoá địa lý.

Làm cách nào để cung cấp chỉ đường lái xe bằng Nền tảng Google Maps?

Dịch vụ Compute Routes của Routes API cho phép bạn cung cấp chỉ đường lái xe cho hành trình một và nhiều chặng. Các lựa chọn về định tuyến giúp bạn định hình đường đi bằng một chế độ di chuyển (lái xe), một hoặc một nhóm tuyến đường và các quy định hạn chế (không có đường thu phí). Các dịch vụ này có ở những dạng sau:

Giao diện yêu cầu/phản hồi HTTP (được dùng trong các ứng dụng di động và ứng dụng khác) tương thích với Maps SDK cho Android và các dịch vụ web khác của Google Maps.

Chỉ đường lái xe có ở những quốc gia nào?

Để xem những quốc gia được hỗ trợ chỉ đường lái xe trong các sản phẩm của Nền tảng Google Maps, hãy tham khảo dữ liệu về phạm vi cung cấp của Google Maps. Phạm vi cung cấp dữ liệu chỉ đường phụ thuộc vào hợp đồng của chúng tôi với các nhà cung cấp dữ liệu và có thể thay đổi.

Hướng dẫn đường đi bằng phương tiện công cộng có ở những quốc gia nào?

Routes API hỗ trợ tất cả đối tác Google Transit, ngoại trừ Indian Railway Catering and Tourism Corporation và các đối tác ở Nhật Bản.

Maps JavaScript API hỗ trợ những tính năng KML và GeoRSS nào?

Lớp KmlLayer trong Maps JavaScript API cho phép nhà phát triển phủ các tệp KML/KMZ và GeoRSS lên trên bản đồ. Để xem tài liệu và ví dụ, hãy xem lớp KmlLayer.

Giới hạn về kích thước và độ phức tạp của KML có thể hiển thị bằng lớp KmlLayer của Maps JavaScript API là bao nhiêu?

Giới hạn về kích thước và độ phức tạp khi hiển thị KML bằng lớp KmlLayer được ghi lại trong Tổng quan về KmlLayer.

Làm cách nào để hiển thị các tệp KML được lưu trữ trên các trang web nội bộ trên bản đồ?

Lớp KmlLayer tạo lớp phủ KML trong Maps JavaScript API sử dụng một dịch vụ do Google lưu trữ để truy xuất và phân tích cú pháp các tệp KML để hiển thị. Do đó, bạn không thể hiển thị các tệp KML không được lưu trữ tại một URL có thể truy cập công khai hoặc yêu cầu xác thực để truy cập.

Nếu cần phát triển các ứng dụng sử dụng tệp KML được lưu trữ trên các trang web nội bộ, bạn nên kết xuất KML ở phía máy khách bằng cách sử dụng các thư viện JavaScript của bên thứ ba. Khi trình duyệt phân tích tệp KML, hiệu suất có thể thấp hơn so với khi sử dụng lớp KmlLayer.

Maps Static API hỗ trợ tối đa bao nhiêu điểm đánh dấu hoặc đỉnh đường dẫn?

Maps Static API không giới hạn số lượng điểm đánh dấu hoặc đỉnh đường dẫn được hỗ trợ. Khi sử dụng biểu tượng tuỳ chỉnh, bạn có thể chỉ định tối đa 5 biểu tượng riêng biệt cho mỗi yêu cầu, nhưng mỗi biểu tượng có thể được dùng nhiều lần trong bản đồ.

Xin lưu ý rằng URL Maps Static API có thể chứa tối đa khoảng 8.192 ký tự,điều này hạn chế số lượng điểm đánh dấu và đỉnh đường dẫn mà bạn có thể chỉ định dựa trên số lượng chữ số thập phân được dùng khi chỉ định từng cặp vĩ độ/kinh độ. Để biết thông tin về số lượng chữ số thập phân được sử dụng liên quan đến độ chính xác trên Trái Đất, hãy xem bài viết trên Wikipedia về Độ thập phân.

Tại sao tôi không thể truy cập vào các sản phẩm của Google Maps Platform ở một số quốc gia?

Bạn không được sử dụng Maps API ở Các lãnh thổ bị cấm. Bạn cũng có thể tham khảo Điều khoản dịch vụ.

Làm cách nào để báo cáo vấn đề trên bản đồ cơ sở của Google?
Gửi ý kiến phản hồi thông qua Google Maps đối với thông tin bản đồ bị thiếu hoặc không chính xác, chẳng hạn như:
  • Địa chỉ hoặc vị trí điểm đánh dấu sai
  • Tên đường không chính xác
  • Thông tin sai về đường một chiều và đường hai chiều
  • Đường được vẽ không chính xác
  • Đường bị đóng
  • Đường không tồn tại

Để chỉnh sửa một địa điểm hoặc trang thông tin doanh nghiệp, hãy đề xuất nội dung chỉnh sửa.

Nếu nội dung trên Maps cần bị xoá vì lý do pháp lý, hãy gửi yêu cầu pháp lý.

Đối với những yêu cầu quan trọng hoặc cần được xử lý sớm, hãy gửi yêu cầu hỗ trợ kèm theo thông tin cụ thể về những vấn đề cần được khắc phục.

Làm cách nào để theo dõi hiệu suất của các dịch vụ được dùng với API Maps JavaScript?

Một số tính năng phía máy khách được đo lường để báo cáo thành công hoặc thất bại nhằm tính toán SLO (Mục tiêu về cấp độ dịch vụ). Thông tin này được gửi đến Google tại maps.googleapis.com/maps_api_js_slo/log trong các cuộc gọi ghi nhật ký thông tin về SLO. Thông tin này bao gồm trạng thái thành công, độ trễ và phiên bản/kênh của API JavaScript của Maps đang được sử dụng. Các lệnh gọi có thể được xử lý theo lô để tăng hiệu suất. Bạn có thể cần cho phép maps.googleapis.com trong Chính sách bảo mật nội dung để các lệnh gọi này không bị chặn ở cấp trình duyệt. Ví dụ: Content-Security-Policy: default-src 'self' maps.googleapis.com; có tiêu đề HTTP hoặc <meta http-equiv="Content-Security-Policy" content="default-src 'self' maps.googleapis.com;"> có thẻ meta HTML.

API JavaScript cho Maps

API JavaScript của Maps sẽ hoạt động trong bao lâu sau khi được tải?

Bạn cần làm mới trang tải Maps JavaScript API ít nhất một lần mỗi 5 ngày.

Google Maps SDK cho iOS

Làm cách nào để giải quyết lỗi kGMSPlacesRateLimitExceeded?
Nếu gặp lỗi này, có thể bạn đang sử dụng một phiên bản không dùng nữa của Places SDK cho iOS. Phiên bản 2.7.0 của Places SDK cho iOS đã bị tắt và không còn dùng được nữa. Hãy cập nhật ứng dụng để dùng phiên bản mới nhất càng sớm càng tốt. Hãy xem hướng dẫn di chuyển để biết thông tin chi tiết.
Tôi gặp phải lỗi khi gỡ lỗi bằng thiết bị iOS 8.x. Tôi nên làm gì?

Nếu bạn gặp vấn đề khi gỡ lỗi bằng các thiết bị chạy iOS 8.x, hãy làm theo các bước sau để tắt tính năng chụp khung hình GPU trong giản đồ XCode mà bạn đang chạy:

  1. Trong XCode, hãy chọn Product (Sản phẩm), Scheme (Lược đồ), Manage Schemes (Quản lý lược đồ).
  2. Chọn một lược đồ rồi chọn Chỉnh sửa....
  3. Đặt tuỳ chọn GPU Frame Capture (Ghi lại khung hình GPU) thành Disabled (Đã tắt). Xin lưu ý rằng một số thiết bị có thể không có lựa chọn này.
Lựa chọn Xcode GPU Frame Capture (Chụp khung hình GPU Xcode) trên trang Generic iOS device (Thiết bị iOS chung)
Màn hình bo tròn và màn hình rộng có tác động gì đến SDK Google Maps cho iOS?

Bắt đầu từ iPhone X, iPhone có màn hình với các góc bo tròn, một vết cắt ở trên cùng cho hộp cảm biến của thiết bị và một chỉ báo ở dưới cùng của màn hình để truy cập vào Màn hình chính. Kể từ iOS 11.0 SDK, Apple đã thêm API vùng an toàn cho phép nhà phát triển định vị các phần tử trong một vùng an toàn, không bị cắt bởi hình dạng màn hình mới.

Google Maps SDK cho iOS có nhiều phần tử và chế độ kiểm soát trực quan, chẳng hạn như bộ chọn địa điểm trong nhà và đường liên kết báo cáo vấn đề. Với phiên bản 2.4, những phần tử và chế độ kiểm soát trực quan này có thể bị cắt bớt theo hình dạng màn hình mới. Ở chế độ ngang, bộ chọn sàn trong nhà có thể bị cắt bởi vết cắt hoặc chỉ báo nút trang chủ.

Với bản phát hành Google Maps SDK cho iOS 2.5, những vấn đề về bố cục này sẽ được tự động khắc phục. Khi ứng dụng của bạn được dùng trên iPhone X trở lên, khoảng đệm trên GMSMapView và GMSPanoramaView sẽ tăng lên để các phần tử trực quan không bị cắt.

Theo mặc định, chúng tôi sẽ luôn thêm khoảng đệm của bạn. Google Maps iOS SDK giả định rằng khoảng đệm được dùng để đệm từ bên trong vùng an toàn. Nếu bạn thiết kế giao diện với giả định rằng mọi thứ đều nằm trong vùng an toàn, thì điều này sẽ hoạt động mà không cần nỗ lực thêm.

Nếu bạn đã thiết kế một giao diện không hoạt động với chế độ điều chỉnh mặc định của chúng tôi, thì chúng tôi đã giới thiệu một thuộc tính mới cho GMSMapView, được gọi là paddingAdjustmentBehavior. Sử dụng GMSMapView để chọn một trong ba hành vi điều chỉnh khoảng đệm: "Luôn luôn" (mặc định), "Tự động" và "Không bao giờ".

Nếu bạn đặt GMSMapView sử dụng hành vi đệm "Luôn luôn", thì hệ thống sẽ luôn thêm phần lồng ghép vùng an toàn vào khoảng đệm. Chế độ cài đặt này cho phép bạn thiết kế giao diện với giả định rằng tất cả vị trí đều nằm ở các cạnh của vùng an toàn. Đây là giá trị mặc định.

Nếu GMSMapView được đặt để sử dụng hành vi khoảng đệm "Tự động", thì hệ thống sẽ luôn chọn khoảng đệm hoặc phần lồng vùng an toàn lớn hơn. Chế độ cài đặt này cho phép bạn thêm khoảng đệm từ cạnh màn hình trong khi vẫn đảm bảo tất cả các phần tử nằm trong vùng an toàn.

Nếu GMSMapView được đặt để sử dụng hành vi đệm "Không bao giờ", thì nó sẽ không bao giờ thêm phần lồng vùng an toàn vào khoảng đệm. Đây là hành vi trước phiên bản 2.5 và có thể hữu ích nếu khoảng đệm của bạn đã xem xét đến vùng an toàn hoặc nếu các hành vi khác của chúng tôi không hoạt động tốt với giao diện của bạn. Bạn chịu trách nhiệm đảm bảo rằng biểu trưng và thông báo bản quyền của Google luôn hiển thị, như quy định trong Điều khoản dịch vụ của Nền tảng Google Maps.

Ngược lại, GMSPanoramaView không có thuộc tính khoảng đệm không bắt buộc. Điều này có nghĩa là không có khoảng đệm nào để điều chỉnh và GMSPanoramaView sẽ luôn áp dụng mọi khoảng đệm cần thiết để tất cả các phần tử trực quan đều nằm trong vùng an toàn.

Google Maps SDK dành cho Android

Làm cách nào để giải quyết lỗi 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
Nếu gặp lỗi này, có thể bạn đang sử dụng một phiên bản không dùng nữa của Places SDK cho Android. Phiên bản Dịch vụ Google Play của Places SDK cho Android đã bị tắt và không còn hoạt động nữa. Hãy cập nhật ứng dụng để dùng phiên bản mới nhất trong thời gian sớm nhất có thể. Hãy xem hướng dẫn di chuyển để biết thông tin chi tiết.
Ứng dụng của tôi chỉ hiển thị các ô trống màu xám thay vì bản đồ. Làm cách nào để giải quyết vấn đề này?

Một lý do thường gặp khiến các ô trống màu xám xuất hiện thay vì bản đồ là do vấn đề về việc xác thực. Bạn có thể làm theo các bước dưới đây để khắc phục những vấn đề đó bằng cách sử dụng adb logcat.

  1. Đảm bảo bạn đã cài đặt adb. Nếu không, bạn có thể làm theo hướng dẫn Hướng dẫn về adb trên Android.
  2. Cài đặt ứng dụng gặp vấn đề trên một thiết bị hoặc trình mô phỏng Android. Nếu bạn sử dụng trình mô phỏng Android, hãy đảm bảo rằng trình mô phỏng đó có Cửa hàng Play.
  3. Trong cửa sổ dòng lệnh của Android Studio, hãy chạy adb logcat -e "Google Maps Android API". Thao tác này sẽ chỉ in những dòng mà thông báo nhật ký khớp với "Google Maps Android API" (Bạn có thể xuất nhật ký sang tệp văn bản bằng cách thêm: > logcat.txt)
  4. Tái hiện vấn đề trên thiết bị của bạn và kiểm tra các lỗi thường gặp như:
    • Khoá API không chính xác/không mong muốn đang được tham chiếu trong Tệp kê khai.
    • Tính năng thanh toán chưa được bật trên Dự án.
    • SDK chưa được bật trên các API của dự án.
    • Dấu vân tay SHA-1 không chính xác được thêm vào các quy tắc hạn chế đối với khoá API.
    • Phần phụ thuộc Dịch vụ Google Play không có trong tệp build.gradle.

Ký URL

Tôi có thể ký URL bằng JavaScript không?

Bạn không nên ký URL bằng JavaScript vì việc này sẽ để lộ khoá bí mật dùng để ký URL cho người dùng cuối. Do đó, chỉ các thành phần phía máy chủ mới được tạo chữ ký.

Tại sao tôi nhận được phản hồi HTTP 403 Bị cấm cho các yêu cầu dịch vụ web Maps API?

Phản hồi HTTP 403 cho biết có vấn đề về quyền, có thể là do không xác minh được chữ ký cho yêu cầu này. Lý do có thể là:

  1. Bạn đã chỉ định một chữ ký nhưng chữ ký đó không chính xác cho yêu cầu này.
  2. Yêu cầu chỉ định một khoá API của gói Cao cấp của Nền tảng Google Maps nhưng không chỉ định chữ ký, đồng thời dịch vụ đang được gọi yêu cầu rằng các yêu cầu được thực hiện bằng khoá API phải có chữ ký hợp lệ.
  3. Bạn đã chỉ định một chữ ký nhưng chưa chỉ định khoá API của Gói cao cấp của Nền tảng Google Maps được liên kết.