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à cách tính phí

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

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

Dịch vụ của 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 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 để truy xuất dữ liệu từ Google Maps. Có nhiều dịch vụ. Tuỳ thuộc vào nhu cầu của mình, bạn có thể sử dụng một hoặc kết hợp các API và SDK sau:

Bản đồ:

Tuyến đường:

Địa điểm:

Môi trường:

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

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

Tôi cần có API nào?

Để được trợ giúp tìm đúng API dựa trên các yêu cầu về chức năng, hãy xem bộ chọn API.

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

Xem hướng dẫn Tổng quan, Hướng dẫn cho nhà phát triển và 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ề 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 cung cấp dữ liệu bản đồ mới và mở rộng phạm vi phủ sóng quốc tế của chúng tôi. Hãy tham khảo dữ liệu về phạm vi phủ sóng trên 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 áp dụng có thể thay đổi nếu thoả thuận cấp phép với nhà cung cấp dữ liệu thay đổi.

Xem thêm:

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

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

Làm cách nào để phân phối ứ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 SDK Maps dành cho Android.

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

API JavaScript của Maps được phát triển để phục vụ 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 có triển khai JavaScript đầy đủ, chẳng hạn như iPhone của Apple.

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

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

API JavaScript của Maps và API nhúng 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), 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).
  • 2 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.
  • WebView trên Chrome trên Android 4.4 trở lên.
iOS
  • Mobile Safari trên các phiên bản chính hiện tại và trước đây của iOS.
  • UIWebView và WKWebView trên các phiên bản iOS hiện tại và trước đây.
  • Phiên bản hiện tại của Chrome dành cho iOS.
Tôi có thể in bản đồ từ API JavaScript của Maps không?

Không hỗ trợ in từ Maps JavaScript API. Nguyên nhân 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 để được thông báo khi có thay đổi đối với các sản phẩm trên Nền tảng Google Maps?

Bạn nên đăng ký theo dõi Blog của Nền tảng Google Maps để nhận thông tin cập nhật về các sản phẩm và dịch vụ dành cho nhà phát triển địa lý của Google.

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

Xem bài viết Tài nguyên và hỗ trợ của Nền tảng Google Maps để biết thông tin về các lựa chọn hỗ trợ có sẵn.

Khi nào chúng tôi có thể hỗ trợ kỹ thuật?
Nhóm hỗ trợ làm việc 24x5 (các ngày trong tuần từ 9 giờ sáng thứ Hai đến 5 giờ chiều thứ Sáu theo giờ Thái Bình Dương), ngoại trừ các ngày lễ tại khu vực đối với các vấn đề về "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 vào tài khoản bằng cách truy xuất hoặc đặt lại mật khẩu. Hãy xem bài viết Cách khôi phục Tài khoản Google hoặc Gmail trên trang 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ý quá trình triển khai Nền tảng Google Maps, 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 của mình:

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

Tôi có thể sử dụng SDK Bản đồ và Địa điểm dành cho iOS trên máy Mac dựa trên cánh tay không?

Tuy nhiên, bạn vẫn có thể phát triển ứng dụng trên máy Mac dựa trên Arm mới. Tuy nhiên, việc này đòi hỏi phải tạo và chạy trên một thiết bị iOS thực tế. Đây là 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 các trình mô phỏng.

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

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

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

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

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

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

Tuy nhiên, có một số mục đích sử dụng Nền tảng Google Maps mà chúng tôi không mong muốn: 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 người dùng, vì vậy, bạn không nên dùng Nền tảng Google Maps để xác định thông tin riêng tư về các cá nhân.

Trước khi phát triển và ra mắt, bạn nên tham khảo ý kiến của luật sư để xác định xem ứng dụng của bạn có tuân thủ Điều khoản dịch vụ của Nền tảng Google Maps hay không. Các kỹ sư của Google chỉ có thể hỗ trợ kỹ thuật và không đủ trình độ để đưa ra ý 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ụ bất cứ lúc nào, vì vậy, vui lòng đọ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 Nền tảng Google Maps (chẳng hạn như tạo API lập bản đồ của riêng bạn hoặc sử dụng tập lệnh tải hàng loạt thẻ thông tin xuống). 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 vào các ô đó từ bên ngoài Nền tảng Google Maps. Xem Điều khoản dịch vụ của Nền tảng Google Maps để biết thêm thông tin chi tiết.

