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

Bắt đầu

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

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

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

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

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

API JavaScript cho Maps

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

Maps:

Tuyến:

Địa điểm:

Môi trường:

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

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

Tôi cần API nào?

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

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

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

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

Nhóm Google Maps liên tục cung cấp dữ liệu bản đồ mới và mở rộng phạm vi cung cấp trên toàn cầu. Hãy tham khảo dữ liệu về phạm vi của Google Maps để biết thông tin mới nhất về phạm vi. 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 phạm vi cung cấp có thể thay đổi nếu thoả thuận cấp phép với nhà cung cấp dữ liệu thay đổi.

Xem thêm:

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

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

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

Để đưa bản đồ vào ứng dụng Android, hãy sử dụng SDK Bản đồ dành cho Android.

Để đưa bản đồ vào một ứng dụng iOS gốc, hãy sử dụng SDK Bản đồ dành cho iOS.

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

Đố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, API Maps Static sẽ phân phối hình ảnh bản đồ ở định dạng GIF, JPG và PNG, bao gồm cả điểm đánh dấu và đa tuyến. Xin lưu ý rằng việc sử dụng API Maps Static bên ngoài các ứng dụng dựa trên trình duyệt yêu cầu hình ảnh bản đồ phải được liên kết với Google Maps.

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

API JavaScript của Maps 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 chính ổn định mới nhất của Firefox (Windows, macOS, Linux).
  • Hai phiên bản chính ổn định mới nhất của Chrome (Windows, macOS, Linux).
  • Hai phiên bản chính ổn định mới nhất của Safari (macOS).
Android
  • Phiên bản Chrome hiện tại trên Android 4.1 trở lên.
  • Chrome WebView trên Android 4.4 trở lên.
iOS
  • Safari dành cho thiết bị di động trên các phiên bản chính hiện tại và trước đó của iOS.
  • UIWebView và WKWebView trên các phiên bản chính hiện tại và trước đó của iOS.
  • Phiên bản hiện tại của Chrome dành cho iOS.
Tôi có thể in bản đồ từ Maps JavaScript API không?

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

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

Bạn nên đăng ký Blog Google Maps Platform để nhận thông tin cập nhật về các sản phẩm dành cho nhà phát triển của Google Geo.

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

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

Khi nào có dịch vụ hỗ trợ kỹ thuật?
Nhóm hỗ trợ làm việc 24/7 (từ thứ Hai đến thứ Sáu, từ 9:00 theo giờ Tokyo đến 17:00 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 vào tài khoản bằng cách truy xuất hoặc đặt lại mật khẩu. Truy cập vào bài viết Cách khôi phục Tài khoản Google hoặc Gmail trong phần Trợ giúp về Tài khoản Google.

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

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

Nếu bạn có quyền truy cập vào Tài khoản Google 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 được liên kết với dự án:

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 Arm không?

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

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

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

Bạn có thể xem Điều khoản dịch vụ của Nền tảng Google Maps 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ố cách sử dụng Nền tảng Google Maps mà chúng tôi không muốn thấy, chẳng hạn như bản đồ xác định địa điểm mua ma tuý bất hợp pháp trong một thành phố hoặc bất kỳ hoạt động bất hợp pháp nào khác. Chúng tôi cũng tôn trọng quyền riêng tư của mọi người, vì vậy, bạn không được sử dụng Google Maps Platform để xác định thông tin riêng tư về cá nhân.

Bạn nên tham khảo ý kiến của luật sư để xác định xem ứng dụng của mình 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 phát triển và ra mắt ứng dụng. Các kỹ sư của Google chỉ có thể hỗ trợ kỹ thuật và không đủ điều kiện để 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 sử dụng API Maps.

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

Bạn không được truy cập vào thẻ thông tin 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 bản đồ của riêng bạn hoặc sử dụng tập lệnh tải thẻ thông tin hàng loạt xuống). Quyền truy cập của ứng dụng vào các ô này sẽ bị chặn nếu ứng dụng truy cập vào các ô đó bên ngoài Nền tảng Google Maps. Hãy xem Điều khoản dịch vụ của Nền tảng Google Maps để biết thêm thông tin chi tiết.

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

