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à thanh toán

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

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

Dịch vụ nền tảng Google Maps

API JavaScript cho Maps

SDK Google Maps dành cho iOS

SDK Google Maps 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 bộ API và SDK cho phép các nhà phát triển nhúng Google Maps vào các trang web và ứng dụng dành cho thiết bị di động, hoặc lấy dữ liệu từ Google Maps. Có nhiều ưu đãi. Tuỳ thuộc vào nhu cầu của mình, bạn có thể tự sử dụng một hoặc kết hợp các API và SDK này:

Bản đồ:

Tuyến đường:

Địa điểm:

Làm cách nào để bắt đầu với Nền tảng Google Maps?

Xem bài viết Bắt đầu với 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 yêu cầu về chức năng của bạn, hãy xem bộ chọn API.

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

Xem hướng dẫn Tổng quan, Nhà phát triển và Bắt đầu cho API hoặc SDK cụ thể mà bạn quan tâm. Ví dụ: tham khảo hướng dẫn cho SDK Maps dành cho Android hoặc API JavaScript của Maps.

Nền tảng Google Maps bao gồm những quốc gia nào?

Nhóm Google Maps liên tục đẩy mạnh dữ liệu bản đồ mới và tăng phạm vi phủ sóng quốc tế. Hãy tham khảo Dữ liệu về phạm vi bao phủ của Google Maps để biết thông tin mới nhất về phạm vi bao phủ. Bạn có thể lọc dữ liệu bằng hộp bộ lọc ở đầu trang. Xin lưu ý rằng dữ liệu về phạm vi bao phủ có thể thay đổi nếu các 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 Nền tảng Google Maps không?

Có. Google Maps giờ đây cung cấp khả năng nhúng bản đồ mà bạn đang xem vào trang web hoặc blog 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 ứng dụng Maps trên thiết bị di động?

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

Để kết hợp bản đồ trong một ứng dụng iOS gốc, hãy sử dụng SDK Maps cho iOS.

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

Đối với các ứng dụng nhắm đến các thiết bị không phù hợp để sử dụng API Maps JavaScript, Maps Static API sẽ phân phối hình ảnh bản đồ ở định dạng GIF, JPG và PNG, bao gồm điểm đánh dấu và hình nhiều đường. Lưu ý rằng việc sử dụng API tĩnh của Google Maps 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 cho Maps và API Nhúng của Maps hỗ trợ những trình duyệt web nào?

API Maps JavaScript và API nhúng của Maps 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 ổ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 trên thiết bị di động trên các phiên bản chính hiện tại và trước đây 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ừ API Maps JavaScript không?

Không hỗ trợ in từ API Maps JavaScript. Lý do là 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 được thông báo khi có thay đổi đối với sản phẩm của Nền tảng Google Maps?

Bạn nên đăng ký Blog của Nền tảng Google Maps để nhận tin tức cập nhật trên các sản phẩm khác nhau của nhà phát triển Google Geo.

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

Xem phần Tài nguyên và dịch vụ hỗ trợ của Nền tảng Google Maps để biết thông tin về các phương án hỗ trợ hiện có.

Khi nào có thể hỗ trợ kỹ thuật?
Nhóm hỗ trợ làm việc 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), ngoại trừ các ngày lễ theo 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 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 tài khoản bằng cách truy xuất hoặc đặt lại mật khẩu của mình. Hãy xem bài viết Cách khôi phục Tài khoản Google hoặc Gmail trong trang Trợ giúp về Tài khoản Google.

  • Lưu ý: Để khôi phục quyền truy cập vào tài khoản G Suite, hãy yêu cầu quản trị viên Tổ chức của bạn hủy tài khoản.
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, thì bạn có thể thử khôi phục dự án đó.

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à Địa điểm dành cho iOS trên các máy Mac sử dụng tính năng Arm?

Bạn có thể phát triển trên các máy Mac sử dụng Arm mới, tuy nhiên, bạ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 quá trình chúng tôi xem xét hỗ trợ thêm cho việc phát triển các trình mô phỏng.

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

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

Điều khoản dịch vụ của Nền tảng Google Maps có sẵn 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ố mục đích sử dụng Nền tảng Google Maps mà chúng tôi chỉ không muốn thấy: bản đồ xác định các địa điểm mua thuốc bất hợp pháp trong 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, 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 tham khảo ý kiến của tư vấn riêng của mình để xác định xem ứng dụng có tuân thủ Điều khoản dịch vụ của Nền tảng Google Maps hay không trước khi bạn triển khai và phát hành ứng dụng đó. Kỹ sư Google chỉ có thể hỗ trợ kỹ thuật và không đủ điều kiện tư vấ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ụ này bất cứ lúc nào, vì vậy, hãy đọc kỹ Điều khoản về API của Maps.

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

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

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

Không có quy định hạn chế nào đối với việc hiển thị dữ liệu (theo dõi) theo thời gian thực thông qua các sản phẩm 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 trên Web không?