Tôi có thể sử dụng các sản phẩm Nền tảng Google Maps để theo dõi ứ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 thời gian thực (theo dõi) bằng các sản phẩm trên 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 Web không?

Có, các sản phẩm của Nền tảng Google Maps hiện có thể sử dụng được trong các ứng dụng không phải 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 Nền tảng Google Maps.

API JavaScript của Maps chỉ được hỗ trợ khi chạy trên 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 trang web được bảo vệ bằng mật khẩu không?

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

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

Nếu đơn đăng ký của bạn tạo tài liệu ở dạng điện tử hoặc dạng in, thì không 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 trích xuất dữ liệu" để biết thêm chi tiết.

Làm cách nào để tôi chọn không đưa nội dung của tôi vào kết quả tìm kiếm của 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 đã 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 càng sớm càng tốt.

Để xóa 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ó trong trung tâm trợ giúp quản trị viên trang web của chúng tôi.

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

Hạn mức sử dụng và cách tính phí

Làm cách nào để thiết lập thanh toán cho dự án của tôi?
Xem bài viết Bắt đầu sử dụng Nền tảng Google Maps.
Khách hàng của Google Cloud Platform miễn phí có thể nâng cấp lên tài khoản trả phí bằng cách nào?
Chương trình Cấp miễn phí của Google Cloud Platform cung cấp cho khách hàng một khoản dùng thử không tính phí với một khoản tín dụng 300 USD để sử dụng với bất kỳ dịch vụ nào của Google Cloud Platform (GCP), bao gồm cả API Nền tảng Google Maps (GMP). Khi thời gian dùng thử không tính phí kết thúc, bạn phải nâng cấp lên tài khoản có tính phí để tiếp tục sử dụng các dịch vụ này. Để nâng cấp lên một 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 bạn có thể đưa ra đối với các sản phẩm trên Nền tảng Google Maps. Ngoài ra, 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 từ xa, giới hạn được đặt theo số sự kiện mỗi giây (EPS) được tính bằng tổng số truy vấn phía máy khách và phía máy chủ.

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

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ỉ 6.000 QPM
Chế độ xem trên không: Tra cứu video 180 QPM và 100.000 QPD
Chế độ xem trên không: Kết xuất video 100 QPM và 100 QPD
Chất lượng không khí 6.000 QPM
Đường đi 3.000 QPM
Ma trận khoảng cách 60.000 EPM
Bản đồ động 30.000 QPM
Cao độ 6.000 QPM
Mã hoá địa lý 3.000 QPM
Vị trí địa lý 6.000 QPM
API Thẻ thông tin bản đồ: Thẻ thông tin 2D và Thẻ thông tin Chế độ xem đường phố 6.000 QPM và 15.000 QPD
API Thẻ thông tin bản đồ: Thẻ thông tin 3D ảnh thực 300 QPD
API Thẻ thông tin bản đồ: Thẻ thông tin 3D ảnh thực: Trình kết xuất 12.000 QPM
Địa điểm 6.000 QPM
Phấn hoa 6.000 QPM
Con đường 30.000 QPM
Tuyến đường: Tính toán tuyến 3.000 QPM
Tuyến đường: Ma trận tuyến tính toán 3.000 EPM
Năng lượng mặt trời 600 QPM
Bản đồ tĩnh 30.000 QPM
API hình ảnh chế độ xem đường phố 30.000 QPM
Múi giờ 30.000 QPM

Để 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ả các yêu cầu đối với mọi API có tính phí.

Các sản phẩm Google Maps Platform 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ề giá của các sản phẩm trên Nền tảng Google Maps, vui lòng xem Bảng giá.

Để tìm hiểu thêm về cách tính phí API Nền tảng Google Maps, vui lòng xem bài viết Tìm hiểu về thanh toán đối với Maps, Tuyến đường, Địa điểm và Môi trường.

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

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

  • 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ừ API tĩnh của Maps.

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

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