Không có quy định hạn chế nào về việc hiển thị dữ liệu theo thời gian thực (theo dõi) bằng các sản phẩm của 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ó, giờ đây, bạn có thể sử dụng các sản phẩm của Nền tảng Google Maps trong các ứng dụng không phải Web, miễn là các ứng dụng đó 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 trong một trong trình duyệt được hỗ trợ.

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

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

Tôi có thể tạo một ứng dụng có chứa dữ liệu của 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ạng điện tử hoặc in, thì tài liệu đó không được chứa dữ liệu nào từ Nền tảng Google Maps, bao gồm cả hình ảnh. Vui lòng xem phần "Không được thu thập thông tin" trong Đ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.

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

Chúng tôi không còn thu thập dữ liệu này nữa. Việc sử dụng tham số indexing không còn được dùng nữa và không có hiệu lực. Bạn không cần phải chọn không tham gia một cách rõ ràng nữa, nhưng bạn nên xoá 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 trong trung tâm trợ giúp dành cho 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 Maps Static mà tôi lưu trữ và phân phát từ trang web của mình không?

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

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

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

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

Đối với Distance Matrix, hạn mức được đặt theo số sự kiện mỗi phút (EPM) đượ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 Routes:Compute Route Matrix (Tuyến: Tính toán ma trận tuyến), giới hạn là số phần tử mỗi phút (EPM), trong đó số phần tử trong một yêu cầu bằng với: (số điểm xuất phát nhân với số điểm đến).

Đối với SDK Điều hướng, mỗi đích đến trong một yêu cầu được tính là một truy vấn riêng biệt.

Bảng sau đây cho thấy giới hạn 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 từ trên không: Tra cứu video 180 yêu cầu mỗi phút và 100.000 yêu cầu mỗi ngày
Chế độ xem từ trên không: Kết xuất video 100 QPM và 100 QPD
Chất lượng không khí 6.000 QPM
Cách tìm 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
Map Tiles API: Thẻ thông tin 2D và thẻ thông tin Chế độ xem đường phố 6.000 QPM và 15.000 QPD
Map Tiles API: Thẻ thông tin 3D có hình ảnh chân thực 10.000 QPD
Map Tiles API: Thẻ thông tin 3D ảnh thực tế: Trình kết xuất 12.000 QPM
Điều hướng: Đặt yêu cầu đích đến 30.000 QPM
Địa điểm 6.000 QPM
Phấn hoa 6.000 QPM
Đường 30.000 QPM
Tuyến đường: Tính toán tuyến đường 3.000 QPM
Tuyến: Tính toán ma trận tuyế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ý mức chi tiêu, bạn có thể giám sát mức sử dụng APIđặt hạn mức hằng ngày cho tất cả yêu cầu đối với bất kỳ API có thể tính phí nào.

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

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

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

Để tìm hiểu thêm về cách tính phí các API của Google Maps Platform, vui lòng xem bài viết Tìm hiểu về cách tính phí cho Maps, Routes, Places và Environment.

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

Hệ thống sẽ tính phí một lần tải bản đồ khi xảy ra một trong những trường hợp sau:

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

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

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

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

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

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

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

Để tìm hiểu thêm, hãy xem phần Báo cáo 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á hạn mức tốc độ yêu cầu (QPM)?

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

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

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ó trong API Maps JavaScript: Chỉ đường, Ma trận khoảng cách, Dữ liệu độ caoMã hoá địa lý.

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

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

Thông báo này có nghĩa là dịch vụ web đã ngừng cung cấp phản hồi thông thường và chuyển sang chỉ trả về mã trạng thái OVER_QUERY_LIMIT cho đến khi được phép sử dụng lại. Trường hợp 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 phút.

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

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

Có. Tuy nhiên, bạn nên làm quen với các giới hạn sử dụng đối với bất kỳ Nền tảng Google Maps nào mà ứng dụng của bạn dựa vào.

Sau khi bạn có tài khoản thanh toán, nếu bạn vượt quá hạn mức sử dụng miễn phí là 200 đô la Mỹ mỗi tháng và bạn 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.), thì API sẽ ngừng hoạt động cho đến khi bạn thêm một phương thức thanh toán hợp lệ.

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

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

Có thể đặt giá bằng các đơn vị tiền tệ khác không?

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