Có, giờ đây bạn có thể sử dụng các sản phẩm Google Maps Platform trên các ứng dụng không phải Web, miễn là những 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.

API Maps JavaScript chỉ được hỗ trợ khi chạy ở 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ới các ứng dụng 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 chi tiết.

Tôi có thể tạo ứng dụng bao gồm dữ liệu Nền tảng Google Maps trong một tài liệu không?

Nếu ứng dụng của bạn tạo một tài liệu, dưới dạng điện tử hoặc in, thì không có dữ liệu nào từ Nền tảng Google Maps, bao gồm cả hình ảnh, có thể được đưa vào tài liệu đó. Vui lòng xem phần Điều khoản dịch vụ của Nền tảng Google Maps "Không cóp nhặt" để biết thêm chi tiết.

Làm cách nào để chọn không đưa nội dung của tôi vào các 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 thông số indexing đã ngừng hoạt độ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, nhưng bạn nên xoá thông số này 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 của chúng tôi trong trung tâm trợ giúp dành cho quản trị viên trang web.

Tôi có thể tạo hình ảnh bản đồ bằng cách sử dụng API Maps tĩnh 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 các hình ảnh được tạo bằng API Maps tĩnh trên 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 API Maps tĩnh để tất cả hình ảnh bản đồ đều được 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 với Nền tảng Google Maps.
Khách hàng nhận cấp bậc miễn phí của Google Cloud Platform nâng cấp lên tài khoản trả phí bằng cách nào?
Chương trình Cấp độ Google Cloud Platform miễn phí cung cấp cho khách hàng bản dùng thử miễn phí trị giá 300 đô la để sử dụng với bất kỳ dịch vụ nào của Google Cloud Platform (GCP), bao gồm cả API Google Maps Platform (GMP). Khi hết thời gian dùng thử miễn phí, 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 có tính phí, hãy truy cập vào Cloud Console.
Nền tảng Google Maps có giới hạn 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 mà bạn có thể thực hiện với các sản phẩm Nền tảng Google Maps 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 giây (QPS) hoặc số truy vấn mỗi phút (QPM).

Đối với Ma trận khoảng cách, giới hạn này được đặt theo số sự kiện trên mỗi giây (EPS) được tính bằng tổng số lượt truy vấn phía máy khách và phía máy chủ.

Đối với Tuyến đường:Ma trận tuyến tính, giới hạn là trong các phần tử mỗi phút (EPM), trong đó số lượng phần tử trong một yêu cầu bằng: (số điểm gốc × số đích).

Bảng sau đây trình bày hạn mức sử dụng cho từng API.

API Hạn mức sử dụng
Xác thực địa chỉ 6000 QPM
Cách tìm 50 QPS
Ma trận khoảng cách 1000 EPS
Bản đồ linh động 500 QPS (số lần truy vấn mỗi giây)
Độ nâng 100 QPS
Mã hóa địa lý 50 QPS
Vị trí địa lý 100 QPS
Địa điểm 100 QPS
Đường 500 QPS
Tuyến đường: Tuyến tính 3000 QPM
Tuyến đường: Ma trận tuyến tính 3000 EPM
Bản đồ tĩnh 500 QPS
API hình ảnh chế độ xem đường phố 500 QPS
Time Zone (Múi giờ) 500 QPS

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

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

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

Để biết thông tin tổng quan về cách định giá cho các sản phẩm trên Google Maps Platform, vui lòng xem Bảng giá.

Để tìm hiểu thêm về cách tính phí vào API của Nền tảng Google Maps, vui lòng xem phần Tìm hiểu về việc thanh toán cho Maps, Tuyến đường và Địa điểm.

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

Một lượt tải bản đồ được tính khi diễn ra bất kỳ trường hợp nào sau đây:

  • Trang web hoặc ứng dụng sẽ hiển thị bản đồ bằng cách sử dụng API JavaScript của Maps.
  • Một ứng dụng yêu cầu một hình ảnh bản đồ từ API Maps tĩnh.

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

  • Ảnh toàn cảnh tĩnh của Chế độ xem phố được tính cho mỗi yêu cầu đối với Chế độ xem phố tĩnh API để nhúng ảnh toàn cảnh tĩnh (không tương tác).
  • Ảnh toàn cảnh động của Chế độ xem phố được tính phí cho mỗi bản sao của đối tượng toàn cảnh trong API Maps JavaScript, SDK bản đồ dành cho Android hoặc SDK bản đồ dành cho ứng dụng 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 của Chế độ xem phố, thì mọi hoạt động tương tác của người dùng với bản đồ đó, chẳng hạn như kéo (hình ảnh), thu phóng hoặc chuyển đổi lớp bản đồ sẽ 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ể tạo ra khoản 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 để giám sát mức sử dụng của tôi?