Sau khi trang web hoặc ứng dụng tải một bản đồ, hình ảnh tĩnh hoặc ảnh toàn cảnh của Chế độ xem đường phố, mọi tương tác của người dùng với trang web/ứng dụng đó (chẳng hạn như kéo, 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 giới hạn sử dụng.

Việc thêm một điểm đánh dấu sẽ không tạo thêm lượt tải bản đồ, nhưng có thể tạo ra các 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 việc sử dụng?

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

  1. Chọn dự án có chứa API mà bạn muốn xem xét.
  2. Từ danh sách API trên Trang tổng quan, nhấp vào tên 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. Hãy thiết lập thông tin thanh toán nếu bạn chưa làm.
  2. Truy cập trang thanh toán của Cloud Console.
  3. Chọn dự án.
  4. Trong thanh bên bên trái, hãy nhấp vào Báo cáo. Hãy 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 Báo cáo về nền tảng Google Maps cũng như Theo dõi mức sử dụng APIGiới hạn mức sử dụng API.

Điều gì 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 nhất định trên Nền tảng Google Maps, thì API sẽ trả về một thông báo lỗi. Nếu bạn liên tục vượt quá 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 QPS của yêu cầu hoặc nếu bạn lạm 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ó sẵn dịch vụ phía máy khách tương đương trong API JavaScript của Maps: Đường đi, Ma trận khoảng cách, Độ caoMã hoá địa lý.

Vượt quá giới hạn sử dụng

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

Đ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. Lỗi này có thể xảy ra trong vòng vài giây, nếu người dùng nhận được lỗi 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 hoá các ứng dụng để dùng các sản phẩm trên Nền tảng Google Maps một cách 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 tự làm quen với giới hạn sử dụng của bất kỳ Nền tảng Google Maps nào mà ứng dụng của bạn cần.

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 hằng tháng là 200 USD và không có phương thức thanh toán hợp lệ trên tài khoản thanh toán (thẻ tín dụng, chuyển khoản ngân hàng, v.v.) vượt quá hạn mức sử dụng hằng tháng là 200 USD, 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ệ.

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

Có giá cho các đơn vị tiền tệ khác không?

Có thể bạn sẽ thấy các đơn vị tiền tệ khá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ừ đơn vị tiền tệ tương đương 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 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 phương thức thanh toán mà bạ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 tìm hiểu thông tin 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 hoá đơn hằng ngày. Bạn có thể thiết lập giới hạn sử dụng tối đa hằng ngày để tránh các mức sử dụng tăng đột biến. Bạn cũng có thể thiết lập 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 giới hạn tối đa có thể lập hoá đơn hằng ngày:

Để tránh phải chi trả một hoá đơn lớn, bạn có thể đặt hạn mức sử dụng hằng ngày để tránh mức sử dụng tăng lên ngoài dự kiế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. Chuyển đến 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 trong danh sách, sau đó nhấp vào thẻ Hạn mức.
  4. Nhấp vào biểu tượng chỉnh sửa bên cạnh hạn mức "số 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 về hạn mức IAM và quản trị viên.

Cài đặt và quản lý cảnh báo về ngân sách:

Thiết lập cảnh báo về ngân sách để gửi thông báo qua email cho quản trị viên thanh toán khi các khoản phí 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 khoản phí ước tính trên tài khoản thanh toán vượt quá 50%, 90% và 100% so với ngưỡng.

Tôi nhận được thông báo rằng dự án của mình đượ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 ra để giúp một số khách hàng chuyển sang gói trả tiền theo mức dùng mới 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 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 đến hạn mức là 200 đô la Mỹ trong cấp miễn phí. 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ụ. Để tránh bị gián đoạn dịch vụ, bạn nên tự đặt tài khoản thanh toán để tiếp tục tận hưởng bậc không tính phí 200 USD 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 giới hạn 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 của mình, thì 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 hạn mức cao hơn bằng cách tạo và đính kèm một tài khoản thanh toán. Để thực hiện việc này, hãy xem bài viết Bắt đầu sử dụng Nền tảng Google Maps.

Sau khi bạn tạo và liên kết một 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 để ngăn việc chi tiêu ngoài dự kiến trong Cloud Console.

Tôi đã nhận được 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 mục 3.2.4 của Điều khoản dịch vụ của Nền tảng Google Maps. Theo các điều khoản này, bạn bị cấm tạo nhiều tài khoản thanh toán. Để tìm hiểu thêm, hãy xem bài viết Câu hỏi thường gặp về việc vi phạm tài khoản thanh toán.

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

Tôi nên sử dụng khoá hoặc thông tin 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 Nền tảng Google Maps, bạn phải thêm khoá API để xác thực yêu cầu của mình. Nền tảng Google Maps có sẵn cho ứng dụng Android, iOS hoặc ứng dụng web và qua các dịch vụ web HTTP.

Khoá API:

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

Chữ ký số:

  • Chữ ký số được tạo bằng bí mật ký URL mà Google cung cấp cho bạn. Chữ ký số được dùng với API tĩnh của Maps và API tĩnh của Chế độ xem đường phố.

Quy định hạn chế:

  • Các quy định hạn chế về 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. Hãy xem bài viết Các phương pháp hay nhất về bảo mật API để biết thêm thông tin chi tiết.
  • Bạn có thể thêm một quy định 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 các nền tảng hỗ trợ loại quy định 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 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 cùng với API dịch vụ web.
    • Đường liên kết giới thiệu HTTP (trang web) – để sử dụng cùng các API web.
    • Hạn chế đối với ứng dụng Android (theo tên gói và vân tay) – để sử dụng cùng SDK Maps dành cho Android.
    • Hạn chế đối với ứng dụng iOS (theo giá trị nhận dạng gói trên iOS) – để sử dụng cùng SDK Maps dành cho iOS.
  • Bạn cũng có thể thêm quy tắc hạn chế đối với API vào khoá API. Để biết thêm thông tin, hãy xem phần Tải, 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 mỗi API/SDK trên 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 Bản đồ dành cho Android Khoá API có các quy tắc hạn chế đối với Android1
SDK Địa điểm dành cho Android Khoá API có các quy tắc hạn chế đối với Android1
SDK Bản đồ dành cho iOS Khoá API có các quy định hạn chế đối với iOS1
SDK Địa điểm dành cho iOS Khoá API có các quy định hạn chế đối với iOS1
API JavaScript cho Maps Khoá API có quy tắc hạn chế giới thiệu HTTP1
Map Tiles API Khoá API có quy định hạn chế về địa chỉ IP1
API Chế độ xem trên không Khoá API có quy định hạn chế về địa chỉ IP1
API tĩnh của Maps Khoá API có quy tắc hạn chế về người giới thiệu HTTP1 + Chữ ký số2
API tĩnh của Chế độ xem đường phố Khoá API có quy tắc hạn chế về người giới thiệu HTTP1 + Chữ ký số2
API Nhúng Maps Khoá API có quy tắc hạn chế giới thiệu HTTP1
API xác thực địa chỉ Khoá API có quy định hạn chế về địa chỉ IP1
API Chỉ dẫn Khoá API có quy định hạn chế về địa chỉ IP1
API ma trận khoảng cách Khoá API có quy định hạn chế về địa chỉ IP1
API Độ cao Khoá API có quy định hạn chế về địa chỉ IP1
API mã hoá địa lý Khoá API có quy định hạn chế về địa chỉ IP1
API vị trí địa lý Khoá API có quy định hạn chế về địa chỉ IP1
API Địa điểm Khoá API có quy định hạn chế về địa chỉ IP1
API Đường Khoá API có quy định hạn chế về địa chỉ IP1
API Tuyến đường Khoá API có quy định hạn chế về địa chỉ IP1
API múi giờ Khoá API có quy định hạn chế về địa chỉ IP1
API Chất lượng không khí Khoá API có quy định hạn chế về địa chỉ IP1
API Phấn hoa Khoá API có quy định hạn chế về địa chỉ IP1
API năng lượng mặt trời Khoá API có quy định hạn chế về địa chỉ IP1
1 Các quy định hạn chế về 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 tính 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 API Tĩnh của MapsAPI Tĩnh của Chế độ xem đường phố. Bất kể cách sử dụng là gì, bạn nên sử dụng cả khoá API và chữ ký số để xác thực yêu cầu của mình.
Làm cách nào để chuyển đổi loại hạn chế khoá của tôi từ tham chiếu HTTP sang hạn chế địa chỉ IP?

Lưu ý quan trọng: Nếu bạn đang sử dụng bất kỳ API dịch vụ web nào với khoá API có các quy tắc hạn chế về người tham chiếu, thì các yêu cầu của bạn sẽ không thành công kèm theo thông báo lỗi: "Khoá API không thể có giới hạn về người tham chiếu khi được 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 hạn chế khoá API từ tham chiếu HTTP sang địa chỉ IP, hãy đảm bảo rằng tất cả các API sử dụng khoá API đều hỗ trợ loại quy định hạn chế IP. Các API thuộc cùng loại hạn chế có thể sử dụng cùng một khoá hạn chế. Nếu bạn cần áp dụng nhiều quy tắc hạn chế, hãy thêm một khoá riêng 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 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 đổi khoá API có chế độ hạn chế tham chiếu HTTP thành chế độ hạn chế địa chỉ IP, hãy làm như sau:

  1. Chuyển đến trang Thông tin xác thực của Cloud Console.
  2. Chọn dự án có 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 Khóa hạn chế 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 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 Nền tảng Google Maps.
Làm cách nào để tìm thấy những thay đổi được giới thiệu trong mỗi phiên bản của API Google Maps?

Thông tin thay đổi phiên bản của nhiều API Maps sẵn có tại các 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à bạn gặp phải và khắc phục lỗi cụ thể bằng cách sử dụng Công cụ theo dõi lỗi trên Nền tảng Google Maps tại:

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

Làm cách nào để tải API không đồng bộ vào một trang 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 chương Bắt đầu của tài liệu về API Maps JavaScript.

Làm cách nào để các sản phẩm trên Nền tảng Google Maps hiển thị bằng một ngôn ngữ không phả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í của người dùng hoặc cá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 đư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 về 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ể chưa đầy đủ và có thể thay đổi.

Mã ngôn ngữ Ngôn ngữ Mã ngôn ngữ Ngôn ngữ
af Tiếng Afrikaans ja Tiếng Nhật
sq Tiếng Albania kn Tiếng Kannada
sáng Tiếng Amhara kk Tiếng Kazakh
ar Tiếng Ả Rập km Tiếng Khmer
hy Tiếng Armenia ko Tiếng Hàn
az Tiếng Azerbaijan ky Tiếng Kyrgyz
eu Tiếng Basque lo Tiếng Lào
be Tiếng Belarus lv Tiếng Latvia
bn Tiếng Bengal lt Tiếng Lithuania
bs Tiếng Bosnia mk Tiếng Macedonia
bg Tiếng Bungary ms Tiếng Malay
my Tiếng Myanmar ml Tiếng Malayalam
ca Tiếng Catalan mr Tiếng 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 Chữ 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 (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
et Tiếng Estonia si Tiếng Sinhala
fa Tiếng Ba Tư sk Tiếng Slovakia
fi Tiếng Phần Lan sl Tiếng Slovenia
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ỹ La Tinh)
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 bản đồ sẽ trông như thế nào bằng bất kỳ ngôn ngữ nào được liệt kê ở trên trong ứng dụng mẫu này.

Nền tảng Google Maps có thể được truy cập qua SSL (HTTPS) không?

Bạn có thể truy cập API JavaScript của Maps, API tĩnh của Maps và API Dịch vụ web qua các kết nối an toàn (HTTPS). Vui lòng xem tài liệu dành cho API liên quan để biết 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ẽ hiển thị.

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

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

Nếu bạn muốn yêu cầu một tính năng, vui lòng nêu rõ trong diễn đàn liên quan để xác nhận rằng chưa có giải pháp đáp ứng các yêu cầu của bạn.

Sau khi bạn 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 Nền tảng Google Maps không thể đáp ứng các yêu cầu của bạn, vui lòng báo cáo lỗi hoặc yêu cầu về tính năng bằng Công cụ theo dõi lỗi trên Nền tảng Google Maps.

Trước khi thêm lỗi hoặc yêu cầu về 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 là bạn quan tâm và nhận thông báo về thông tin cập nhật.

API Nền tảng Google Maps sử dụng cookie 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à trong 7 ngày cũng như ngăn chặn hành vi sử dụng dịch vụ sai mục đích. Các cookie này không liên kết với bất kỳ Tài khoản Google đã đăng nhập nào và không được ghi lại với phần thông tin còn lại được thu thập 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ệ với nhà phát triển của Google duy trì sự hiện diện trên Stack Overflow – một trang web câu hỏi và câu trả lời được cộng tác chỉnh sửa dành cho 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ề cách phát triển và duy trì các ứ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 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 các cuộc thảo luận hiện tại. Có thể một người nào đó cũng gặp phải vấn đề tương tự và tìm được 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 dễ dàng xem được mã trên mạng.
  • Hãy cung cấp mọi thông tin liên quan, bao gồm cả phiên bản trình duyệt, lỗi và mọi thông tin khác có thể giúp ích cho 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 truy cập các đường liên kết sau đây để xem nội dung giải thích cho các mã lỗi đó:

Bản đồ của tôi có vẻ 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 đồ bị làm tối hay hình ảnh "tiêu cực" trong Chế độ xem đường phố có hình mờ với dòng chữ "chỉ nhằm mục đích phát triển" có thể xuất hiện. Hành vi này thường cho biết 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ả các yêu cầu phải có khoá API hợp lệ. Quy trình sau đây sẽ giúp khắc phục sự cố này:


Làm cách nào để khắc phục các mã lỗi: OVER_DAILY_LIMIT hoặc OVER_QUERY_LIMIT?
Các mã lỗi này có thể được trả về vì bất kỳ lý do nào sau đây:
  • Yêu cầu thiếu khoá API.
  • Khoá API được cung cấp không hợp lệ.
  • Dự án chưa đính kèm tài khoản thanh toán.
  • Đã 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 hiệu lực (ví dụ: thẻ tín dụng đã hết hạn).
  • Bạn đã vượt quá giới hạn QPS đối với 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 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 để khắc phục các mã lỗi: kGMSPlacesRateLimitExceeded hoặc 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
Nếu thấy kGMSPlacesRateLimitExceeded hoặc 9005 PLACES_API_RATE_LIMIT_EXCEEDED, có thể bạn đang sử dụng phiên bản không dùng nữa của SDK Địa điểm 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: "IP, trang web hoặc ứng dụng dành cho thiết bị 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à có một địa chỉ IP trái phép đang cố gắng yêu cầu.
  • Bạn đã bật các hạn chế về đường liên kết giới thiệu HTTP (trang web) đối với khoá API của mình và một đường liên kết giới thiệu trái phép đang cố gắng thực hiện một yêu cầu.
  • Bạn đã giới hạn mức sử dụng đối với các ứng dụng Android của mình 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ố gắng 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 theo gói, và một ứng dụng iOS không nhận dạng được sẽ 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 hạn chế về giới thiệu HTTP. Bạn phải xác định các yêu cầu gửi đến các API đó bằng khoá API có các quy định hạn chế về địa chỉ IP. Chuyển đổi loại hạn chế đối với khoá của bạn từ chế độ hạn chế giới thiệu HTTP sang chế độ hạn chế địa chỉ IP. Để biết thêm thông tin về việc hạn chế khoá API, hãy xem bài viết 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 của khoá API

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

  1. Chuyển đến trang Thông tin xác thực của Cloud Console.
  2. Chọn dự án có chứa khoá API mà bạn muốn xem xét.
  3. Để xem thông tin xác thực, bao gồm mọi quy tắc hạn chế đã đặt cho 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 đủ của khoá API đã chọn sẽ hiển thị, bao gồm 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ế khi cần.
Làm cách nào để khắc phục lỗi: "Không thể sử dụng khoá API có giới hạn giới hạn với API này"?

Bạn đang sử dụng bất kỳ API dịch vụ web nào có khoá API chỉ dành cho tham chiếu HTTP. Vì lý do bảo mật, các API dịch vụ web cần sử dụng các khoá API bị hạn chế đối với địa chỉ IP. Chuyển đổi loại hạn chế khoá của bạn từ chế độ hạn chế giới thiệu HTTP sang chế độ 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 API JavaScript của Maps.

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

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

Có, quá 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ã hóa địa lý. Lớp này là: google.maps.Geocoder.

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

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

Để xem các quốc gia hiện được hỗ trợ bởi bộ mã hoá địa lý của Nền tảng Google Maps, 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ã hoá địa lý có thể khác nhau 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ả phù hợp cho các mục đích của đơn đăng ký 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 các nhà cung cấp dữ liệu, do đó, dữ liệu có thể thay đổi.

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

Bộ mã hoá địa lý API và bộ mã hoá địa lý của 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 đôi khi sẽ được cập nhật dữ liệu mới, vì vậy, bạn có thể kỳ vọng rằng 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ăng tối đa số lượng yêu cầu thành công?

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

  • Chỉ định các địa chỉ theo định dạng được dịch vụ bưu chính quốc gia của quốc gia có liên quan sử dụng.
  • Đừng nêu rõ các thành phần địa chỉ bổ sung như tên doanh nghiệp, số nhà, số tầng hoặc số căn hộ. Những phần tử này không có trong địa chỉ theo quy định của dịch vụ bưu chính của quốc gia có liên quan. Thao tác này có thể dẫn đến phản hồi bằng ZERO_RESULTS.
  • Định dạng mã cộng như minh hoạ dưới đây (dấu cộng là URL thoát thành %2B và dấu cách là URL thoát theo URL %20):
    • mã chung là mã vùng gồm 4 ký tự và mã địa phương từ 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, USA là CWC8%2BR9%20Mountain%20View%20CA%20USA).
  • Nếu có thể, hãy sử dụng số nhà của toà nhà (ưu tiên dùng tên toà nhà).
  • Sử dụng địa chỉ số nhà trong tuỳ chọn để xác định đường giao nhau nếu có thể.
  • Đừng cung cấp 'gợi ý' như các địa danh lân cận.