Tôi đã thiết lập thông tin thanh toán. Làm cách nào để xem hoá đơn 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 về việc 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 hạn mức yêu cầu hằng ngày và đặt hạn mức tối đa có thể tính phí hằng ngày. Bạn có thể đặt giới hạn tối đa hằng ngày đối với mức sử dụng để bảo vệ khỏi việc tăng mức sử dụng ngoài dự kiến. Bạn cũng có thể đặt cảnh báo về ngân sách để nhận thông báo qua email khi các khoản phí trên tài khoản thanh toán đạt đến ngưỡng mà bạn đặt.

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

Để tránh phải trả một khoản phí lớn, bạn có thể đặt giới hạn hằng ngày đối với mức sử dụng để tránh việc 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 Bảng điều khiển Google Cloud 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 bạn nhận được lời nhắc.
  3. Chọn một API trong danh sách, rồi 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 Bảng tổng quan về IAM và hạn mức dành cho quản trị viên.

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

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

Tôi nhận được thông báo cho biết dự án của mình được liên kết với "Tài khoản chuyển đổi của 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 Google Maps Platform" được tạo để giúp một số khách hàng chuyển sang gói giá trả theo mức sử 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 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 lên đến hạn mức của gói không tính phí 200 USD. Khi bạn vượt quá hạn mức này, tài khoản thanh toán sẽ ngừng hoạt động và bạn sẽ mất quyền truy cập vào dịch vụ. Để tránh bị gián đoạn dịch vụ, bạn nên thiết lập tài khoản thanh toán của riêng mình và tiếp tục sử dụng gói không tính phí 200 USD/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 hạn mức của tôi được đặt thành 1 yêu cầu mỗi ngày? Làm cách nào để tăng hạn mức này?

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

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

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

Bạn nhận được thông báo này vì Google xác định rằng tài khoản của bạn đã sử dụng nhiều tài khoản thanh toán. Đây là hành vi vi phạm điều khoản của Google, theo đị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 không được phép tạo nhiều tài khoản thanh toán. Để tìm hiểu thêm, hãy xem Câu hỏi thường gặp về lỗi vi phạm 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 khi sử dụng các sản phẩm của Google Maps Platform, bạn phải thêm một khoá API để xác thực yêu cầu của mình. 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à một giá trị nhận dạng duy nhất mà bạn tạo bằng Cloud Console.
  • Ví dụ về cách tải API bằng khoá: &key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo

Chữ ký số:

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

Hạn chế:

  • Bạn không bắt buộc phải đặt các quy tắc hạn chế đối với khoá API, nhưng bạn nên hạn chế tất cả khoá API để tăng cường 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 chi tiết.
  • Bạn có thể thêm quy tắc hạn chế ứ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 hạn chế đó. Có 4 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ế.
  • Bạn cũng có thể thêm quy tắc hạn chế API vào khoá API. Để biết thêm thông tin, hãy xem bài viết Lấy, thêm và hạn chế khoá API.

Bảng bên dưới cho biết khoá/thông tin xác thực và hạn chế về ứng dụng cho từng API/SDK của Nền tảng Google Maps.