Bạn có thể theo dõi việc sử dụng từng API trong Google Cloud Console.

  1. Chọn dự án chứa API 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 Định 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. Hãy thiết lập thông tin thanh toán nếu bạn chưa làm việc này.
  2. Truy cập vào 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. Hãy sử dụng bộ lọc ở 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 nền tảng Google Maps cũng như phần Theo dõi mức sử dụng APIGiới hạn mức sử dụng API.

Điều gì sẽ xảy ra nếu tôi vượt quá giới hạn tỷ lệ yêu cầu (QPS)?

Nếu bạn vượt quá giới hạn QPS của một sản phẩm Google Maps Platform, thì API sẽ trả về một thông báo lỗi. Nếu bạn liên tục vượt quá giới hạn nhiều lầ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 QPS của yêu cầu hoặc nếu không sử dụng dịch vụ, 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á giới hạn, quyền truy cập của bạn vào Nền tảng Google Maps có thể bị chặn.

Lưu ý: Bốn trong số các API dịch vụ web có một dịch vụ tương đương phía máy khách có sẵn trong API Maps JavaScript: Đường đi, Ma trận khoảng cách, Độ caoMã hóa đị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.

Điều này có nghĩa là dịch vụ web sẽ 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 lại. Điều này có thể xảy ra trong vòng vài giây, nếu lỗi xảy ra do ứng dụng của bạn gửi quá nhiều yêu cầu mỗi giây.

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

Trang web của tôi nhận đượ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 làm quen với các giới hạn sử dụng của 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ó tài khoản thanh toán, nếu vượt quá hạn mức sử dụng miễn phí 200 đô la mỗi tháng và bạn không có phương thức thanh toán hợp lệ trong tài khoản thanh toán (thẻ tín dụng, chuyển khoản ngân hàng, v.v.), thì API sẽ ngừng hoạt động cho đến khi bạn thêm phương thức thanh toán hợp lệ.

Việc tính toán và sử dụng sẽ được tính như thế nào?

Mức sử dụng được tính toán vào cuối mỗi ngày và được định giá như nêu trong Trang tính giá. Vào cuối mỗi tháng, tổng mức sử dụng sẽ được tính cho phương thức thanh toán được 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 bài viết Thanh toán trên 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í mỗi API. Nếu ứng dụng của bạn tạo ra các yêu cầu hoặc lưu lượng tải bản đồ lên tới 200 USD mỗi tháng, thì mức sử dụng của bạn sẽ không bị tính. Mức sử dụng vượt quá 200 đô la/tháng 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 hướng dẫn của chúng tôi để hiểu về việc thanh toán trên Nền tảng Google Maps.

Giá có sẵn bằng các đơn vị tiền tệ khác không?

Đơn vị tiền tệ bổ sung có thể có trong bảng điều khiển. Khi bạn chọn một đơn vị tiền tệ khác, giá sẽ quy đổi từ giá tương đương USD nêu trong Trang tính 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 của tôi?

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 cách sử dụng phương thức thanh toán đã chỉ định. Để biết thông tin chi tiết về hoá đơn của bạn, hãy xem hướng dẫn của chúng tôi để hiểu về thanh toán trên Nền tảng Google Maps.

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 giới hạn yêu cầu hàng ngày và đặt giới hạn tối đa có thể lập hóa đơn hằng ngày. Bạn có thể áp dụng giới hạn sử dụng tối đa hằng ngày để tránh mức tăng không mong muốn. Bạn cũng có thể đặt thông báo 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 bạn đặt.

Giới hạn hạn mức có thể lập hoá đơn hằng ngày tối đa:

Để tránh bị tính phí nhiều, bạn có thể đặt giới hạn sử dụng hằng ngày để tránh việc mức sử dụng tăng đột biến. Bạn có thể thay đổi giới hạn này trong Cloud Console bằng cách làm theo các bước sau:

  1. Truy cập vào Trang tổng quan về API và dịch vụ.
  2. Chọn một dự án nếu được nhắc.
  3. Chọn một API từ danh sách, sau đó nhấp vào thẻ Định mức.
  4. Nhấp vào biểu tượng chỉnh sửa bên cạnh hạn mức "yêu cầu mỗi ngày".

Ngoài ra, bạn có thể chỉnh sửa nhiều hạn mức cho nhiều API bằng cách sử dụng trang tổng quan Hạn mức IAM và quản trị viên.

Đặt và quản lý cảnh báo ngân sách:

Thiết lập cảnh báo 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 bạn đặt. Quản trị viên thanh toán sẽ nhận được thông báo qua email khi mức 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 rằng dự án của tôi được liên kết với "Tài khoản chuyển đổi nền tảng Google Maps", 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 trên Nền tảng Google Maps" được tạo để giúp một số khách hàng chuyển đổi sang gói giá thanh toán mới khi bạn di chuyển. 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 Nền tảng Google Maps với mức giới hạn miễn phí là 200 đô la. Sau khi vượt quá giới hạn 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ụ này. Để tránh bị gián đoạn dịch vụ, bạn nên đặt tài khoản thanh toán của riêng mình và tiếp tục tận hưởng mức phí miễn phí là 200 đô la mỗi 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 giới hạn 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, API Maps Platform của bạn sẽ bị giới hạn ở 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 tài khoản thanh toán. Để làm điều này, hãy xem Bắt đầu với Nền tảng Google Maps.

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ị xóa. Bạn có thể quyết định đặt giới hạn để ngăn chặn mức chi tiêu không mong muốn trong Cloud Console.

