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

Bắt đầu

Tìm hiểu điều khoản dịch vụ

Hạn mức sử dụng và thanh toán (hạn mức)

Sử dụng Google Maps Platform

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

Các dịch vụ của Google Maps Platform

API JavaScript cho Maps

SDK Google Maps dành cho iOS

SDK Google Maps cho Android

Ký URL

Bắt đầu

Google Maps Platform là gì?

Google Maps Platform 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ố dịch vụ. Tuỳ thuộc vào nhu cầu, 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 Google Maps Platform?

Xem bài viết Bắt đầu sử dụng Google Maps Platform.

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 khám phá 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 hướng dẫn Tổng quan, hướng dẫn dành cho Nhà phát triển và hướng dẫn Bắt đầu sử dụng cho API hoặc SDK cụ thể mà bạn quan tâm. Ví dụ: hãy xem hướng dẫn về Maps SDK cho Android hoặc Maps JavaScript API.

Google Maps Platform hỗ trợ những quốc gia nào?

Nhóm Google Maps liên tục đưa ra dữ liệu bản đồ mới và tăng phạm vi cung cấp trên toàn thế giới. 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ể đưa Google Maps vào trang web của mình mà không cần sử dụng các sản phẩm của Google Maps Platform không?

Có. Google Maps hiện cung cấp khả năng 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 Google Maps Platform. Bạn có thể xem thêm thông tin tại đây.

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

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

Để kết hợp bản đồ trong ứng dụng iOS, hãy sử dụng SDK bản đồ dành cho iOS.

Maps JavaScript API được phát triển để phục vụ cho 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à thiết bị có trình duyệt web triển khai JavaScript đầy đủ, chẳng hạn như Apple iPhone.

Đối với các ứng dụng nhắm đến thiết bị không phù hợp để sử dụng API JavaScript của Maps, Maps Static API sẽ cung cấp hình ảnh bản đồ ở định dạng GIF, JPG và PNG, bao gồm cả điểm đánh dấu và hình nhiều đường. 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.

Maps JavaScript API và Maps Embed API hỗ trợ những 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), không bao gồm chế độ IE.
  • Hai phiên bản ổn định chính mới nhất của Firefox (Windows, macOS, Linux).
  • Hai phiên bản ổn định chính mới nhất của Chrome (Windows, macOS, Linux).
  • Hai phiên bản ổn định chí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
  • Safari dành cho thiết bị di động trên các phiên bản lớn của iOS hiện tại và trước đó.
  • UIWebView và WKWebView trên các phiên bản lớn 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?

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

Làm cách nào để nhận 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 Google Maps Platform để nhận tin tức cập nhật về các dịch vụ khác nhau của Google Geo dành cho nhà phát triển.

