Trang này cung cấp thông tin chi tiết về SKU, mã SKU, sự kiện có thể tính phí và điều kiện kích hoạt thanh toán cho SKU của Places API cũ, Directions API cũ và Distance Matrix API cũ. Để biết thông tin về các phiên bản hiện tại của những dịch vụ này, hãy xem phần Thông tin chi tiết về SKU của Places (Mới) và Thông tin chi tiết về SKU của Routes and Navigation. Để xem danh bạ của tất cả danh mục sản phẩm, hãy xem phần Tổng quan về thông tin chi tiết về việc sử dụng API.
Giới thiệu về bảng SKU
Các phần sau đây trình bày thông tin chi tiết về từng SKU:
| Danh mục | Cho biết SKU thuộc danh mục SKU Essentials, Pro hay Enterprise. |
| Sự kiện có thể tính phí | Sự kiện nào được tính phí cho SKU. |
| Điều kiện kích hoạt | Những phần tử mã nào kích hoạt sự kiện có thể tính phí. |
| Định giá | Đường liên kết đến bảng giá cho nhóm của SKU đó. |
SKU sản phẩm cũ của Places
Hãy xem SKU sản phẩm của Places (Mới) để biết các phiên bản mới nhất.
Giới thiệu về SKU dữ liệu địa điểm
Ba SKU Dữ liệu địa điểm là: Dữ liệu cơ bản, Dữ liệu liên hệ và Dữ liệu về bầu không khí.Một hoặc nhiều SKU dữ liệu được kích hoạt cho:
- Android: mỗi yêu cầu đến
fetchPlace()hoặcfindCurrentPlace() - iOS: mỗi lệnh gọi đến
fetchPlaceFromPlaceID:hoặcfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields: - Dịch vụ web: mỗi yêu cầu về Địa điểm, tuỳ thuộc vào các trường được chỉ định trong yêu cầu
SKU dữ liệu luôn được tính phí ngoài SKU cơ sở cho yêu cầu kích hoạt chúng. Ví dụ: một yêu cầu Chi tiết địa điểm bao gồm các trường Dữ liệu cơ bản sẽ được tính phí theo cả SKU Dữ liệu cơ bản và SKU Chi tiết địa điểm.
Đối với dịch vụ web, các yêu cầu API Địa điểm này cho phép bạn chỉ định các trường dữ liệu cần trả về:
Đối với dịch vụ web, các lệnh gọi Places API này KHÔNG hỗ trợ việc chỉ định các trường được trả về. Các lệnh gọi này luôn trả về tất cả dữ liệu Địa điểm, tính phí cho ba SKU Dữ liệu địa điểm ngoài phí cho mỗi yêu cầu API:
[ Essentials: Places Legacy ] |
|---|
SKU: Autocomplete – Theo mỗi yêu cầu
| Danh mục | Essentials | |
|---|---|---|
| Mã SKU |
7384-2DE4-D388 (Toàn cầu) 2164-BC00-53DC (Ấn Độ) |
|
| API | Place Autocomplete (Phiên bản cũ) Android, Place Autocomplete (Phiên bản cũ) iOS, Place Autocomplete (Phiên bản cũ) Web |
|
| Sự kiện có thể tính phí | Yêu cầu không có mã thông báo phiên | |
| Điều kiện kích hoạt |
|
|
| Ví dụ | Nếu bạn đưa ra yêu cầu từ một phiên Tự động hoàn thành không hợp lệ (ví dụ: phiên sử dụng lại mã thông báo phiên), thì bạn cũng sẽ bị tính phí theo SKU Tự động hoàn thành – Mỗi yêu cầu. Yêu cầu của tính năng Tự động hoàn thành từ Tiện ích Place Autocomplete của API JavaScript của Maps có thể bị tính phí theo SKU Tự động hoàn thành – Mỗi yêu cầu khi bạn đưa ra yêu cầu từ một phiên Tự động hoàn thành không hợp lệ. Tình huống này có thể xảy ra khi người dùng đang nhập hoặc sao chép/dán nhiều địa chỉ khác nhau vào tiện ích và không phải lúc nào cũng chọn cụm từ gợi ý của tính năng tự động hoàn thành. |
|
| Định giá |
Bảng giá (Toàn cầu) Bảng giá (Ấn Độ) |
SKU: Tự động hoàn thành (đi kèm với Place Details) – Mỗi phiên
| Danh mục | Essentials | |
|---|---|---|
| Mã SKU |
E9C9-934B-DDB1 (Toàn cầu) |
|
| API | Place Autocomplete (Phiên bản cũ) Android, Place Autocomplete (Phiên bản cũ) iOS, Place Autocomplete (Phiên bản cũ) Web |
|
| Sự kiện có thể tính phí | Phiên | |
| Điều kiện kích hoạt |
Các trường trong yêu cầu: Hãy nhớ chỉ định các trường bạn cần trong yêu cầu để tránh các khoản phí không cần thiết. Tuỳ thuộc vào các trường bạn chỉ định, yêu cầu Place Details cũng tạo ra các SKU dữ liệu sau:
Nếu bạn không chỉ định các trường trong yêu cầu Place Details, thì tất cả SKU dữ liệu sẽ được kích hoạt. Nếu bạn chỉ yêu cầu làm mới mã Chi tiết địa điểm (yêu cầu của bạn chỉ chỉ định trường |
|
| Ví dụ |
Các yêu cầu về tính năng tự động hoàn thành được cung cấp miễn phí. SKU cũ này sẽ tính phí khi bạn yêu cầu Place Details tiếp theo dựa trên mức giá thông thường của Place Details. Ví dụ này minh hoạ một loạt yêu cầu, theo nền tảng, sẽ dẫn đến các SKU sau trong hoá đơn của bạn, khi bạn xem hoá đơn theo SKU:
Ví dụ về yêu cầu theo nền tảng: Yêu cầu của Android
Yêu cầu trên iOS
Yêu cầu dịch vụ web
Place Autocomplete (input="par", session_token: XYZ) |
|
| Định giá |
Bảng giá (Toàn cầu) Bảng giá (Ấn Độ) |
Giới thiệu về phiên Tự động hoàn thành
Một phiên Tự động hoàn thành bao gồm một số yêu cầu Tự động hoàn thành (để truy xuất các đề xuất về một địa điểm khi người dùng nhập) và tối đa một yêu cầu Place Details (để truy xuất thông tin chi tiết về địa điểm mà người dùng chọn). Cùng một mã phiên được truyền đến yêu cầu Tự động hoàn thành và yêu cầu Place Details tiếp theo. Một phiên bắt đầu bằng yêu cầu Tự động hoàn thành đầu tiên (thường xảy ra khi người dùng bắt đầu nhập). Lệnh gọi Place Details được thực hiện khi người dùng đã chọn một trong các đề xuất Tự động hoàn thành. Nếu người dùng không chọn một đề xuất, thì lệnh gọi Chi tiết địa điểm sẽ không được thực hiện.
Sau khi người dùng chọn một địa điểm (tức là sau khi thực hiện lệnh gọi Place Details), bạn phải bắt đầu một phiên mới bằng mã phiên mới.
Bạn có thể tạo phiên tự động hoàn thành từ các API sau:
- Dịch vụ Place Autocomplete của Places API hoặc Dịch vụ Place Autocomplete của API JavaScript cho Maps. Bạn cần thiết kế ứng dụng để cung cấp mã phiên (bạn có thể cần thay đổi mã hiện có).
- Tiện ích Tự động hoàn thành của Maps JavaScript API. Tính năng thanh toán theo phiên sẽ tự động được bật trên các tiện ích đó mà không cần thay đổi mã.
Mã thông báo phiên chỉ dùng được cho một phiên người dùng và không được dùng cho nhiều phiên người dùng. Nếu bạn sử dụng lại mã thông báo phiên, thì phiên đó sẽ được coi là không hợp lệ và các yêu cầu sẽ được tính phí như thể không có mã thông báo phiên nào được cung cấp.
Yêu cầu Tự động hoàn thành và yêu cầu Place Details sử dụng phiên được tính phí theo các SKU khác nhau.
SKU: Dữ liệu cơ bản
SKU dữ liệu tính phí cho các trường Dữ liệu cơ bản trong yêu cầu Chi tiết địa điểm hoặc Tìm địa điểm.
| Danh mục | Essentials | |
|---|---|---|
| Mã SKU |
75D4-C522-326B (Toàn cầu) 5D7B-1F7B-395E (Ấn Độ) |
|
| API |
Chi tiết địa điểm (Cũ)
có Trường cơ bản
Tìm địa điểm (Cũ) có Trường cơ bản |
|
| Sự kiện có thể tính phí | Yêu cầu thành công đối với các trường Dữ liệu cơ bản | |
| Điều kiện kích hoạt |
Trường cho SDK Android
Trường cho iOS
Các trường cho dịch vụ web
|
|
| Dữ liệu thanh toán theo mặt nạ trường |
Yêu cầu của bạn được tính phí dựa trên các trường được cung cấp trong mặt nạ trường. Ví dụ:
|
|
| Định giá |
Bảng giá (Toàn cầu)
Bảng giá (Ấn Độ) |
SKU: Find Place – ID only
| Danh mục | Essentials | |
|---|---|---|
| Mã SKU |
44A2-D839-A3AC (Toàn cầu) FE05-60A4-CDDF (Ấn Độ) |
|
| API | Dịch vụ web Địa điểm – Tìm địa điểm | |
| Sự kiện có thể tính phí | Yêu cầu thành công chỉ đối với place_id |
|
| Điều kiện kích hoạt | Yêu cầu Tìm địa điểm không có trường nào được chỉ định hoặc chỉ có trường place_id: FindPlace(fields: place_id). |
|
| Định giá |
Bảng giá (Toàn cầu)
Bảng giá (Ấn Độ) |
SKU: Place Details – ID Refresh
| Danh mục | Essentials | |
|---|---|---|
| Mã SKU |
2D88-4302-6299 (Toàn cầu) 4604-F56B-7086 (Ấn Độ) |
|
| API | Chi tiết địa điểm (Phiên bản cũ) | |
| Sự kiện có thể tính phí | Yêu cầu thành công chỉ đối với các trường mã nhận dạng | |
| Điều kiện kích hoạt | Yêu cầu chỉ có trường Mã địa điểm:
getPlaceDetails(fields: place_id). |
|
| Định giá |
Bảng giá (Toàn cầu)
Bảng giá (Ấn Độ) |
SKU: Tự động hoàn thành cụm từ tìm kiếm – Mỗi yêu cầu
| Danh mục | Essentials | |
|---|---|---|
| Mã SKU |
C4B1-8805-63EF (Toàn cầu) 59E9-EB83-5CA3 (Ấn Độ) |
|
| API | Dịch vụ Tự động hoàn thành cụm từ tìm kiếm | |
| Sự kiện có thể tính phí | Yêu cầu thành công | |
| Điều kiện kích hoạt |
Tính năng Tự động hoàn thành cụm từ tìm kiếm không hỗ trợ mô hình định giá theo phiên Tự động hoàn thành. Các yêu cầu về Chi tiết địa điểm tiếp theo sẽ được tính phí dựa trên SKU Chi tiết địa điểm Pro. |
|
| Định giá |
Bảng giá (Toàn cầu)
Bảng giá (Ấn Độ) |
[ Pro: Places Legacy ] |
|---|
SKU: Tự động hoàn thành không có Place Details – Mỗi phiên
| Danh mục | Pro | |
|---|---|---|
| Mã SKU |
B52C-8320-6DC5 (Toàn cầu) C625-D3CE-DF37 (Ấn Độ) |
|
| API | Place Autocomplete (Phiên bản cũ) Android, Place Autocomplete (Phiên bản cũ) iOS, Place Autocomplete (Phiên bản cũ) Web |
|
| Sự kiện có thể tính phí | Phiên | |
| Điều kiện kích hoạt |
|
|
| Định giá |
Bảng giá (Toàn cầu)
Bảng giá (Ấn Độ) |
SKU: Tìm địa điểm hiện tại
| Danh mục | Pro | |
|---|---|---|
| Mã SKU |
7218-264C-D1D7 (Toàn cầu) 0862-F46E-1A1A (Ấn Độ) |
|
| API | Places SDK cho Android, Places SDK cho iOS |
|
| Sự kiện có thể tính phí | Yêu cầu thành công | |
| Điều kiện kích hoạt |
|
|
| Ví dụ |
Các ví dụ sau đây cho thấy những SKU mà bạn phải trả phí khi đưa ra yêu cầu Tìm địa điểm hiện tại và chỉ định các trường trong SKU dữ liệu Cơ bản, Liên hệ và Không khí. Để xem các SKU trên hoá đơn, hãy xem hoá đơn theo SKU như mô tả trong phần Phân tích mức sử dụng và chi phí theo SKU. Bạn đưa ra yêu cầu Tìm địa điểm hiện tại chỉ với trường
Hoá đơn của bạn cho thấy các SKU sau:
Bạn đưa ra yêu cầu Tìm địa điểm hiện tại chỉ với trường
Hoá đơn của bạn cho thấy các SKU sau:
Bạn đưa ra yêu cầu Tìm địa điểm hiện tại với cả ba trường loại dữ liệu:
Hoá đơn của bạn cho thấy các SKU sau:
|
|
| Định giá |
Bảng giá (Toàn cầu)
Bảng giá (Ấn Độ) |
SKU: Tìm địa điểm
| Danh mục | Pro | |
|---|---|---|
| Mã SKU |
DC67-3188-2294 (Toàn cầu) (ECB4-087C-9A27 (Ấn Độ) |
|
| API | Tìm địa điểm (Cũ) | |
| Sự kiện có thể tính phí | Yêu cầu thành công cho nhiều trường hơn là chỉ trường mã nhận dạng | |
| Điều kiện kích hoạt | Yêu cầu Tìm địa điểm có nhiều trường được chỉ định hơn là chỉ trường mã nhận dạng. | |
| Ví dụ |
Các ví dụ sau đây cho thấy những SKU mà bạn phải trả phí khi đưa ra yêu cầu Tìm địa điểm hiện tại và chỉ định các trường trong SKU dữ liệu Cơ bản, Liên hệ và Không khí. Để xem các SKU trên hoá đơn, hãy xem hoá đơn theo SKU như mô tả trong phần Phân tích mức sử dụng và chi phí theo SKU. Bạn đưa ra yêu cầu Tìm địa điểm chỉ với trường
Hoá đơn của bạn cho thấy các SKU sau:
Bạn đưa ra yêu cầu Tìm địa điểm chỉ với trường
Hoá đơn của bạn cho thấy các SKU sau:
Bạn tạo một yêu cầu Tìm địa điểm với cả ba trường loại dữ liệu:
Hoá đơn của bạn cho thấy các SKU sau:
|
|
| Định giá |
Bảng giá (Toàn cầu)
Bảng giá (Ấn Độ) |
SKU: Địa điểm – Tìm kiếm lân cận
| Danh mục | Pro | |
|---|---|---|
| Mã SKU |
6B23-8A17-D29D (Toàn cầu) CC66-BE0E-2477 (Ấn Độ) |
|
| API | Nearby Search (Phiên bản cũ) | |
| Sự kiện có thể tính phí | Yêu cầu thành công về các tính năng của gói Pro | |
| Điều kiện kích hoạt |
Yêu cầu này không hỗ trợ việc chỉ định những trường cần trả về. Phản hồi trả về danh sách các địa điểm và một tập hợp con của các trường dữ liệu được hỗ trợ. |
|
| Ví dụ |
Bạn gửi một yêu cầu Nearby Search, chẳng hạn như
|
|
| Định giá |
Bảng giá (Toàn cầu) Bảng giá (Ấn Độ) |
SKU: Địa điểm – Tìm kiếm văn bản
| Danh mục | Pro | |
|---|---|---|
| Mã SKU |
E95A-86C7-7F47 (Toàn cầu) 102E-888D-5596 (Ấn Độ) |
|
| API | Tìm kiếm văn bản (Cũ) | |
| Sự kiện có thể tính phí | Yêu cầu thành công đến Tìm kiếm văn bản (Cũ) | |
| Điều kiện kích hoạt |
Yêu cầu Tìm kiếm văn bản trả về danh sách địa điểm, nhưng không hỗ trợ việc chỉ định trường nào được trả về. Yêu cầu Tìm kiếm văn bản trả về một tập hợp con các trường dữ liệu được hỗ trợ. Bạn sẽ bị tính phí cho yêu cầu Tìm kiếm văn bản cũng như tất cả SKU loại dữ liệu: Dữ liệu cơ bản, Dữ liệu liên hệ và Dữ liệu không khí.
SKU: Địa điểm – Tìm kiếm văn bản cũng được kích hoạt bằng phương thức
|
|
| Ví dụ |
Nếu bạn đưa ra yêu cầu Tìm kiếm văn bản (Cũ), hoá đơn của bạn sẽ cho thấy các SKU này khi bạn xem hoá đơn theo SKU:
|
|
| Định giá |
Bảng giá (Toàn cầu)
Bảng giá (Ấn Độ) |
SKU: Chi tiết địa điểm
| Danh mục | Pro | |
|---|---|---|
| Mã SKU |
FC5C-DF28-543F (Toàn cầu) F7AA-FEF9-C90E (Ấn Độ) |
|
| API | Chi tiết địa điểm (Phiên bản cũ) | |
| Sự kiện có thể tính phí | Yêu cầu thành công về các tính năng của gói Pro | |
| Điều kiện kích hoạt |
Với API và dịch vụ web, SKU Chi tiết địa điểm sẽ bị tính phí cho dù bạn có cung cấp mã phiên hay không. |
|
| Ví dụ |
|
|
| Định giá |
Bảng giá (Toàn cầu) Bảng giá (Ấn Độ) |
[ Enterprise: Places Legacy ] |
|---|
SKU: Dữ liệu khí quyển
SKU dữ liệu tính phí cho các trường Dữ liệu về bầu không khí trong yêu cầu Chi tiết địa điểm hoặc Tìm địa điểm.
| Danh mục | Enterprise | |
|---|---|---|
| Mã SKU |
D63D-5CC5-302A (Toàn cầu) 0CE0-1963-137E (Ấn Độ) |
|
| API |
Place Details (Phiên bản cũ)
có trường Bầu không khí
Tìm địa điểm (Phiên bản cũ) có trường Bầu không khí |
|
| Sự kiện có thể tính phí | Yêu cầu thành công đối với các trường dữ liệu về bầu khí quyển | |
| Điều kiện kích hoạt | ||
| Ví dụ về thông tin thanh toán của mặt nạ trường |
Yêu cầu của bạn được tính phí dựa trên các trường được cung cấp trong mặt nạ trường. Ví dụ:
|
|
| Định giá | Bảng giá (Toàn cầu) Bảng giá (Ấn Độ) |
SKU: Dữ liệu danh bạ
SKU dữ liệu tính phí cho các trường Dữ liệu liên hệ trong yêu cầu Chi tiết địa điểm hoặc Tìm địa điểm.
| Danh mục | Enterprise | |
|---|---|---|
| Mã SKU |
F095-CD01-81B2 (Toàn cầu) A03F-5079-C66C (Ấn Độ) |
|
| API |
Place Details (Cũ)
có Trường thông tin liên hệ
Tìm địa điểm (Cũ) có Trường thông tin liên hệ |
|
| Sự kiện có thể tính phí | Yêu cầu thành công đối với các trường Dữ liệu liên hệ | |
| Điều kiện kích hoạt |
Trường cho SDK Android
Trường cho SDK iOS
Các trường cho dịch vụ web
|
|
| Dữ liệu thanh toán theo mặt nạ trường |
Yêu cầu của bạn được tính phí dựa trên các trường được cung cấp trong mặt nạ trường. Ví dụ:
|
|
| Định giá |
Bảng giá (Toàn cầu)
Bảng giá (Ấn Độ) |
SKU: Ảnh về địa điểm
| Danh mục | Enterprise | |
|---|---|---|
| Mã SKU |
81E7-85D0-58A7 (Toàn cầu) 9F4B-2E19-1B63 (Ấn Độ) |
|
| API | Ảnh địa điểm (Cũ) | |
| Sự kiện có thể tính phí | Yêu cầu ảnh thành công | |
| Điều kiện kích hoạt |
|
|
| Định giá |
Bảng giá (Toàn cầu)
Bảng giá (Ấn Độ) |
SKU của Routes API cũ
[ Essentials: Routes Legacy ] |
|---|
SKU: Đường đi
| Danh mục | Essentials | |
|---|---|---|
| Mã SKU |
28A8-3EB4-4595 (Toàn cầu) 4714-291C-3199 (Ấn Độ) |
|
| API | Dịch vụ chỉ đường của Maps JavaScript API, Directions API (Phiên bản cũ) |
|
| Sự kiện có thể tính phí | Yêu cầu thành công nhưng không có tính năng Pro hoặc Enterprise | |
| Điều kiện kích hoạt | Cụm từ tìm kiếm không kích hoạt SKU được xếp hạng cao hơn | |
| Định giá |
Bảng giá (Toàn cầu) Bảng giá (Ấn Độ) |
SKU: Distance Matrix
| Danh mục | Essentials | |
|---|---|---|
| Mã SKU |
C1B6-FF9D-7700 (Toàn cầu) 558A-4F88-F361 (Ấn Độ) |
|
| API | Distance Matrix API (Cũ), Dịch vụ ma trận khoảng cách của Maps JavaScript API |
|
| Sự kiện có thể tính phí | Mỗi phần tử không chứa các tính năng của gói Pro hoặc Enterprise. Mỗi yêu cầu gửi đến Distance Matrix API sẽ tạo ra các phần tử, trong đó số lượng origins nhân với số lượng destinations bằng số lượng phần tử. |
|
| Điều kiện kích hoạt | Yêu cầu về các thành phần không kích hoạt SKU có giá cao hơn | |
| Định giá |
Bảng giá (Toàn cầu)
Bảng giá (Ấn Độ) |
[ Pro: Routes Legacy ] |
|---|
SKU: Directions Advanced
| Danh mục | Pro | |
|---|---|---|
| Mã SKU |
9407-00C2-CF85 (Toàn cầu) E27B-BD57-FD7D (Ấn Độ) |
|
| API | Dịch vụ chỉ đường của Maps JavaScript API, Directions API (Phiên bản cũ) |
|
| Sự kiện có thể tính phí | Yêu cầu thành công có các tính năng của gói Pro | |
| Điều kiện kích hoạt |
|
|
| Định giá |
Bảng giá (Toàn cầu)
Bảng giá (Ấn Độ) |
SKU: Distance Matrix Advanced
| Danh mục | Pro | |
|---|---|---|
| Mã SKU |
DFAE-763F-CF6E (Toàn cầu) C0F4-32AE-F6D1 (Ấn Độ) |
|
| API | Distance Matrix API (Cũ), Dịch vụ ma trận khoảng cách của Maps JavaScript API |
|
| Sự kiện có thể tính phí | Mỗi thành phần đều có các tính năng của gói Pro. Mỗi yêu cầu gửi đến Distance Matrix API sẽ tạo ra các phần tử, trong đó số lượng origins nhân với số lượng destinations bằng số lượng phần tử. |
|
| Điều kiện kích hoạt |
|
|
| Định giá |
Bảng giá (Toàn cầu)
Bảng giá (Ấn Độ) |
Trang thông tin chi tiết về SKU có liên quan
- Tổng quan về thông tin sử dụng API: Danh mục SKU hoàn chỉnh được sắp xếp theo các cấp Essentials, Pro, Enterprise và Phiên bản cũ.
- Thông tin chi tiết về SKU của Maps: Maps SDK cho Android, SDK bản đồ dành cho iOS, Maps JavaScript API, Maps Embed API, Maps Static API, Street View Static API, Elevation API, Aerial View API và SKU của Map Tiles API.
- Thông tin chi tiết về SKU của Routes: SKU của Routes API, Route Optimization API, Roads API và SDK chỉ đường.
- Thông tin chi tiết về SKU Địa điểm (Mới): Các SKU Places API (Mới), Places UI Kit, Places Aggregate API, Address Validation API, Geocoding API, Geolocation API, Time Zone API và Maps Grounding Lite.
- Thông tin chi tiết về SKU của Environment: SKU của Air Quality API, Pollen API, Solar API và Weather API.
- Giá của Google Maps Platform và Giá tại Ấn Độ: Các bậc khối lượng hằng tháng và mức giá cho mỗi sự kiện.