Tôi đã nhận một thông báo vi phạm về 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, như được định nghĩa trong phần 3.2.4 của Điều khoản dịch vụ của Nền tảng Google Maps. Theo những đ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 phần Câu hỏi thường gặp về lỗi vi phạm về Tài khoản thanh toán.

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

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

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

Khoá API:

  • Khoá API là 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 bí mật ký URL do Google cung cấp cho bạn. Chữ ký số được sử dụng với API Maps tĩnh và API tĩnh của Chế độ xem phố.

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

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

Bảng bên dưới cho biết các quy định hạn chế đối với khoá/thông tin xác thực và ứng dụng đối với mỗi API/SDK nền tảng Google Maps.

API/SDK Quy định hạn chế về thông tin đăng nhập và ứng dụng
SDK Maps dành cho Android Khoá API có hạn chế Android1
Địa điểm SDK cho Android Khoá API có hạn chế Android1
SDK Maps dành cho iOS Khoá API có quy định hạn chế trên iOS1
Địa điểm SDK cho iOS Khoá API có quy định hạn chế trên iOS1
API JavaScript của Maps Khoá API có quy định hạn chế tham chiếu HTTP1
API Maps tĩnh Khoá API có quy định hạn chế tham chiếu HTTP1 + Chữ ký số2
API tĩnh của Chế độ xem phố Khoá API có quy định hạn chế tham chiếu HTTP1 + Chữ ký số2
API Nhúng của Maps Khoá API có quy định hạn chế tham chiếu HTTP1
API Xác thực địa chỉ Khoá API có giới hạn địa chỉ IP1
API Chỉ đường Khoá API có giới hạn địa chỉ IP1
API ma trận khoảng cách Khoá API có giới hạn địa chỉ IP1
API độ cao Khoá API có giới hạn địa chỉ IP1
API mã hóa địa lý Khoá API có giới hạn địa chỉ IP1
API vị trí địa lý Khoá API có giới hạn địa chỉ IP1
API Địa điểm Khoá API có giới hạn địa chỉ IP1
API đường Khoá API có giới hạn địa chỉ IP1
API Tuyến đường Khoá API có giới hạn địa chỉ IP1
API múi giờ Khoá API có giới hạn địa chỉ IP1
1 Cá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 cách sử dụng, chữ ký số có thể bắt buộc phải có trong API tĩnh của MapsAPI tĩnh của Chế độ xem phố. Bất kể sử dụng loại nào, 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 hạn chế khoá của tôi từ 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 có các quy định hạn chế về tham chiếu, thì yêu cầu của bạn sẽ không thành công với thông báo lỗi: "Khoá API không thể có hạn chế về tham chiếu khi sử dụng với API này". Bạn nên chuyển sang sử dụng khoá API có các hạn chế về địa chỉ IP.

Trước khi bạn chuyển loại quy tắc hạn chế khoá API từ tệp tham chiế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 giới hạn 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 quy định hạn chế, hãy thêm một khoá riêng với cá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 Nền tảng Google Maps.

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

  1. Truy cập vào trang Thông tin xác thực 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 về khoá.
  4. Trong phần Hạn chế đối với khoá của trang, hãy chọn “Địa chỉ IP (máy chủ web, lệnh cron, v.v.)” và chèn địa chỉ IP của máy chủ thích hợp, rồi 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 với Nền tảng Google Maps.
Làm cách nào để tìm những thay đổi được giới thiệu trong từng phiên bản của API Google Maps?

Thông tin thay đổi phiên bản của nhiều API Maps có sẵn 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 ra mắt và khắc phục bằng cách sử dụng Công cụ theo dõi lỗi 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 đó được tải?

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

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