Làm cách nào để liên hệ với bộ phận 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ợ làm việc 24 giờ/ngày, 5 ngày/tuần (các ngày trong tuần từ 9:00 thứ Hai theo giờ Tokyo đến 17:00 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 thể sử dụng 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 của mình (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 lấy lại hoặc đặt lại mật khẩu. Hãy truy cập vào bài viết Cách khôi phục Tài khoản Google hoặc Gmail trong Trung tâm 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 Google Maps Platform, 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 liên kết với dự án:

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:

Tôi có thể sử dụng SDK Maps và Places dành 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 phải xây dựng 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 tìm cách hỗ trợ thêm cho việc phát triển trên trình mô phỏng.

Tìm hiểu điều khoản dịch vụ

Điều khoản dịch vụ của các sản phẩm trên Google Maps Platform là gì?

Điều khoản dịch vụ của Google Maps Platform 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 Google Maps Platform không?

Bạn có thể sử dụng Google Maps Platform 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 Google Maps Platform.

Tuy nhiên, có một số cách 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 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 Google Maps Platform để xác định thông tin riêng tư về các cá nhân.

Bạn nên tham khảo ý kiến của cố vấn pháp lý để 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 đủ điều kiện để đưa ra lời khuyên pháp lý. Google giữ quyền tạm ngưng hoặc chấm dứt việc bạn sử dụng dịch vụ bất cứ lúc nào, vì vậy, hãy đọc kỹ Điều khoản của 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 Google Maps Platform (chẳng hạn như việc tạo API Maps của riêng bạn hoặc việc sử dụng một tập lệnh tải xuống hàng loạt ô bản đồ). Ứng dụng của bạn sẽ bị chặn truy cập vào các ô nếu truy cập vào các ô đó bên ngoài Google Maps Platform. Hãy xem Điều khoản dịch vụ của Google Maps Platform để 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 Google Maps Platform cho các ứng dụng theo dõi không?

Không có quy định hạn chế nào về 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 Google Maps Platform, miễn là ứng dụng tuân thủ Điều khoản dịch vụ của Google Maps Platform.

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

Có, các sản phẩm của Google Maps Platform hiện có thể được sử dụng 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ủ các quy định hạn chế khác trong Điều khoản dịch vụ của Google Maps Platform.

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 Google Maps Platform 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ụ của Google Maps, Routes, Places và Environment 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 Google Maps Platform để biết thêm thông tin.

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

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

Làm cách nào để chọn không cho nội dung của tôi xuất hiện trong 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 nữa và không có hiệu lực. Bạn không cần phải chọn không tham gia một cách rõ ràng nữa, nhưng bạn nên xoá tham số này càng sớm càng tốt.

Để 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 rồi lưu trữ và phân phát hình ảnh đó trên 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 từ trang web của mình. Tất 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ẻ HTML img hoặc thuộc tính CSS background-image của thẻ HTML div trực tiếp với Maps Static API để tất cả hình ảnh bản đồ đều hiển thị 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à 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 Google Maps Platform.
Chương trình dùng thử miễn phí Google Cloud là gì và người dùng chương trình này nâng cấp lên tài khoản có tính phí bằng cách nào?

Chương trình dùng thử miễn phí Google Cloud kéo dài 91 ngày, cho phép người dùng mới dùng thử các sản phẩm phổ biến nhất của Google Cloud, bao gồm cả các API của Google Maps Platform (GMP) mà không cần cam kết tài chính. Khi đăng ký dùng thử miễn phí, bạn sẽ tạo một tài khoản thanh toán dùng thử miễn phí được nạp sẵn 300 USD tín dụng chào mừng miễn phí mà bạn có thể chi tiêu trên GMP.

Nếu bạn không nâng cấp lên Tài khoản thanh toán có tính phí trước khi hết 91 ngày hoặc nếu bạn chi tiêu hết 300 USD tín dụng miễn phí, thì Tài khoản thanh toán dùng thử miễn phí của bạn sẽ bị đóng và tất cả dự án cũng như tài nguyên liên quan sẽ bị dừng. Để giữ lại các tài nguyên bạn tạo trong thời gian Dùng thử miễn phí và để các dịch vụ của bạn hoạt động không bị gián đoạn, hãy nâng cấp lên Tài khoản thanh toán có tính phí. Tìm hiểu thêm về Bản dùng thử miễn phí.

Google Maps Platform 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 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 của 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: Tra cứu video 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 truy vấn mỗi phút
Maps JavaScript API: Bản đồ động 30.000 QPM
Độ cao 6.000 QPM
Mã hoá địa lý 3.000 truy vấn mỗi phút
Vị trí địa lý 6.000 QPM
Maps Grounding Lite: Tìm địa điểm, Tra cứu thời tiết, Tính toán tuyến đường 300 truy vấn mỗi phút cho mỗi công cụ
Maps Grounding Lite: Phân giải tên, Phân giải URL của Maps 600 QPM cho mỗi phương thức
Map Tiles API: Ô bản đồ 2D 6.000 truy vấn mỗi phút và 15.000 truy vấn mỗi ngày
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ề điểm đến 30.000 truy vấn mỗi phút
Địa điểm 6.000 truy vấn mỗi phút
Places Aggregate 1.200 truy vấn/phút
Phấn hoa 6.000 truy vấn mỗi phút
Đường 30.000 truy vấn mỗi phút
Routes: Compute Routes 3.000 truy vấn mỗi phút
Routes: Compute Route Matrix 3.000 EPM
Năng lượng mặt trời 600 truy vấn mỗi phút
Bản đồ tĩnh 30.000 truy vấn mỗi phút
API hình ảnh chế độ xem đường phố 30.000 truy vấn mỗi phút
Múi giờ 30.000 truy vấn mỗi phút
Thời tiết 6.000 QPM

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

Các sản phẩm của Google Maps Platform phải được triển khai theo đúng Điều khoản dịch vụ của Google Maps Platform.

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í cho các API của Google Maps Platform, hãy xem bài viết Tổng quan về cách tính phí và giá của Google Maps Platform.

Lượt tải bản đồ được tính như thế nào trên Google Maps Platform?

Một lượt 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 cách sử dụng Maps JavaScript API.
  • Một ứng dụng yêu cầu một hình ảnh bản đồ từ Maps Static API.

Ảnh toàn cảnh trong Chế độ xem đường phố được tính phí riêng biệt với số 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 phố được tính phí cho mỗi lần tạo thực thể của một đối tượng ảnh toàn cảnh trong ứng dụng Maps JavaScript API, SDK Bản đồ cho Android hoặc SDK Bản đồ 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 trong Chế độ xem đường phố, mọi hoạt động tương tác của người dùng với bản đồ, hình ảnh hoặc ảnh toàn cảnh đó (chẳng hạn như kéo, 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 đ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 phí liên quan đến cách xác định vị trí 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 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 điều này, hãy thiết lập thông tin thanh toán.
  2. Chuyển đến trang thanh toán của 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 các 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 Google Maps Platform cũng như Giám sát Google Maps Platform và Đặt hạn mức.

Điều gì sẽ xảy ra nếu tôi vượt quá giới hạn về tỷ lệ 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 nhất định trên Google Maps Platform, thì API sẽ trả về thông báo lỗi. Nếu bạn liên tục vượt quá giới hạn, 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ụ sai cách, 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ì quyền truy cập của bạn vào Google Maps Platform có thể bị chặn.

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 API Maps JavaScript: Độ 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 dưới dạng phản hồi.

Thông báo này có nghĩa là dịch vụ web đã ngừng cung cấp 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 thêm. 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 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 Google Maps Platform 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ó rất nhiều lưu lượng truy cập. Tôi có thể sử dụng các sản phẩm của Google Maps Platform không?

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

Sau khi bạn có 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à lập hoá đơn như thế nào?

Mức sử dụng được tính vào cuối mỗi ngày và được tí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 trên Google Maps Platform.

Chi phí sử dụng Google Maps Platform là bao nhiêu?

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 số lượng yêu cầu hoặc số lượt tải bản đồ lên đến hạn mức sử dụng miễn phí trong một tháng nhất định, thì bạn sẽ không bị tính phí 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 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 trên Google Maps Platform.

Có giá 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 hỗ trợ trong bảng điều khiển. Khi bạn chọn một đơn vị tiền tệ khác, mức giá sẽ được quy đổi từ mức giá tương đương bằng USD được liệt kê trên 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 tính phí bạn vào đầu mỗi tháng cho hoạt động của tháng trước, bằng cách sử dụ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 trang Thanh toán trên 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 hạn mức yêu cầu hằng ngày và đặt hạn mức tối đa hằng ngày có thể tính phí. Bạn có thể đặt giới hạn hằng ngày tối đa cho mức sử dụng để bảo vệ khỏi tình trạng tăng đột biến ngoài dự kiến. 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í trên tài khoản thanh toán đạt đến 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 có số tiề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 biến. Bạn có thể thay đổi hạn mức này trong Cloud Console

Đặt và quản lý cảnh báo 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í trên tài khoản thanh toán đạt đến ngưỡng mà bạn đặt ra. Quản trị viên thanh toán sẽ nhận được thông báo qua email khi 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 Google Maps Platform" được tạo để giúp một số khách hàng chuyển sang gói giá trả tiền theo mức 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 một lần để họ có thể tiếp tục sử dụng Google Maps Platform trong hạn mức của cấp không tính phí. Sau khi vượt quá hạn mức này, tài khoản thanh toán sẽ bị đó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:

  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à đính kèm tài khoản thanh toán vào dự án, thì các API của Nền tảng Google 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 Google Maps Platform.

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

Tôi nhận được thông báo vi phạm về 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 điều khoản của Google, như được định nghĩa trong Điều khoản dịch vụ của Google Maps Platform. Theo các điều khoản này, bạn không được 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 liên quan đến tài khoản thanh toán.

Sử dụng Google Maps Platform

Tôi nên sử dụng khoá hoặc thông tin xác thực nào cho các sản phẩm Maps khác nhau?

Mỗi lần 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 ứng dụng Android, iOS hoặc ứng dụng 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 API bằng khoá: &key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo

Chữ ký số:

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

Hạn chế:

  • 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ả khoá API để tăng cường bảo mật. Hãy xem phần Các phương pháp hay nhất về bảo mật API để biết thêm chi tiết.
  • Bạn có thể thêm quy tắc hạn chế về ứ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ế đối với ứng dụng. Các API thực thi cùng một loại quy tắc hạn chế có thể sử dụng cùng một khoá bị hạn chế.
    • Địa chỉ IP (máy chủ riêng lẻ) – để sử dụng với API dịch vụ web.
    • Trang giới thiệu HTTP (trang web) – để sử dụng với API web.
    • Giới hạn ứng dụng Android (theo tên gói và vân tay số) – để sử dụng với Maps SDK cho Android.
    • Giới hạn ứng dụng iOS (theo mã nhận dạng gói iOS) – để sử dụng với SDK bản đồ dành cho iOS.
  • Bạn cũng có thể thêm một quy tắc hạn chế đối với API vào 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 các quy định hạn chế về khoá/thông tin xác thực và ứng dụng đối với từng API/SDK của Google Maps Platform.

API/SDK Thông tin xác thực và quy định hạn chế đối với ứng dụng
Maps SDK cho Android Khoá API có quy định hạn chế đối với Android1
SDK Địa điểm cho Android Khoá API có quy định hạn chế đối với Android1
Navigation SDK cho Android Khoá API có quy định hạn chế đối với Android1
SDK bản đồ dành cho iOS Khoá API có quy định hạn chế đối với iOS1
Places SDK cho iOS Khoá API có quy định hạn chế đối với iOS1
Navigation SDK cho iOS Khoá API có quy định hạn chế đối với iOS1
Maps JavaScript API Khoá API có quy định hạn chế về referer HTTP1
Map Tiles API Khoá API có quy định hạn chế về địa chỉ IP1
Maps Datasets API Mã thông báo OAuth
Aerial View API Khoá API có quy định hạn chế về địa chỉ IP1
Maps Static API Khoá API có quy định hạn chế về referer HTTP1 + Chữ ký số2
Street View Static API Khoá API có quy định hạn chế về referer HTTP1 + Chữ ký số2
Maps Embed API Khoá API có quy định hạn chế về referer HTTP1
Address Validation API Khoá API có quy định hạn chế về địa chỉ IP1
Elevation API Khoá API có quy định hạn chế về địa chỉ IP1
Geocoding API Khoá API có quy định hạn chế về địa chỉ IP1
Geolocation API Khoá API có quy định hạn chế về địa chỉ IP1
Places API Khoá API có quy định hạn chế về địa chỉ IP1
Places Aggregate API Khoá API có quy định hạn chế về địa chỉ IP1
Roads API Khoá API có quy định hạn chế về địa chỉ IP1
Routes API Khoá API có quy định hạn chế về địa chỉ IP1
Time Zone API Khoá API có quy định hạn chế về địa chỉ IP1
Air Quality API Khoá API có quy định hạn chế về địa chỉ IP1
Pollen API Khoá API có quy định hạn chế về địa chỉ IP1
Solar API Khoá API có quy định hạn chế về địa chỉ IP1
Weather API Khoá API có quy định 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ả 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ể cần phải có chữ ký số cho Maps Static API và Street View Static API. Bất kể mục đích sử dụng, bạn nên sử 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 quy tắc hạn chế đối với khoá từ quy tắc hạn chế về referer HTTP sang quy tắc hạn chế về đị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 có quy tắc hạn chế về referer, thì yêu cầu của bạn sẽ không thành công và xuất hiện thông báo lỗi: "Khoá API không được có quy tắc hạn chế về referer 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 bạn chuyển loại quy tắc hạn chế đối với khoá API từ liên kết giới thiệu HTTP 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ế theo IP. Các API có cùng loại quy tắc 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 quy định hạn chế, hãy thêm một khoá riêng biệt có quy định 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 Google Maps Platform.

Để chuyển khoá API có quy tắc hạn chế về referer 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 Giới hạn khoá của trang, hãy chọn "Địa chỉ IP (máy chủ web, dịch vụ chạy ngầm theo thời gian định trước, 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 để nhận khoá API mới?
Xem bài viết Bắt đầu sử dụng Google Maps Platform.
Làm cách nào để tìm các thay đổi được giới thiệu trong mỗi phiên bản của Google Maps API?

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

Bạn cũng có thể kiểm tra xem lỗi cụ thể được phát hiện và khắc phục trong phiên bản nào của Google Maps Platform bằng cách sử dụng Trình theo dõi sự cố của Google Maps Platform tại:

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

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

Bạn chỉ cần chỉ định tham số gọi lại 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 về API JavaScript của Maps.

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 các chế độ cài đặt của 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 cho 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 Hà Lan ở Nam Phi 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 Azerbaijani 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 Miến Điện 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
en 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 Farsi 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 Galicia sw Tiếng Swahili
ka Tiếng Gruzia sv Tiếng Thuỵ Điển
de Tiếng Đức ta Tiếng Tamil
el Chữ 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
is 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 giao diện của bản đồ bằng bất kỳ ngôn ngữ nào được liệt kê ở trên trong ứng dụng mẫu này.

Có thể truy cập vào 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 dịch vụ của Google Maps Platform qua HTTPS. Để đảm bảo ứng dụng của bạn hoạt động ổn định 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 cũ 1.0 và 1.1 không còn được dùng nữa.

Giao thức SSL không còn đượ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 Google Maps Platform 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 Google Maps Platform?

Nếu bạn gặp phải hành vi mà bạn cho rằng có thể 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 tính năng đó 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 lỗi mới hoặc chức năng hiện có của các sản phẩm trên Google Maps Platform không thể đáp ứng yêu cầu của bạn, hãy báo cáo lỗi hoặc yêu cầu về tính năng bằng Trình theo dõi sự cố của Google Maps Platform.

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

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

Maps SDK cho Android và SDK bản đồ dành cho iOS sử dụng cookie tuân 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 đang hoạt động hằng ngày và trong 7 ngày, cũng như ngăn chặn hành vi lạm dụng dịch vụ. Các 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 thu thập được từ các lệnh gọi API.

Tôi không thể 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ệ nhà phát triển của Google luôn có mặt trên Stack Overflow – một trang web hỏi và đáp được chỉnh sửa cộng tác dành cho các lập trình viên. Đây là một nơi tuyệt vời để đặ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ợ.

Để 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 trong các cuộc thảo luận hiện tại. Rất có thể 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 không thể xem mã đó 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ả thông tin khác có thể hữu ích trong việc khắc phục sự cố này.

Lỗi và cách khắc phục sự 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 API Google Maps, hãy xem các đường liên kết sau để tìm nội dung giải thích về mã lỗi:

My Maps của tôi có màu tối hơn bình thường. Chuyện gì đang xảy ra?

Trong một số trường hợp, bản đồ tối hoặc hình ảnh "âm bản" trong Chế độ xem đường phố, có hình mờ kèm theo 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 biết có vấn đề với khoá API hoặc thông tin thanh toán. Để sử dụng các sản phẩm của Google Maps Platform, bạn phải có tài khoản thanh toán và tất cả yêu cầu đều phải có 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 các mã lỗi: OVER_DAILY_LIMIT hoặc OVER_QUERY_LIMIT?
Những 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 được cung cấp không hợp lệ.
  • Dự án này chưa được liên kết với tài khoản thanh toán.
  • Bạn đã vượt quá hạn mức sử dụng do chính bạn đặt ra.
  • Phương thức thanh toán được 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ó tài khoản thanh toán và tất cả yêu cầu phải có 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 các mã lỗi: kGMSPlacesRateLimitExceeded hoặc 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
Nếu bạn 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 còn được dùng nữa của SDK Địa điểm cho Android hoặc SDK Địa điểm 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 để giải quyết 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 của mình, và một địa chỉ IP trái phép đang cố gắng gửi yêu cầu.
  • Bạn đã bật quy định hạn chế về 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 trái 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à vân tay số, đồng thời một ứng dụng Android trái phép đang cố gắng gửi 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 nhận dạng được đ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 có khoá API có các quy định hạn chế về referer HTTP. Các yêu cầu đến những API đó phải được xác định bằng 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ế về referer HTTP sang quy tắc hạn chế về địa chỉ IP. Để biết thêm thông tin về việc 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 chứa khoá API mà bạn muốn xem xét.
  3. Để xem thông tin chi tiết về thông tin xác thực, 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 xác thực đầ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 quy định hạn chế nếu cần.
Làm cách nào để giải quyết lỗi: "Không thể sử dụng khoá API có quy định hạn chế về referer 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ị giới hạn ở một liên kết giới thiệu HTTP. 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ề liên kết 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.

Các dịch vụ của Google Maps Platform

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 Google Maps Platform không?

Có, quy trình này được gọi là "mã hoá địa lý". API JavaScript của Maps 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, cung cấp giao diện REST có thể phản hồi ở định dạng JSON và XML.

Tính năng mã hoá địa lý được cung cấp ở những quốc gia nào?

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

Độ chính xác của các 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 đã tìm thấy kết quả khớp đủ tốt cho mục đích của ứng dụng hay chưa. Phạm vi cung cấp 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, phạm vi này có thể thay đổi.

Tại sao Bộ mã hoá địa lý của Google Maps Platform lại cung cấp thông tin 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). Bộ mã hoá địa lý của API thỉnh thoảng được cập nhật bằng 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 bộ 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 bộ 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:

  • 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.
  • đừng chỉ định các thành phần địa chỉ bổ sung như tên doanh nghiệp, số căn hộ, 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. Việc này có thể dẫn đến các câu trả lời có ZERO_RESULTS.
  • Định dạng Plus Codes như minh hoạ dưới đâ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 gồm 6 ký tự trở lên có vị trí rõ ràng (CWC8+R9 Mountain View, CA, USA là CWC8%2BR9%20Mountain%20View%20CA%20USA).
  • Sử dụng số nhà của một cơ sở thay vì tên toà nhà nếu có thể.
  • 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ư các đị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ý?

Bộ mã hoá địa lý của Google Maps Platform yêu cầu bạn phải chỉ định các đường cao tốc được đánh số của Hoa Kỳ trong địa chỉ như sau:

  • Đường quận: "Co Road NNN" trong đó NNN là số đường, ví dụ: "Co Road 82"
  • Đường cao tốc tiểu bang: "State NNN" trong đó State 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 bang ở Hoa Kỳ: "Interstate NNN" trong đó NNN là số đường cao tốc liên 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?

Hãy xem tài liệu: Chiến lược mã hoá địa lý, trong đó trình bày chi tiết các ưu điểm và hạn chế của từng chiến lược mã hoá địa lý.

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

Dịch vụ Compute Routes của Routes API cho phép bạn cung cấp đường lái xe cho các hành trình có một và nhiều chặng. Các lựa chọn định tuyến giúp bạn định hình đường đi bằng một phương tiện 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 có thu phí). Các dịch vụ này được cung cấp dưới dạng:

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

Tính năng chỉ đường lái xe được cung cấp ở những quốc gia nào?

Để xem các quốc gia được hỗ trợ tính năng chỉ đường lái xe trong các sản phẩm của Google Maps Platform, 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 về đường lái xe 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.

Đường đi bằng phương tiện công cộng được cung cấp ở những quốc gia nào?

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

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

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 sử dụng nhiều lần trong bản đồ.

Xin lưu ý rằng URL của 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 có thể được chỉ định dựa trên số chữ số thập phân được sử dụng khi chỉ định từng cặp vĩ độ/kinh độ. Để biết thông tin về mối liên hệ giữa số chữ số thập phân được sử dụng với độ 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 API Maps ở Lãnh thổ bị cấm. Vui lòng tham khảo cả Đ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 về thông tin bản đồ không chính xác hoặc bị thiếu, 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 không chính xác về tuyến đường một chiều và tuyến đườ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 trang thông tin của một địa điểm hoặc doanh nghiệp, hãy đề xuất chỉnh sửa.

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

Đối với các yêu cầu quan trọng hoặc khẩn cấp, hãy gửi yêu cầu hỗ trợ kèm theo thông tin chi tiết cụ thể về những vấn đề cần khắc phục.

Hiệu suất được giám sát như thế nào đối với các dịch vụ được dùng với API JavaScript của Maps?

Một số tính năng phía máy khách được trang bị để báo cáo thành công hoặc thất bại nhằm mục đích tính toán SLO (Mục tiêu mức độ dịch vụ). Thông tin này được gửi đến Google lúc maps.googleapis.com/maps_api_js_slo/log trong các cuộc gọi ghi lại thông tin 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 Maps JavaScript API đang được sử dụng. Các lệnh gọi có thể được gộp lại để cải thiện 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; bằng tiêu đề HTTP hoặc <meta http-equiv="Content-Security-Policy" content="default-src 'self' maps.googleapis.com;"> bằng thẻ meta HTML.

API JavaScript cho Maps

Maps JavaScript API 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 5 ngày một lần.

SDK Google Maps dành 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 còn được 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 hoạt động 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. Xem hướng dẫn di chuyển để biết thông tin chi tiết.
Tôi gặp sự cố 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 sự cố 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 lược đồ 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 Edit... (Chỉnh sửa...).
  3. Đặt tuỳ chọn GPU Frame Capture (Chụp khung hình GPU) thành Disabled (Tắt). Xin lưu ý rằng không phải thiết bị nào cũng có lựa chọn này.
Tuỳ chọn Xcode GPU Frame Capture (Chụp khung hình GPU Xcode) trên trang thiết bị iOS chung
Màn hình bo tròn và rộng hơn có tác động gì đến SDK Google Maps dành cho iOS?

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

SDK Google Maps dành cho iOS có nhiều thành phần và chế độ điều khiển hình ảnh, chẳng hạn như bộ chọn trong nhà và đường liên kết báo cáo vấn đề. Với phiên bản 2.4, các thành phần và chế độ điều khiển hình ảnh 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 tầng trong nhà có thể bị cắt bớt do tai thỏ hoặc chỉ báo nút màn hình chính.

Với bản phát hành SDK Google Maps dành cho iOS 2.5, các vấn đề về bố cục này sẽ tự động được 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 thành phần hình ảnh không bị cắt bớt.

Theo mặc định, chúng tôi sẽ luôn đưa khoảng đệm của bạn vào. SDK Google Maps dành cho iOS giả định rằng khoảng đệm được dùng để đệm từ 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ì giao diện 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ó tên 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 GMSMapView được đặt để sử dụng hành vi khoảng đệm "Luôn luôn", thì chế độ này 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ì chế độ này sẽ luôn chọn khoảng đệm lớn hơn hoặc phần lồng ghép vùng an toàn. Chế độ cài đặt này cho phép bạn thêm khoảng đệm từ cạnh màn hình, đồng thời đảm bảo rằng tất cả phần tử đều nằm trong vùng an toàn.

Nếu GMSMapView được đặt để sử dụng hành vi khoảng đệm "Never" (Không bao giờ), thì GMSMapView sẽ không bao giờ thêm phần lồng ghép vùng an toàn vào khoảng đệm. Đây là hành vi trước bản phát hành 2.5 và có thể hữu ích nếu khoảng đệm của bạn đã xem xét 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 có trách nhiệm đảm bảo rằng biểu trưng Google và thông báo bản quyền luôn hiển thị, như được nêu trong Điều khoản dịch vụ của Google Maps Platform.

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 thành phần hình ảnh đều nằm trong vùng an toàn.

SDK Google Maps 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. 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. 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 các ô màu xám trống thay vì bản đồ. Làm cách nào để giải quyết vấn đề này?

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

  1. Đảm bảo bạn đã cài đặt adb. Nếu chưa, bạn có thể làm theo hướng dẫn về Android adb.
  2. Cài đặt ứng dụng gặp vấn đề trên 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 chế độ cài đặt trình mô phỏng có bao gồm Cửa hàng Play.
  3. Trong thiết bị đầu cuối của Android Studio, hãy chạy adb logcat -e "Google Maps Android API". Thao tác này sẽ chỉ in các dòng có thông điệp nhật ký khớp với "Google Maps Android API" (Nếu muốn, 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, chẳng hạn như:
    • Khoá API sai/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 trong 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 của Dịch vụ Google Play không có trong tệp build.gradle.
Có cần tăng tốc phần cứng cho SDK Google Maps cho Android không?
Có, bạn phải đặt hardwareAccelerated thành true trong tệp AndroidManifest.xml của ứng dụng để tránh gặp vấn đề khi tải bản đồ.
Để biết thêm thông tin, hãy xem trang Tăng tốc phần cứng trong tài liệu dành cho nhà phát triển Android.

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àm lộ khoá bí mật ký URL cho người dùng cuối. Do đó, chữ ký chỉ nên được tạo bởi các thành phần phía máy chủ.

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

Phản hồi HTTP 403 cho biết 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. Chữ ký đã được chỉ định nhưng 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 Google Maps Platform nhưng không chỉ định chữ ký và dịch vụ được gọi yêu cầu các yêu cầu được thực hiện bằng khoá API phải bao gồm chữ ký hợp lệ.
  3. Bạn đã chỉ định chữ ký nhưng chưa chỉ định khoá API Google Maps Platform Gói cao cấp liên kết.