Làm cách nào để định dạng địa chỉ ở Hoa Kỳ trên đường cao tốc được đánh số để mã hoá địa lý?

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

  • Đường hạt: "Co Road NNN", trong đó NNN là số đường. Ví dụ: "Co Road 82"
  • Đường cao tốc cấp 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 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: Mã hoá địa lý chiến lược, trong đó nêu chi tiết ưu và nhược điểm của các chiến lược mã hoá địa lý khác nhau.

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ụ Tính toán tuyến đường của API Tuyến đườngAPI chỉ đường cho phép bạn cung cấp chỉ đường lái xe cho các hành trình một chặng và nhiều chặng. Các tuỳ chọn định tuyến giúp bạn định hình đường đi bằng chế độ đi lại (lái xe), một nhóm hoặc một nhóm tuyến đường và các hạn chế (không có đường có thu phí). Những dịch vụ này được cung cấp dưới dạng những hình thức sau:

  • Giao diện yêu cầu/phản hồi HTTP (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à với các dịch vụ web khác của Google Maps.
  • API JavaScript dành cho 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 (Trình hiển thị chỉ đường) có thể tự động tạo lớp phủ và bảng điều khiển chỉ đường cho bạn. Tài liệu này cung cấp các ví dụ khác.
  • Giao diện máy khách Java, Python, go và Node.js, dành cho 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 Thư viện ứng dụng API chỉ đường.
Tính năng chỉ đường lái xe hiện có ở những quốc gia nào?

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

Tính năng chỉ đường cho phương tiện công cộng hiện có ở 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 của Google Phương tiện công cộng, ngoại trừ những đối tác ở Nhật Bản.

Các tính năng KML và GeoRSS nào được hỗ trợ trong Maps JavaScript API?

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 trên bản đồ. Bạn có thể xem tài liệu và ví dụ tại đây.

Kích thước và độ phức tạp của KML có thể được hiển thị bằng lớp KmlLayer của API JavaScript Maps là gì?

Các giới hạn về kích thước và độ phức tạp của việc hiển thị KML thông qua lớp KmlLayer được ghi lại tại đây.

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

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

Nếu cần phát triển các ứng dụng sử dụng tệp KML được lưu trữ trên trang web mạng nội bộ, bạn nên hiển thị KML trên máy khách bằng cách sử dụng các thư viện JavaScript của bên thứ ba. Vì trình duyệt 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ố lượng điểm đánh dấu hoặc đỉnh đường dẫn mà API tĩnh của Maps hỗ trợ tối đa 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 mà API tĩnh của Maps 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ể dùng nhiều lần trong bản đồ.

Xin lưu ý rằng các URL API tĩnh của Maps có thể chứa tối đa khoảng 8.192 ký tự,quy định 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ố vị trí thập phân được 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ố vị trí thập phân được dùng với độ chính xác trên Trái Đất, vui lòng 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 trên Nền tảng Google Maps tại một số quốc gia nhất định?

Bạn không được sử dụng API Maps tại Các lãnh thổ bị cấm. Ngoài ra, hãy tham khảo Điều khoản dịch vụ.

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

Để chỉnh sửa một địa điểm hoặc trang thông tin doanh nghiệp, hãy đề xuất 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 yêu cầu hỗ trợ kèm theo thông tin chi tiết cụ thể về những điểm cần khắc phục.

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

Một số tính năng phía máy khách được đo lường để báo cáo mức độ thành công hay thất bại nhằm tính SLO (Mục tiêu mức độ dịch vụ). Thông tin này được gửi tới Google theo địa chỉ maps.googleapis.com/maps_api_js_slo/log trong các lệnh 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 Maps JavaScript API đang sử dụng. Các lệnh gọi có thể được phân theo lô để nâng cao hiệu suất. 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 để đảm bảo những 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 JavaScript của Maps sẽ hoạt động trong bao lâu sau khi được tải?

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

SDK Google Maps dành cho iOS

Làm thế nào để khắc phục lỗi: kGMSPlacesRateLimitExceeded?
Nếu gặp 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òn đượ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 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.
Tôi gặp sự cố khi gỡ lỗi bằng 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 trên 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 GPU trong lược đồ XCode mà bạn đang chạy:

  1. Trong XCode, hãy chọn Product (Sản phẩm), Scheme (Sơ đồ), Manage Schemes (Quản lý lược đồ).
  2. Chọn một lược đồ và chọn 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 tuỳ chọn này có thể không có sẵn cho mọi thiết bị.
Tuỳ chọn lấy khung hình GPU của Xcode trên trang Thiết bị iOS chung
Màn hình tròn và màn hình rộng hơn trên SDK của Google Maps dành cho iOS có tác động gì?

Kể từ iPhone X, iPhone có hình dạng màn hình với các góc bo tròn, một vết khía ở đầu màn hình dành 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 API Vùng an toàn (Safe Area API) cho phép nhà phát triển định vị các phần tử trong khu vực an toàn để hình dạng màn hình mới không bị cắt bớt.

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

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

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

Nếu bạn đã thiết kế một giao diện không hoạt động với đ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: "Always" (mặc định), "Automatic" (Tự động) và "Never" (Không bao giờ).

Nếu bạn đặt GMSMapView để sử dụng hành vi khoảng đệm "Luôn luôn" thì 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ả vị trí đều từ các cạnh của vùng an toàn. Đây là giá trị mặc định.

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

Nếu GMSMapView được thiết lập để sử dụng hành vi khoảng đệm "Không bao giờ" thì 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 của bạn đã 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 rằng biểu trưng và thông báo bản quyền của Google luôn hiển thị, như quy định trong Điều khoản dịch vụ của Nền tảng Google Maps.

Ngược lại, GMStoànView 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 để điều chỉnh và GMStoànView sẽ luôn áp dụng mọi khoảng đệm cần thiết để đảm bảo rằng tất cả cá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 thế nào để khắc phục lỗi: 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
Nếu gặp lỗi này, có thể bạn đang sử dụng phiên bản SDK Địa điểm dành cho Android không còn đượ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ị các ô màu xám trống 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 được hiển thị thay vì bản đồ là các vấn đề về xác thực. Bạn có thể làm theo các bước bên dưới để khắc phục các vấn đề đó bằng cách sử dụng logcat adb.

  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 hiển thị 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 phần cài đặt của trình mô phỏng đã có Cửa hàng Play.
  3. Trong dòng lệnh của Android Studio, hãy chạy adb logcat -e "Google Maps Android API". Thao tác này sẽ chỉ in những dòng nơi thông điệp nhật ký khớp với "API Android của Google Maps" (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 tạo vấn đề trên thiết bị của bạn và kiểm tra các lỗi thường gặp như:
    • Khoá API sai/không mong muốn đ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 không được bật trên API dự án.
    • Vân tay số SHA1 không chính xác sẽ được thêm vào các hạn chế đối với Khoá API.
    • Các phần phụ thuộc Dịch vụ Google Play không có trong tệp build.gradle.

Ký URL

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

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

Tại sao tôi nhận được phản hồi HTTP 403 Bị cấm cho 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 thể xác minh chữ ký cho yêu cầu này. Điều này có thể là do:

  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 Gói Google Maps đặc biệt trên Nền tảng Google Maps một khoá API nhưng không chỉ định chữ ký và dịch vụ đang được gọi phải có chữ ký hợp lệ trong các yêu cầu được gửi bằng khoá API.
  3. Chữ ký đã được chỉ định nhưng khoá API Gói cao cấp của Nền tảng Google Maps được liên kết chưa được chỉ định.