Theo mặc định, API này sẽ cố gắng tải ngôn ngữ phù hợp nhất dựa trên vị trí của người dùng hoặc chế độ cài đặt của trình duyệt. Một số API cho phép bạn đặt ngôn ngữ rõ ràng khi bạn 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 cập nhật các ngôn ngữ được hỗ trợ. Danh sách này có thể không phải là danh sách đầ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 Maratha
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) no 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 (Braxin)
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 Romania
en-AU Tiếng Anh (Úc) ru Tiếng Nga
en-GB Tiếng Anh (Anh) sr Tiếng Serbia
et Tiếng Estonia si Tiếng Sinhala
fa Tiếng Farsi sk Tiếng Slovakia
fi Tiếng Phần Lan sl Tiếng Sloven
fil Tiếng Philippines es Tiếng Tây Ban Nha
fr Tiếng Pháp es-419 Tiếng Tây Ban Nha (Mỹ Latinh)
fr-CA Tiếng Pháp (Canada) sw Tiếng Swahili
gl Tiếng Galic sv Tiếng Thuỵ Điển
ka Tiếng Gruzia ta Tiếng Tamil
de Tiếng Đức te Tiếng Telugu
el Tiếng Hy Lạp th Tiếng Thái
gu Tiếng Gujarat tr Tiếng Thổ Nhĩ Kỳ
iw Tiếng Do Thái uk Tiếng Ukraina
hi Tiếng Hindi ur Tiếng Urdu
hu Tiếng Hungary uz Tiếng Uzbek
Tiếng Iceland vi Tiếng Việt
id Tiếng Indonesia zu Tiếng Zulu
it Tiếng Ý

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 Nền tảng Google Maps qua SSL (HTTPS) không?

Bạn có thể truy cập API Maps JavaScript, API Maps tĩnh và API dịch vụ web qua các kết nối bảo mật (HTTPS). Vui lòng xem tài liệu về API liên quan đến thông tin về cách truy cập API qua SSL.

Lưu ý rằng API tĩnh của Maps không hỗ trợ các URL biểu tượng tuỳ chỉnh sử dụng HTTPS; biểu tượng mặc định sẽ được hiển thị.

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

Nếu bạn gặp hành vi mà bạn cho rằng có thể là lỗi, vui lòng bắt đầu bằng cách phản hồi 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ã.

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

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

Trước khi thêm lỗi hoặc yêu cầu tính năng vào Công cụ theo dõi lỗi, 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 vào. Nếu có, bạn có thể gắn dấu sao cho vấn đề đó để cho chúng tôi biết rằng bạn quan tâm và nhận được thông báo về nội dung cập nhật.

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

SDK Maps dành cho Android và SDK Maps 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 hoạt động hằng ngày và số người dùng hoạt động trong 7 ngày cũng như biện pháp ngăn chặn hành vi sử dụng dịch vụ. Các cookie này không được 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 với thông tin còn lại được thu thập từ các lệnh gọi API.

Tôi không tìm được câu trả lời cho thắc mắc 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 duy trì sự hiện diện trên Stack Overflow, đây là một trang web được cộng tác và chỉnh sửa 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ì ứng dụng Google Maps. Bạn có thể tìm thêm thông tin về cách đặt câu hỏi trên Stack Overflow trên trang Support (Hỗ trợ).

Để nhận đượ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. Có thể ai đó đã gặp phải vấn đề tương tự và đã tìm thấy 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 các đoạn mã nếu mã không dễ xem được trên mạng.
  • Hãy cung cấp tất cả thông tin liên quan, bao gồm cả cá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 trong khi tải hoặc chạy API Google Maps, vui lòng 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 hiển thị tối hơn bình thường. Chuyện gì đang xảy ra?

Trong một số trường hợp nhất định, bản đồ tối hoặc hình ảnh "Chế độ xem phố" phủ định, có hình mờ với văn bản "chỉ dành cho mục đích phát triển". Hành vi này thường cho thấy các vấn đề về khoá API hoặc thông tin thanh toán. Để sử dụng các sản phẩm của Nền tảng Google Maps, bạn phải có tài khoản thanh toán và tất cả yêu cầu phải bao gồm một khoá API hợp lệ. Quy trình sau sẽ giúp khắc phục sự cố này:


Làm cách nào để xử lý các mã lỗi: OVER_DAILY_LIMIT hoặc OVER_QUERY_LIMIT?
Bạn có thể trả về những mã lỗi này vì bất kỳ lý do nào sau đây:
  • Yêu cầu bị 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.
  • Đã vượt quá giới hạn sử dụng tự đặt.
  • Phương thức thanh toá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á giới hạn QPS cho một API nhất định.

Để sử dụng các sản phẩm của Nền tảng Google Maps, bạn phải có tài khoản thanh toán và tất cả yêu cầu phải bao gồm một khóa 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 để xử lý 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, bạn có thể đang sử dụng phiên bản SDK địa điểm không dành cho Android hoặc SDK địa điểm dành 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: "Ứng dụng dành cho thiết bị di động, trang web hoặc IP này không được phép sử dụng khoá API này".

Có nhiều tình huống có thể gây ra lỗi này:

  • Bạn đã bật các quy định hạn chế về địa chỉ IP (máy chủ) trên khoá API và một địa chỉ IP trái phép đang cố yêu cầu.
  • Bạn đã bật các quy định 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 đường liên kết giới thiệu trái phép đang cố yêu cầu.
  • Bạn đã hạn chế việc sử dụng các ứng dụng Android bằng cách đặt tên gói và vân tay, đồng thời một ứng dụng Android trái phép đang cố yêu cầu.
  • Bạn đã hạn chế các yêu cầu của ứ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 gửi yêu cầu.
  • Bạn từng 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ế đối với giới thiệu HTTP. Bạn phải xác định yêu cầu đối với các API đó bằng một khoá API có quy định hạn chế về địa chỉ IP. Chuyển loại hạn chế chính của bạn từ hạn chế tham chiếu HTTP sang hạn chế địa chỉ IP. Để biết thêm thông tin về việc hạn chế các khoá API, hãy xem Các phương pháp hay nhất về khoá API.