API/SDK Hạn chế về thông tin xác thực và ứng dụng
SDK Bản đồ dành cho Android Khoá API có quy định hạn chế của Android1
SDK Địa điểm dành cho Android Khoá API có quy định hạn chế của Android1
Navigation SDK cho Android Khoá API có quy định hạn chế của Android1
SDK Bản đồ dành cho iOS Khoá API có quy định hạn chế đối với iOS1
SDK Địa điểm dành cho iOS Khoá API có quy định hạn chế đối với iOS1
Navigation SDK cho iOS Khoá API có quy định hạn chế đối với iOS1
Maps JavaScript API Khoá API có quy định hạn chế về liên kết giới thiệu HTTP1
Map Tiles API Khoá API có giới hạn về địa chỉ IP1
API Tập dữ liệu Maps Mã thông báo OAuth
Aerial View API Khoá API có giới hạn về địa chỉ IP1
Maps Static API Khoá API có hạn chế về liên kết giới thiệu HTTP1 + Chữ ký số2
Street View Static API Khoá API có hạn chế về liên kết giới thiệu HTTP1 + Chữ ký số2
Maps Embed API Khoá API có quy định hạn chế về liên kết giới thiệu HTTP1
Address Validation API Khoá API có giới hạn về địa chỉ IP1
Directions API Khoá API có giới hạn về địa chỉ IP1
Distance Matrix API Khoá API có giới hạn về địa chỉ IP1
Elevation API Khoá API có giới hạn về địa chỉ IP1
Geocoding API Khoá API có giới hạn về địa chỉ IP1
Geolocation API Khoá API có giới hạn về địa chỉ IP1
Places API Khoá API có giới hạn về địa chỉ IP1
Roads API Khoá API có giới hạn về địa chỉ IP1
Route API Khoá API có giới hạn về địa chỉ IP1
Time Zone API Khoá API có giới hạn về địa chỉ IP1
Air Quality API Khoá API có giới hạn về địa chỉ IP1
Pollen API Khoá API có giới hạn về địa chỉ IP1
Solar API Khoá API có giới hạn về địa chỉ IP1
1 Bạn không bắt buộc phải đặt quy tắc hạn chế đối với khoá API, nhưng bạn nên hạn chế tất cả khoá API để tăng cường bảo mật.
2 Tuỳ thuộc vào mục đích sử dụng, bạn có thể phải có chữ ký số cho Maps Static APIStreet View Static API. Bất kể mục đích sử dụng, bạn nên sử dụng cả khoá API và chữ ký số để xác thực các yêu cầu của mình.
Làm cách nào để chuyển đổi loại hạn chế khoá từ một trình giới thiệ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 bằng một khoá API có các hạn chế về trình giới thiệu, thì các yêu cầu của bạn sẽ không thành công và bạn sẽ nhận được thông báo lỗi: "Khoá API không được có các hạn chế về trình giới thiệ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 quy tắc hạn chế về địa chỉ IP.

Trước khi bạn chuyển đổi loại hạn chế khoá API từ trình giới thiệ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 hạn chế IP. Các API thuộc cùng một loại hạn chế có thể sử dụng cùng một khoá bị hạn chế. Nếu bạn cần thực thi nhiều quy định hạn chế, hãy thêm một khoá riêng biệt với quy định hạn chế bắt buộc. Xem cách thêm khoá API mới.

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