Xem và chỉnh sửa thông tin đăng nhập cho API của bạn

Để xem khoá API của bạn và quản lý mọi quy định hạn chế, hãy làm như sau:

  1. Truy cập vào trang Thông tin xác thực trong Cloud Console.
  2. Chọn dự án chứa khoá API mà bạn muốn xem xét.
  3. Để xem thông tin xác thực (bao gồm cả mọi quy định hạn chế được thiết lập đối với khoá), trong danh sách khoá API, hãy nhấp vào tên khoá.
  4. Thông tin xác thực đầy đủ cho khoá API đã chọn được hiển thị, bao gồm mọi quy định 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 để khắc phục lỗi: "Không thể sử dụng khoá API có các quy định hạn chế tham chiế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 tệp tham chiếu HTTP. Vì lý do bảo mật, API dịch vụ web cần sử dụng khoá API bị hạn chế ở địa chỉ IP. Chuyển loại quy định hạn chế đối với khoá của bạn từ quy định hạn chế tham chiếu HTTP sang quy định hạn chế về địa chỉ IP hoặc tạo khoá API mới nếu khoá của bạn đã được sử dụng với API Maps JavaScript.

Dịch vụ 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ó, quá trình này được gọi là "mã hóa địa lý". API JavaScript của Maps bao gồm một lớp để thực hiện dịch vụ mã hóa địa lý. Lớp này là: google.maps.Geocoder.

Ngoài ra, Google cũng cung cấp API mã hoá địa lý, cung cấp giao diện REST có thể phản hồi ở định dạng JSON và XML.

Mã hóa địa lý có sẵn ở những quốc gia nào?

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

Độ chính xác của các vị trí được mã hóa địa lý có thể khác nhau tùy theo quốc gia. Vì vậy, bạn nên xem xét sử dụng trường location_type được trả về để xác định xem hệ thống đã tìm thấy kết quả khớp phù hợp cho mục đích của ứng dụng hay chưa. Xin lưu ý rằ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 nhà cung cấp dữ liệu, vì vậy, dữ liệu này có thể thay đổi.

Tại sao Bộ mã hoá địa lý của Nền tảng Google Maps cung cấp vị trí khác với vị trí của 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ý API thỉnh thoảng đượ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 mã hoá địa lý của mình như thế nào để tăng tối đa 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 mã hoá địa lý theo những nguyên tắc sau để tăng tối đa khả năng truy vấn thành công:

  • Hãy chỉ định các địa chỉ theo định dạng mà dịch vụ bưu chính quốc gia của quốc gia có 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ố đơ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 ở quốc gia có liên quan. Việc này có thể dẫn đến các phản hồi bằng ZERO_RESULTS.
  • Định dạng mã cộng như minh họa ở đây (dấu cộng là ký tự thoát URL cho %2B và dấu cách là ký tự thoát URL cho %20):
    • mã toàn cầu là mã vùng gồm 4 ký tự và mã cục bộ dài 6 ký tự trở lên (849VCWC8+R9 là 849VCWC8%2BR9).
    • mã phức hợp là mã địa phương dài 6 ký tự trở lên có vị trí rõ ràng (CWC8+R9 Mountain View, CA, Hoa Kỳ là CWC8%2BR9%20Mountain%20View%20CA%20USA).
  • Sử dụng số nhà trên cơ sở của tên toà nhà (nếu có) thay vì tên toà nhà nếu có thể.
  • Hãy ưu tiên sử dụng địa chỉ đường phố để 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ý Nền tảng Google Maps yêu cầu các đường cao tốc được đánh số của Hoa Kỳ phải được chỉ định trong các địa chỉ như sau:

  • Quốc lộ: "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ỳ: "U.S. NNN", trong đó NNN là số đường cao tốc. Ví dụ: "U.S. 101"
  • Liên tiểu bang Hoa Kỳ: "Interstate NNN" trong đó NNN là số liên tiểu bang. Ví dụ: "Interstate 280"
Khi nào tôi nên sử dụng lớp 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 đó nêu chi tiết ưu và nhược điểm của các chiến lược mã hoá địa lý.

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