Để chuyển khoá API có quy tắc hạn chế liên kết giới thiệu HTTP sang quy tắc 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 chứa khoá API mà bạn muốn chỉnh sửa.
  3. Trên trang Thông tin xác thực, trong danh sách khoá API, hãy chọn tên của khoá API để chỉnh sửa thông tin chi tiết của khoá.
  4. Trong phần Key restriction (Hạn chế khoá), hãy chọn "IP addresses (web servers, cron jobs, etc.)" (Địa chỉ IP (máy chủ web, công việc cron, v.v.)) rồi chèn địa chỉ IP máy chủ thích hợp, sau đó nhấp vào Save (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 các thay đổi được giới thiệu trong từng phiên bản API Google Maps?

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

Bạn cũng có thể kiểm tra xem một lỗi cụ thể đã được phát hiện và khắc phục trong phiên bản nào của Nền tảng Google Maps 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 đã 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 Maps JavaScript.

Làm cách nào để các sản phẩm của Google Maps Platform hiển thị bằng 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 chế độ cài đặt trình duyệt. Một số API cho phép bạn đặt rõ ràng một ngôn ngữ khi bạn đưa ra yêu cầu. Bạn có thể xem thêm thông tin về cách đặt ngôn ngữ trong tài liệu của từng API:

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

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

Mã ngôn ngữ Ngôn ngữ Mã ngôn ngữ Ngôn ngữ
af Tiếng Afrikaans ja Tiếng Nhật
sq Tiếng Albania kn Tiếng Kannada
sáng Tiếng Amhara kk Tiếng Kazakh
ar Tiếng Ả Rập km Tiếng Khmer
hy Tiếng Armenia ko Tiếng Hàn
az Tiếng Azerbaijan ky Tiếng Kyrgyz
eu Tiếng Basque lo Tiếng Lào
be Tiếng Belarus lv Tiếng Latvia
bn Tiếng Bengal lt Tiếng Lithuania
bs Tiếng Bosnia mk Tiếng Macedonia
bg Tiếng Bungary ms Tiếng Malay
my Tiếng Myanmar ml Tiếng Malayalam
ca Tiếng Catalan mr Tiếng Marathi
zh Tiếng Trung mn Tiếng Mông Cổ
zh-CN Tiếng Trung (Giản thể) ne Tiếng Nepal
zh-HK Tiếng Trung (Hong Kong) không Tiếng Na Uy
zh-TW Tiếng Trung (Phồn thể) pl Tiếng Ba Lan
giờ Tiếng Croatia pt Tiếng Bồ Đào Nha
cs Tiếng Séc pt-BR Tiếng Bồ Đào Nha (Brazil)
da Tiếng Đan Mạch pt-PT Tiếng Bồ Đào Nha (Bồ Đào Nha)
nl Tiếng Hà Lan pa Tiếng Punjab
vi Tiếng Anh ro Tiếng Rumani
en-AU Tiếng Anh (Úc) ru Tiếng Nga
en-GB Tiếng Anh (Anh) sr Tiếng Serbia
et Tiếng Estonia si Tiếng Sinhala
fa Tiếng Ba Tư sk Tiếng Slovak
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 giao diện của bản đồ bằng bất kỳ ngôn ngữ nào được liệt kê ở trên trong ứng dụng mẫu này.

Có thể truy cập vào Nền tảng Google Maps qua SSL (HTTPS) không?

Bạn có thể truy cập vào 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 về API có liên quan để biết thông tin về cách truy cập API qua SSL.

Xin lưu ý rằng Maps Static API không hỗ trợ 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 cách nào để báo cáo lỗi hoặc yêu cầu tính năng mới trong Nền tảng Google Maps?

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

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

Sau khi bạn xác nhận rằng bạn đã phát hiện một lỗi mới hoặc chức năng hiện có của các sản phẩm trong Nền tảng Google Maps không đáp ứng được yêu cầu của bạn, vui lòng báo cáo lỗi hoặc yêu cầu tính năng bằ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, vui lòng kiểm tra để đảm bảo rằng lỗi hoặc tính năng có liên quan chưa được thêm. Nếu có, bạn có thể gắn dấu sao vào vấn đề để thể hiện sự quan tâm và nhận thông báo về nội dung cập nhật.

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

SDK Maps cho Android và SDK Maps cho iOS sử dụng cookie tuân theo Chính sách quyền riêng tư của Google, chẳng hạn như tính toán số người dùng đang hoạt động hằng ngày và trong 7 ngày, cũng như ngăn chặn hành vi sử dụng sai dịch vụ. Các cookie này không liên kết với bất kỳ Tài khoản Google nào đã đăng nhập và không được ghi lại cùng với 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 thấy câu trả lời cho câu hỏi của mình. Tôi nên liên hệ với ai?

Nhóm Quan hệ nhà phát triển của Google duy trì sự hiện diện trên Stack Overflow – một trang web hỏi và đáp do cộng đồng biên tập 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ề việc phát triển và duy trì các ứng dụng Google Maps. Bạn có thể xem thêm thông tin về cách đặt câu hỏi trên Stack Overflow trên trang Hỗ trợ.

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

  • Tìm kiếm trong các cuộc thảo luận hiện tại. Rất có thể ai đó đã 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 bạn không thể dễ dàng xem mã trên mạng.
  • Cung cấp tất cả thông tin liên quan, bao gồm cả phiên bản trình duyệt, lỗi và mọi thông tin thực tế 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

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 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ị tối hoặc hình ảnh "âm" của Chế độ xem đường phố, có hình mờ với văn bản "chỉ dành cho mục đích phát triển", có thể xuất hiện. Hành vi này thường cho thấy các vấn đề về khoá API hoặc thanh toán. Để sử dụng các sản phẩm của Google Maps Platform, bạn phải có tài khoản thanh toán và tất cả các yêu cầu phải có khoá API hợp lệ. Quy trình sau đây sẽ giúp bạn khắc phục vấn đề này:


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

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

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

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

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

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

  1. Chuyển đến trang Thông tin xác thực của Cloud Console.
  2. Chọn dự án chứa khoá API mà bạn muốn xem lại.
  3. Để xem thông tin chi tiết về thông tin xác thực, bao gồm mọi quy tắc hạn chế được đặt cho khoá, trong danh sách khoá API, hãy nhấp vào tên của khoá.
  4. Thông tin xác thực đầy đủ của khoá API đã chọn sẽ xuất hiện, bao gồm cả mọi quy tắc hạn chế đã 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ó hạn chế về trình giới thiệu với API này"?

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

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

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

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

Để xem những quốc gia hiện được trình định vị địa lý của Nền tảng Google Maps hỗ trợ, vui lòng tham khảo dữ liệu về phạm vi cung cấp của Google Maps.

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

Tại sao Trình định vị đị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). Trình định vị địa lý API thỉnh thoảng được cập nhật bằng dữ liệu mới, vì vậy, bạn có thể thấy kết quả thay đổi hoặc cải thiện theo thời gian.