Dịch vụ Tuyến đường điện toán của API Tuyến đườngAPI Chỉ đường cho phép bạn cung cấp thông tin chỉ đường lái xe cho các hành trình một chân và nhiều chặng. Các lựa chọn định tuyến giúp bạn định hướng đường đi bằng chế độ đi lại (lái xe), một tuyến đường hoặc một bộ tuyến đường và các hạn chế (không có đường có thu phí). Những dịch vụ này có sẵn ở các dạng sau:

  • Yêu cầu HTTP/giao diện phản hồi (dùng trong thiết bị di động và các ứng dụng khác) tương thích với SDK Maps dành cho Android và các dịch vụ web khác của Google Maps.
  • API JavaScript, đối với các ứng dụng phía máy khách, cho phép bạn cung cấp thông tin chỉ đường lái xe thông qua lớp google.maps.DirectionsService. Lớp DirectionsRenderer có thể tự động tạo lớp phủ và bảng điều hướng cho bạn. Các ví dụ khác được cung cấp trong tài liệu.
  • Giao diện khách hàng Java, Python, go và Node.js, đối với các ứng dụng phía máy chủ, cung cấp chức năng tương tự. Để biết thêm thông tin về thư viện ứng dụng, hãy xem phần Thư viện ứng dụng API Chỉ đường.
Quốc gia nào hỗ trợ tính năng chỉ đường lái xe?

Để xem những quốc gia hiện được hỗ trợ bằng cách chỉ đường lái xe trong các sản phẩm Nền tảng Google Maps, hãy tham khảo dữ liệu về phạm vi bao phủ của Google Maps. Xin lưu ý rằng tình trạng cung cấp dữ liệu chỉ đườ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.

Chỉ đường chuyển tuyến có sẵn ở những quốc gia nào?

API Chỉ đườngAPI Ma trận khoảng cách hỗ trợ tất cả các đối tác Phương tiện công cộng của Google, ngoại trừ những đối tác ở Nhật Bản.

Tính năng KML và GeoRSS được hỗ trợ trong API JavaScript cho Maps?

Lớp KmlLayer trong API JavaScript của Maps cho phép các nhà phát triển phủ các tệp KML/KMZ và GeoRSS lên đầu bản đồ. Bạn có thể tham khảo tài liệu và ví dụ tại đây.

Có thể hiển thị những giới hạn nào về kích thước và độ phức tạp của KML bằng cách sử dụng lớp KmlLayer của Maps JavaScript API?

Hãy tham khảo tại đây để biết giới hạn về kích thước và độ phức tạp của việc hiển thị KML bằng lớp KmlLayer.

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

Lớp KmlLayer dùng để tạo lớp phủ KML trong API JavaScript của Maps sử dụng một dịch vụ được lưu trữ trên Google để 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 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 thư viện JavaScript của bên thứ ba. Vì trình duyệt có phân tích tệp KML, nên hiệu suất có thể thấp hơn so với khi sử dụng lớp KmlLayer.

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

Không có giới hạn về số lượng điểm đánh dấu hoặc đỉnh đường dẫn được hỗ trợ bởi API Maps tĩnh. 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ể sử dụng nhiều lần trong bản đồ.

Lưu ý rằng URL API tĩnh của Google Maps có thể chứa tối đa khoảng 8.192 ký tự,ràng buộc số lượng điểm đánh dấu và đỉnh đường dẫn có thể được chỉ định dựa trên số vị trí thập phân được sử dụng khi chỉ định từng cặp vĩ độ/kinh độ. Để biết thông tin về số lượng vị trí 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 Nền tảng Google Maps ở một số quốc gia?

Không được sử dụng API Maps trong Các lãnh thổ bị cấm. Hãy tham khảo Điều khoản dịch vụ nữa.

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 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 tuyến đường không chính xác
  • Thông tin sai về đường một chiều và 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 chỉnh sửa.

Nếu cần xóa 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 cần xử lý kịp thời, hãy gửi trường hợp hỗ trợ kèm theo thông tin chi tiết cụ thể về những việc 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 sử dụng với API Maps JavaScript?

Một số tính năng phía máy khách được trang bị để báo cáo tính thành công hoặc không thành công cho 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 tới Google theo số maps.googleapis.com/maps_api_js_slo/log trong các cuộc gọi ghi nhật ký 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 API Maps JavaScript đang được sử dụng. Các cuộc gọi có thể được phân theo lô để thực hiện. Xin lưu ý rằng bạn có thể cần phải cho phép maps.googleapis.com trong Chính sách bảo mật nội dung của mình để đảm bảo 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; với tiêu đề HTTP hoặc <meta http-equiv="Content-Security-Policy" content="default-src 'self' maps.googleapis.com;"> với Thẻ meta HTML.

API JavaScript cho Maps

API Maps JavaScript sẽ hoạt động sau bao lâu?

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

SDK Google Maps dành cho iOS

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

Nếu bạn gặp sự cố khi gỡ lỗi với 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 ảnh khung GPU trong lược đồ XCode bạn đang chạy:

  1. Trong XCode, hãy chọn Product, Scheme, Manage 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 (Chụp ảnh khung hình GPU) thành Disabled (Tắt). Xin lưu ý rằng tuỳ chọn này có thể không có sẵn cho tất cả thiết bị.
Tùy chọn Chụp khung hình Xcode Xcode trên trang thiết bị iOS chung
Ảnh hưởng của màn hình tròn và màn hình rộng hơn trên SDK Google Maps dành cho iOS là gì?

Bắt đầu với iPhone X, iPhone có hình dạng màn hình bao gồm các góc tròn, một khía ở trên cùng để chứa vỏ cảm biến của thiết bị và chỉ báo ở cuối màn hình để truy cập Màn hình chính. Kể từ SDK iOS 11.0, Apple đã thêm API Khu vực an toàn, cho phép nhà phát triển định vị các thành phần trong một khu vực an toàn để không bị cắt bớt theo 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ức năng điều khiển trực quan, chẳng hạn như bộ chọn trong nhà và đường liên kết đến báo cáo sự cố. Với phiên bản 2.4, các thành phần hình ảnh và các thành phần điều khiển này có thể bị cắt bởi hình dạng màn hình mới. Ở chế độ ngang, bộ chọn tầng trong nhà có thể được cắt bằng chỉ báo hoặc chỉ báo nút màn hình chính.

Với bản phát hành SDK Google Maps cho iOS 2.5, các vấn đề về bố cục này đã được khắc phục tự động. Khi ứng dụng của bạn được sử dụng trên iPhone X trở lên, khoảng đệm trên GMSMapViewGMSẢnhView 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 bao gồm khoảng đệm của bạn. SDK Google Maps dành cho iOS giả định khoảng đệm cần thiết để đệ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 được đặt trong khu vực an toàn, thì bạn có thể dễ dàng thực hiện việc này.

Nếu bạn đã thiết kế một giao diện không hoạt động với tính năng điều chỉnh mặc định của chúng tôi, chúng tôi đã giới thiệu một thuộc tính mới cho GMSMapView, được gọi là paddingAdjustBehavior. GMSMapView hiện cho phép bạn 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', nó sẽ luôn thêm các phần lồng ghép vùng an toàn vào khoảng đệm. Điều này cho phép bạn thiết kế giao diện với giả định rằng tất cả các vị trí đều nằm ở cạnh của vùng an toàn. Đây là giá trị mặc định.

Nếu bạn đặt GMSMapView để sử dụng hành vi khoảng đệm "Tự động", thì GMS 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. Điều này cho phép bạn thêm khoảng đệm từ cạnh màn hình trong khi luôn đảm bảo rằng tất cả phần tử đều nằm trong vùng an toàn.

Nếu bạn đặt GMSMapView để sử dụng hành vi khoảng đệm 'Không bao giờ', thì GMSMap sẽ không bao giờ thêm các 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 đã tính đế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 có trách nhiệm đảm bảo 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, GMSGlobalView không có thuộc tính khoảng đệm tuỳ chọn. Điều này có nghĩa là không có khoảng đệm nào để điều chỉnh và GMSToàn cảnh sẽ luôn áp dụng khoảng đệm cần thiết để đảm bảo rằng tất cả phần tử hình ảnh đều nằm trong vùng an toàn.

SDK Google Maps dành cho Android

Làm cách nào để khắc phục lỗi: 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
Nếu thấy lỗi này, bạn có thể đang sử dụng phiên bản SDK Địa điểm dành cho Android không được dùng nữa. Phiên bản Dịch vụ Google Play của SDK địa điểm dành cho Android đã bị tắt và không còn hoạt động nữa. Vui lòng cập nhật ứng dụng để sử dụng phiên bản mới nhất sớm nhất có thể. 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ị ô màu xám thay vì một 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ì một 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 các vấn đề đó bằng cách sử dụng adcat 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 tại đây.
  2. Cài đặt ứng dụng cho thấy có 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 tùy chọn cài đặt trình mô phỏng đã bao gồm Cửa hàng Play.
  3. Trong thiết bị đầu cuối 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" (Không bắt buộc, bạn có thể xuất nhật ký vào một tệp văn bản bằng cách thêm: > logcat.txt)
  4. Tái hiện sự cố này trên thiết bị của bạn và kiểm tra các lỗi phổ biến như:
    • Khoá API không chính xác/không có ý định đang được tham chiếu trong Tệp kê khai.
    • Bạn chưa bật tính năng thanh toán trên Dự án.
    • SDK chưa được bật trên API dự án.
    • Tệp tham chiếu SHA1 không chính xác được thêm vào quy định hạn chế của 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ẽ tiết lộ bí mật ký URL của bạn cho người dùng cuối. Do đó, bạn chỉ nên tạo chữ ký bằng 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 bị cấm đối với các yêu cầu dịch vụ web của API Maps?

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ý của 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 này nêu rõ một khoá API cao cấp của Nền tảng Google Maps 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 tạo bằng khoá API phải có chữ ký hợp lệ.
  3. Bạn đã chỉ định một chữ ký nhưng khoá API Gói cao cấp của Nền tảng Google Maps chưa được chỉ định.