Làm cách nào để định dạng truy vấn bộ mã hoá địa lý để tối đa hoá số lượng yêu cầu thành công?

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

  • Chỉ định địa chỉ theo định dạng mà dịch vụ bưu chính quốc gia của quốc gia liên quan sử dụng.
  • Không chỉ định các thành phần địa chỉ bổ sung như tên doanh nghiệp, số căn hộ, số tầng hoặc số phòng không có trong địa chỉ do dịch vụ bưu chính của quốc gia liên quan xác định. Việc này có thể dẫn đến các phản hồi có ZERO_RESULTS.
  • Định dạng mã cộng như minh hoạ ở đây (dấu cộng được chuyển đổi URL thành %2B và dấu cách được chuyển đổi URL thành %20):
    • Mã toàn cầu 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ã cục bộ có 6 ký tự trở lên với vị trí rõ ràng (CWC8+R9 Mountain View, CA, USA là CWC8%2BR9%20Mountain%20View%20CA%20USA).
  • Ưu tiên sử dụng số nhà của cơ sở lưu trú thay vì tên toà nhà nếu có thể.
  • Ưu tiên sử dụng địa chỉ số nhà thay vì chỉ định đường giao nhau nếu có thể.
  • Không cung cấp "gợi ý" như địa danh lân cận.
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ý?

Trình định vị địa lý của Nền tảng Google Maps yêu cầu bạn chỉ định các đường cao tốc được đánh số ở Hoa Kỳ trong địa chỉ như sau:

  • Đường cấp hạt: "Co Road NNN", trong đó NNN là số đường. Ví dụ: "Co Road 82"
  • Đường cao tốc tiểu bang: "State NNN", trong đó Tiểu bang là tên đầy đủ của tiểu bang và NNN là số đường cao tốc. Ví dụ: "California 82"
  • Đường cao tốc Hoa Kỳ: "U.S. NNN", trong đó NNN là số đường cao tốc. Ví dụ: "U.S. 101"
  • Đường liên tiểu bang ở Hoa Kỳ: "Interstate NNN", trong đó NNN là số đường 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: Chiến lược mã hoá địa lý. Tài liệu này trình bày 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 bằng xe ô tô bằng Nền tảng Google Maps?

Dịch vụ tính toán tuyến đường của Routes APIDirections API cho phép bạn cung cấp chỉ đường lái xe cho các chuyến đi 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 một chế độ đi lại (lái xe), một hoặc một nhóm tuyến đường và các quy định hạn chế (không có đường có thu phí). Các dịch vụ này có sẵn ở các dạng sau:

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

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

Tính năng chỉ đường bằng phương tiện công cộng có ở những quốc gia nào?

API chỉ đườngAPI ma trận khoảng cách hỗ trợ tất cả đối tác của Google Transit, ngoại trừ những đối tác ở Nhật Bản.

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

Lớp KmlLayer trong API Maps JavaScript cho phép 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.

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

Giới hạn về kích thước và độ phức tạp khi hiển thị KML bằng lớp KmlLayer được ghi lại 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 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 nhằm hiển thị. Do đó, bạn không thể hiển thị các tệp KML không được lưu trữ tại một URL có thể truy cập công khai hoặc yêu cầu xác thực để truy cập.

Nếu cần phát triển các ứng dụng sử dụng tệp KML được lưu trữ trên 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. Khi trình duyệt phân tích tệp KML, hiệu suất có thể thấp hơn so với khi sử dụng lớp KmlLayer.

Số lượng điểm đánh dấu hoặc đỉnh đường dẫn tối đa mà API Maps Static 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 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ể được sử dụng nhiều lần trong bản đồ.

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

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

Bạn không được sử dụng API Maps ở 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 cách nào để báo cáo vấn đề trên bản đồ cơ sở của Google?
Gửi ý kiến phản hồi thông qua Google Maps về thông tin trên bản đồ bị sai hoặc bị thiếu, chẳng hạn như:
  • Địa chỉ hoặc vị trí điểm đánh dấu sai
  • Tên đường không chính xác
  • Thông tin 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

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

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

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

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

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

API JavaScript cho Maps

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

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

SDK Google Maps dành cho iOS

Làm cách nào để giải quyết lỗi: kGMSPlacesRateLimitExceeded?
Nếu thấy lỗi này, 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 iOS. 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 của bạn để 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 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 vấn đề khi gỡ lỗi bằng các thiết bị chạy iOS 8.x, hãy làm theo các bước sau để tắt tính năng chụp khung hình GPU trong lược đồ XCode mà bạn đang chạy:

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

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

SDK Google Maps cho iOS có nhiều thành phần và thành phần đ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 vấn đề. Với phiên bản 2.4, các thành phần hình ảnh và thành phần điều khiển này có thể bị cắt bớt theo hình dạng màn hình mới. Ở chế độ ngang, bộ chọn tầng trong nhà có thể bị cắt bớt bởi phần cắt hoặc chỉ báo nút trang chủ.

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 sẽ được tự động khắc phục. Khi ứng dụng của bạn được sử dụng trên iPhone X trở lên, khoảng đệm trên GMSMapViewGMSPanoramaView 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 thêm khoảng đệm. SDK Google Maps 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ứ đều nằm trong vùng an toàn, thì giao diện này sẽ hoạt động mà không cần thêm bất kỳ nỗ lực nào.

Nếu bạn đã thiết kế một giao diện không hoạt động với chế độ điều chỉnh mặc định của chúng tôi, thì chúng tôi đã giới thiệu một thuộc tính mới cho GMSMapView, có tên là paddingAdjustmentBehavior. 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 bạn đặt GMSMapView để sử dụng hành vi khoảng đệm "Luôn luôn", thì lớp này sẽ luôn thêm 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 nằm ở các 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ì lớp này sẽ luôn chọn khoảng đệm lớn hơn hoặc phần lồng ghép vùng an toàn. Đ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ả cá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ì GMSMapView sẽ không bao giờ thêm phần lồng ghép vùng an toàn vào khoảng đệm. Đây là hành vi trước bản phát hành 2.5 và có thể hữu ích nếu khoảng đệm của bạn đã 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 Google và thông báo bản quyền luôn hiển thị, như được quy định trong Điều khoản dịch vụ của Google Maps Platform.

Ngược lại, GMSPanoramaView không có thuộc tính khoảng đệm không bắt buộc. Điều này có nghĩa là không có khoảng đệm nào để điều chỉnh và GMSPanoramaView sẽ luôn áp dụng mọi khoảng đệm cần thiết để đảm bảo rằng tất cả các thành phần 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 để giải quyết lỗi: 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
Nếu thấy lỗi này, 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. 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 của bạn để 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.
Ứng dụng của tôi chỉ hiển thị các ô màu xám trống thay vì bản đồ. Làm cách nào để giải quyết vấn đề này?

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

  1. Đảm bảo bạn đã cài đặt adb. Nếu chưa có, bạn có thể làm theo hướng dẫn tại đây.
  2. Cài đặt ứng dụng gặp vấn đề trên một thiết bị hoặc trình mô phỏng Android. Nếu bạn sử dụng trình mô phỏng Android, hãy đảm bảo rằng chế độ cài đặt trình mô phỏng có Cửa hàng Play.
  3. Trong dòng lệnh 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 mà 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ý 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 không chính xác/không mong muốn đang được tham chiếu trong Tệp kê khai.
    • Tính năng thanh toán chưa được bật trên Dự án.
    • SDK chưa được bật trên API dự án.
    • Vân tay SHA1 không chính xác được thêm vào các quy tắ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ộ khoá ký URL của bạn cho người dùng cuối. Do đó, các thành phần phía máy chủ chỉ nên tạo chữ ký.

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ý cho yêu cầu này. Lý do có thể là:

  1. Chữ ký đã được chỉ định nhưng không chính xác cho yêu cầu này.
  2. Yêu cầu chỉ định một khoá API cho Google Maps Platform Premium Plan nhưng không chỉ định chữ ký và dịch vụ được gọi yêu cầu các yêu cầu được thực hiện bằng khoá API phải có chữ ký hợp lệ.
  3. Bạn đã chỉ định chữ ký nhưng chưa chỉ định khoá API của gói Google Maps Premium.