Tính năng báo cáo trong Nền tảng Google Maps cung cấp một tập hợp hình ảnh trực quan được xác định trước các báo cáo cơ bản về việc sử dụng API, hạn mức và thông tin thanh toán trong Bảng điều khiển Google Cloud. Sử dụng các báo cáo này để xác định số lượng API những lệnh gọi bạn đã thực hiện, bạn còn cách nào để đạt đến hạn mức sử dụng API và mức sử dụng thanh toán của bạn theo thời gian.
Các loại báo cáo bao gồm:
- Báo cáo sử dụng: Báo cáo số lượng yêu cầu mà dự án của bạn thực hiện API Nền tảng Google Maps bằng thông tin đăng nhập được liên kết với dự án của bạn.
- Báo cáo hạn mức: Báo cáo việc sử dụng hạn mức trong các biểu đồ có thể được nhóm theo yêu cầu mỗi phút. Giới hạn hạn mức hiện tại đối với những API đã chọn được hiển thị trong bảng bên dưới biểu đồ sử dụng hạn mức.
- Báo cáo thanh toán: Báo cáo chi phí theo thời gian dưới dạng biểu đồ dạng đường xếp chồng. Xem hạn mức sử dụng của tháng hiện tại, bao gồm mọi khoản tín dụng theo mức sử dụng cụ thể đã áp dụng cũng như tổng chi phí dự đoán cho toàn bộ tháng hiện tại.
- Báo cáo mức độ tương tác: Cung cấp thông tin chi tiết về hoạt động kinh doanh về cách người dùng tương tác với các ứng dụng bản đồ của bạn.
Để xem danh sách đầy đủ các trạng thái phản hồi và mã phản hồi giúp xác định liệu một yêu cầu có xuất hiện trong mục Mức sử dụng, Hạn mức hay không, và/hoặc báo cáo Thanh toán, xem Trạng thái phản hồi và báo cáo.
Xem báo cáo về việc sử dụng, hạn mức và thanh toán của Nền tảng Google Maps bằng cách sử dụng Bảng điều khiển Cloud.
Báo cáo về việc sử dụng
Mức sử dụng được xác định dựa trên số lượng yêu cầu mà dự án của bạn đưa ra đối với API của Nền tảng Google Maps sử dụng thông tin đăng nhập được liên kết với dự án. Yêu cầu bao gồm yêu cầu thành công, yêu cầu dẫn đến máy chủ và các yêu cầu dẫn đến lỗi ứng dụng. Thông tin đăng nhập bao gồm Khoá API và mã ứng dụng khách (đối với các dự án Gói cao cấp và Gói cao cấp đã di chuyển). Để biết thông tin chi tiết, hãy xem phần Tổng quan về gói cao cấp và thông tin về cách sử dụng client ID.
Chỉ số về mức sử dụng được hiển thị trong bảng (Yêu cầu, Lỗi và Độ trễ) và biểu đồ (Lưu lượng truy cập, lỗi và độ trễ). Đối với mục đích theo dõi:
Tất cả API: Bạn có thể lọc và nhóm chỉ số sử dụng cho tất cả các API trong những API này cách:
- Lọc theo khoảng thời gian và API.
- Xem lưu lượng truy cập, lỗi và độ trễ được nhóm theo mã phản hồi, API và chứng chỉ danh tính.
Một API cụ thể: Bạn có thể lọc và nhóm các chỉ số sử dụng cho một API cụ thể theo các cách sau:
- Lọc theo khoảng thời gian, phiên bản API, thông tin xác thực và phương thức.
- Xem lưu lượng truy cập, lỗi và độ trễ được nhóm theo mã phản hồi, phương thức API phiên bản, phiên bản và thông tin đăng nhập.
API và Trang tổng quan về dịch vụ
Các API và Dịch vụ Trang tổng quan cung cấp thông tin tổng quan về các chỉ số sử dụng cho tất cả API được bật cho dự án của bạn: API Nền tảng Google Maps cũng như các API và dịch vụ.
Trang tổng quan có ba biểu đồ và một bảng. Bạn có thể lọc dữ liệu sử dụng được hiển thị trên biểu đồ và bảng bằng cách chọn khoảng thời gian từ 1 giờ đến 30 ngày qua.
Biểu đồ Lưu lượng truy cập thể hiện mức sử dụng số truy vấn mỗi phút (QPM) trên mỗi API.
Biểu đồ Lỗi cho thấy tỷ lệ phần trăm số yêu cầu dẫn đến lỗi cho mỗi API.
Biểu đồ Độ trễ cho thấy độ trễ trung bình của các yêu cầu trên mỗi API.
Bên dưới biểu đồ là một bảng liệt kê các API và dịch vụ đã bật. Số lượng yêu cầu là số lượng yêu cầu (trong khoảng thời gian đã chọn). Lỗi là số lượng những yêu cầu này đã dẫn đến lỗi. Độ trễ (độ trễ trung bình và phân vị) là độ trễ cho các yêu cầu này.
Để truy cập các API và Trang tổng quan về dịch vụ:
- Mở trang Bộ chọn dự án trong Cloud Console:
- Chọn dự án của bạn. Các API và Trang tổng quan về dịch vụ sẽ xuất hiện.
Nếu trang không xuất hiện, hãy chọn nút trình đơn
rồi chọn API & Dịch vụ.
Để biết thêm thông tin, hãy xem bài viết Giám sát việc sử dụng API.
Trang tổng quan của Google Maps
Google Maps Trang Tổng quan bao gồm bảng liệt kê các API được bật và yêu cầu sử dụng trong 30 ngày qua. Các yêu cầu theo API cũng được thể hiện ở dạng biểu đồ. Một biểu đồ thanh toán cho thấy hoá đơn hiện tại của bạn và tổng mức sử dụng trong 3 tháng qua.
Cách truy cập vào Trang tổng quan của Nền tảng Google Maps:
- Mở trang Nền tảng Google Maps trong Bảng điều khiển Cloud:
- Trên trình đơn bên trái, hãy chọn Tổng quan.
API của Nền tảng Google Maps và Trang dịch vụ
Google Maps API và Trang Dịch vụ chứa một lưới ô đại diện cho API, SDK và các dịch vụ khác có sẵn cho dự án của bạn. Trong mỗi thẻ thông tin, bạn có thể bật hoặc tắt tính năng đó bằng cách chọn Bật hoặc Tắt, sau đó bạn có thể truy cập vào thông tin đăng nhập thông tin, chỉ số và hướng dẫn sử dụng cho các API đã bật. Bạn cũng có thể dùng bộ lọc trang để xem các dịch vụ đã bật hoặc tắt và các danh mục dịch vụ khác.
Để truy cập API của Nền tảng Google Maps và Trang dịch vụ:
- Mở trang Nền tảng Google Maps trong Bảng điều khiển Cloud:
- Trong trình đơn bên trái, hãy chọn API và Dịch vụ.
Trang Chỉ số trên Google Maps
Google Maps Trang Chỉ số hiển thị ba biểu đồ: Lưu lượng truy cập, Lỗi và Độ trễ trung bình. Bạn có thể nhóm dữ liệu sử dụng trong các biểu đồ theo lớp Mã phản hồi, API, phương thức API, Thông tin xác thực, Nền tảng và Miền.
Bên dưới các biểu đồ, trang Chỉ số bao gồm một bảng API cho biết yêu cầu, lỗi và độ trễ của những API bạn đã chọn.
Sử dụng trình đơn thả xuống API ở trên cùng cùng các tuỳ chọn nhóm và lọc ở ngăn bên phải, bạn có thể nhóm và lọc các chỉ số sử dụng được hiển thị bằng cách chọn một hoặc nhiều API cụ thể, Thông tin xác thực, lớp Mã phản hồi, Loại nền tảng và/hoặc Miền. Bạn cũng có thể chọn một khoảng thời gian (từ 1 giờ đến 30 ngày qua) và độ chi tiết (mỗi giây hoặc ngày) cho các chỉ số sử dụng được hiển thị.
Các hình ảnh sau đây minh hoạ bộ lọc Nền tảng và Miền cho một API khi việc nhóm theo Nền tảng và Miền được chọn trong danh sách thả xuống Nhóm theo:
Cách truy cập vào trang Chỉ số API của Nền tảng Google Maps:
- Mở trang Nền tảng Google Maps trong Bảng điều khiển Cloud:
- Trong trình đơn bên trái, hãy chọn Chỉ số.
Báo cáo thông tin xác thực
Bạn có thể lọc và nhóm các chỉ số theo thông tin xác thực đã được dùng để tải API.
| Định dạng của thông tin xác thực | Ý nghĩa |
|---|---|
| Tên khoá Ví dụ: "Khoá ứng dụng di động" |
Khoá API đã được dùng để tải API bằng
?key=...: Bạn có thể tìm thấy các tên khoá trên Nền tảng Maps
Bảng điều khiển trong mục Khoá và Thông tin xác thực. |
| Số dự án Ví dụ: "project_number:123456", trong đó 123456 là số dự án của bạn. |
Có 2 khả năng nếu bạn thấy bằng chứng xác thực này:
|
Biểu đồ mã phản hồi
Phân chia biểu đồ Lưu lượng truy cập theo mã phản hồi và Lỗi theo mã phản hồi theo lớp mã phản hồi HTTP. Bảng này hiển thị mối liên kết giữa trạng thái phản hồi của API Nền tảng Google Maps và lớp mã phản hồi HTTP:
| Trạng thái của API Maps | Lớp mã phản hồi HTTP – Báo cáo sử dụng (2xx, 3xx, 4xx, 5xx) |
Ghi chú |
|---|---|---|
| OK | 2xx | Phản hồi thành công. Đây là yêu cầu có thể tính phí và sẽ dùng hạn mức. |
| OK | 3xx | Phản hồi thành công. Đây là yêu cầu có thể tính phí và sẽ dùng hạn mức. Ví dụ: Ảnh địa điểm yêu cầu thành công sẽ trả về lệnh chuyển hướng 302 cho hình ảnh được tham chiếu. |
| DATA_NOT_AVAILABLE | 4xx(1) | Phản hồi thành công cho biết rằng không có dữ liệu nào cho
vị trí nhập. Đây là yêu cầu có thể tính phí và sẽ dùng hạn mức. |
| ZERO_RESULTS | 4xx(1) | Phản hồi thành công không trả về kết quả nào. Đây là yêu cầu có thể tính phí và sẽ dùng hạn mức. |
| NOT_FOUND | 4xx(1) | Đối với
API Chỉ đường,
thông báo này cho biết rằng ít nhất một trong số các vị trí được chỉ định trong
Không thể mã hoá địa lý nguồn gốc, đích đến hoặc điểm tham chiếu của yêu cầu. Đối với API Địa điểm thông báo này cho biết vị trí được tham chiếu (place_id) không phải tìm thấy trong cơ sở dữ liệu Địa điểm. Đây là yêu cầu có thể tính phí và sẽ dùng hạn mức. |
| INVALID_REQUEST (giá trị thông số không hợp lệ), MAX_WAYPOINTS_EXCEEDED, MAX_ROUTE_LENGTH_EXCEEDED và các mã khác. |
4xx | Lỗi do giá trị thông số không hợp lệ gây ra. Kiểm tra API
để biết thêm chi tiết. Đây là yêu cầu có thể tính phí và sẽ dùng hạn mức. |
| REQUEST_DENIED | 4xx | Lỗi ứng dụng khách do lỗi xác thực, lỗi truy cập và các lỗi khác. Hãy kiểm tra phản hồi của API để biết thêm thông tin chi tiết. |
| OVER_DAYS_LIMIT, OVER_QUERY_LIMIT, TÀI NGUYÊN_EXHAUSTED, Đã vượt quá giới hạn tỷ lệ, Đã vượt quá giới hạn hằng ngày, userRateLimitExceeded |
4xx | Lỗi ứng dụng khách do có quá nhiều yêu cầu trong khoảng thời gian cho phép. Thử lại yêu cầu sau đó. Hãy kiểm tra phản hồi của API để biết thêm thông tin chi tiết. |
| INVALID_REQUEST (thông số, yêu cầu không hợp lệ hoặc bị thiếu lỗi phân tích cú pháp hoặc xác thực) | 4xx | Lỗi ứng dụng do yêu cầu không hợp lệ. Kiểm tra phản hồi của API để biết thêm thông tin chi tiết. |
| NOT_FOUND (404) | 4xx | Đối với
API vị trí địa lý,
thông báo này cho biết rằng dữ liệu đầu vào không đủ để tạo
ước tính vị trí. Đối với Roads API, thông báo này cho biết rằng không thể chụp nhanh đầu vào một cách hợp lý vào các con đường. Đây là yêu cầu có thể tính phí và sẽ dùng hạn mức. |
| UNKNOWN_ERROR | 5xx | Lỗi máy chủ cho biết không thể xử lý yêu cầu: nội bộ lỗi, dịch vụ quá tải, không có sẵn, hết thời gian chờ và các lỗi khác. |
1
Để cải thiện tính nhất quán của báo cáo mã lỗi, Nền tảng Google Maps
Các API đang di chuyển:
1) từ lớp mã phản hồi HTTP 2xx đến 4xx đối với
Các trạng thái của API Maps: DATA_NOT_AVAILABLE, NOT_FOUND,
ZERO_RESULTS - trạng thái,
2) từ lớp mã phản hồi HTTP 2xx đến 4xx cho
Các trạng thái của API Maps: REQUEST_DENIED, OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT, dailyLimitExceeded,
rateLimitExceeded, userRateLimitExceeded,
3) từ lớp mã phản hồi HTTP 2xx đến 5xx cho
Trạng thái của API Maps: UNKNOWN_ERROR.
Bạn có thể thấy cả hai mã phản hồi trong quá trình chuyển đổi
6 tháng. Mã phản hồi được trả về trong các phản hồi của API Maps không thay đổi.
Xác nhận rằng 4xx và/hoặc 5xx tăng lên
Các chỉ số trên Nền tảng Google Maps
liên quan đến việc di chuyển này bằng cách kiểm tra xem mã phản hồi chính xác nào sẽ tăng trong
Trình khám phá chỉ số
(tìm hiểu thêm về cách sử dụng
Giám sát của Google Cloud dành cho Nền tảng Google Maps).
|
||
Để biết thêm thông tin về mã trạng thái và thông báo lỗi, hãy xem nội dung phản hồi cho API mà bạn quan tâm (ví dụ: Câu trả lời mã hoá địa lý hoặc Phản hồi về đường đi).
Thông số giải pháp của Nền tảng Google Maps
Nền tảng Google Maps cung cấp nhiều loại mã mẫu để giúp bạn bắt kịp và hoạt động nhanh chóng. Ví dụ: bạn có thể sử dụng Trình tạo nhanh trong Cloud Console, làm theo các giải pháp trong ngành hướng dẫn triển khai, và học hỏi từ lớp học lập trình
Để hiểu cách sử dụng và cách cải thiện các giải pháp của chúng tôi, Google đưa vào
Tham số truy vấn solution_channel
trong lệnh gọi API để thu thập thông tin về việc sử dụng mã mẫu:
- Tham số truy vấn
solution_channelđược đưa vào theo mặc định trong mã mẫu giải pháp. - Tham số truy vấn trả về số liệu phân tích về việc áp dụng giải pháp cho Google nhằm cải thiện chất lượng giải pháp trong các lần lặp lại sau này.
- Bạn có thể chọn không sử dụng bằng cách xoá truy vấn
solution_channelvà giá trị của tham số đó từ mã mẫu. - Bạn không cần phải giữ lại thông số này. Đang xoá cụm từ tìm kiếm không ảnh hưởng đến hiệu suất.
- Tham số truy vấn chỉ được dùng cho báo cáo mức sử dụng mã mẫu.
- Tham số truy vấn tách biệt với mọi phân tích dành riêng cho API và báo cáo. Tức là xoá tham số khỏi mã mẫu giải pháp không tắt tính năng báo cáo nội bộ của API Maps JavaScript.
Báo cáo hạn mức
Hạn mức đặt ra giới hạn về số lượng yêu cầu mà dự án của bạn có thể thực hiện đối với API của Nền tảng Google Maps. Bạn có thể giới hạn yêu cầu theo 3 cách: mỗi ngày, mỗi phút và mỗi người dùng mỗi phút. Chỉ những yêu cầu thành công và các yêu cầu gây ra lỗi máy chủ sẽ được tính vào hạn mức. Yêu cầu xác thực không thành công sẽ không được tính vào hạn mức.
Hạn mức sử dụng được trình bày trong biểu đồ trên trang Hạn mức trong Cloud Console. và có thể được nhóm theo yêu cầu mỗi phút. Giới hạn hạn mức hiện tại cho API đã chọn được hiển thị trong bảng bên dưới mức sử dụng hạn mức biểu đồ.
Để nhận giá trị hạn mức mỗi phút cho bất kỳ sản phẩm GMP API nào, hãy sử dụng .
Trang Hạn mức của Google Maps
Google Maps Trang Hạn mức hiển thị hạn mức và mức sử dụng hạn mức cho API cụ thể mà bạn đã chọn.
Biểu đồ hạn mức sử dụng trên Google Cloud Console cho biết tổng lưu lượng truy cập của khoá API và mã ứng dụng khách của bạn. Lưu lượng truy cập mã ứng dụng khách cũng có trong Biểu đồ chỉ số trên Cloud Console.
Trang này chỉ hiển thị các yêu cầu sử dụng hạn mức: yêu cầu thành công (OK,
ZERO_RESULTS, DATA_NOT_AVAILABLE) và các yêu cầu gây ra lỗi máy chủ
(NOT_FOUND, INVALID_REQUEST/INVALID_VALUE (giá trị tham số không hợp lệ), UNKNOWN_ERROR).
Các yêu cầu gây ra lỗi ứng dụng – xác thực, uỷ quyền và
lỗi đối số không hợp lệ (REQUEST_DENIED, OVER_QUERY_LIMIT, INVALID_REQUEST
(tham số không hợp lệ, lỗi phân tích cú pháp yêu cầu))
— không được tính vào hạn mức và không được hiển thị.
Đơn vị hạn mức là yêu cầu cho hầu hết API Nền tảng Google Maps (API Tĩnh của Maps, API Tĩnh của Chế độ xem phố, API mã hóa địa lý, API chỉ đường Places API, Time Zone API, API vị trí địa lý và API độ cao), nhưng có một số ngoại lệ:
- Đối với API Ma trận khoảng cách, đơn vị hạn mức là một phần tử là cặp điểm xuất phát-điểm đến.
- Đối với API Maps JavaScript, đơn vị hạn mức là một lượt tải bản đồ.
- Đối với SDK bản đồ cho Android và SDK bản đồ cho iOS, đơn vị hạn mức là yêu cầu Chế độ xem phố hoặc Ảnh toàn cảnh tải. Bạn có thể tải bản đồ mà không mất phí và không tính đến hạn mức.
Cách truy cập vào trang Hạn mức của Nền tảng Google Maps:
- Mở trang Nền tảng Google Maps trong Bảng điều khiển Cloud:
- Trên trình đơn bên trái, hãy chọn Hạn mức.
- Chọn một API từ danh sách API thả xuống.
Các đơn vị hạn ngạch
Bảng này hiển thị đơn vị hạn mức cho các API Nền tảng Google Maps.
| API Nền tảng Google Maps | Đơn vị hạn mức |
|---|---|
| Maps | |
| SDK Maps dành cho Android | 1 ảnh toàn cảnh |
| SDK Maps dành cho iOS | 1 ảnh toàn cảnh |
| Map Tiles API | 1 yêu cầu |
| API Chế độ xem từ trên không của Maps | 1 yêu cầu |
| API tĩnh cho Maps | 1 yêu cầu |
| API JavaScript cho Maps | 1 lượt tải bản đồ |
| Street View Static API | 1 yêu cầu |
| API nhúng cho Maps | 1 lượt tải bản đồ |
| Tuyến đường | |
| API Tuyến đường (Tuyến tính điện toán) | 1 yêu cầu |
| Routes API (API tuyến đường tính toán) | 1 phần tử (cặp gốc-đích) |
| Directions API | 1 yêu cầu |
| Distance Matrix API | 1 phần tử (cặp gốc-đích) |
| Roads API | 1 yêu cầu |
| Route Optimization API | 1 yêu cầu |
| Địa điểm | |
| Places API | 1 yêu cầu |
| Address Validation API | 1 yêu cầu |
| Geocoding API | 1 yêu cầu |
| Geolocation API | 1 yêu cầu |
| Time Zone API | 1 yêu cầu |
| Môi trường | |
| API Chất lượng không khí (CurrentConditions và HeatmapTile) | 1 yêu cầu |
| API Chất lượng không khí (Nhật ký) | 1 trang |
| Pollen API | 1 yêu cầu |
| Solar API | 1 yêu cầu |
Báo cáo thanh toán
Xem báo cáo thanh toán
Báo cáo thanh toán cho việc bạn sử dụng các sản phẩm trên Nền tảng Google Maps bao gồm có trong Google Cloud Console. Để biết thêm thông tin, hãy xem Thanh toán.
Cách truy cập vào báo cáo thanh toán:
- Mở trang Bộ chọn dự án trong Cloud Console:
- Chọn dự án.
- Chọn nút trình đơn
rồi chọn Thanh toán.
- Nếu bạn có nhiều tài khoản thanh toán, hãy chọn Chuyển đến tài khoản thanh toán đã liên kết để mở trang Tổng quan cho tài khoản thanh toán được liên kết.
- Trong trình đơn bên trái, hãy chọn Báo cáo để mở trang Báo cáo thanh toán cho tài khoản thanh toán được liên kết.
Cách đọc biểu đồ báo cáo thanh toán
Báo cáo thanh toán trình bày chi phí theo thời gian dưới dạng biểu đồ dạng đường xếp chồng. Mặc định chế độ xem hiển thị chi phí theo mức sử dụng hàng ngày của tháng hiện tại được nhóm theo dự án (đối với tất cả sản phẩm), bao gồm mọi khoản tín dụng theo mức sử dụng cụ thể được áp dụng, cũng như tổng chi phí dự đoán cho toàn bộ tháng hiện tại. Một dòng trong biểu đồ (và hàng trong bảng tóm tắt) tương ứng với dự án, được xếp hạng từ lớn nhất đến nhỏ nhất theo chi phí. Tìm hiểu thêm về cách diễn giải biểu đồ báo cáo thanh toán.
Mẹo: Phân tích mức sử dụng và chi phí mỗi SKU
Để hiểu chính xác hơn các chi tiết của mô hình định giá trả tiền theo mức dùng và mức độ ảnh hưởng của giải pháp đó đến quá trình triển khai của bạn, hãy xem mức sử dụng và chi phí theo SKU.
Để thay đổi chế độ xem báo cáo để hiển thị mục hàng theo SKU:
- Trong bảng điều khiển ở bên phải biểu đồ, hãy mở rộng bộ lọc Nhóm theo.
- Chọn SKU.
Các bộ lọc báo cáo thanh toán khác có sẵn bao gồm Phạm vi thời gian, Dự án, Sản phẩm, SKU và Vị trí cho phép bạn lọc theo địa điểm nên các yêu cầu API được phân phát từ đó.
Để phân loại nguồn sử dụng ngoài sản phẩm, hãy thanh toán theo nhóm báo cáo theo một trong các giá trị được liệt kê. Ba khoá liên quan đến API của Nền tảng Google Maps là goog-maps-api-key-suffix (4 API cuối cùng ký tự của một khoá API), goog-maps-platform-type (nền tảng: Android, iOS, JavaScript hoặc dịch vụ web) và goog-maps-channel (một số được đặt sẵn giá trị kênh từ một truy vấn API). Xem thêm về cách lọc và nhóm.
Bạn có thể thay đổi chế độ xem biểu đồ để loại trừ các khoản tín dụng theo mức sử dụng cụ thể bằng cách bỏ chọn hộp đánh dấu Thêm tín dụng vào chi phí trong bảng điều khiển bên phải.
Theo dõi và hạn chế mức tiêu thụ
Để lập kế hoạch ngân sách và kiểm soát chi phí, bạn có thể làm như sau:
- Đặt cảnh báo về ngân sách, để theo dõi cách chi tiêu của bạn đang tăng lên đến một số tiền cụ thể. Đặt ngân sách không giới hạn mức sử dụng API mà chỉ cảnh báo bạn khi số tiền chi tiêu của bạn gần đạt đến số tiền đã chỉ định.
Giới hạn mức sử dụng API hằng ngày, để quản lý chi phí sử dụng API có thể tính phí. Bằng cách đặt giới hạn về yêu cầu trên mỗi , thì bạn có thể giới hạn mức chi tiêu của mình. Sử dụng một phương trình đơn giản để xác định giá trị hằng ngày của bạn tuỳ thuộc vào số tiền bạn muốn chi tiêu. Ví dụ: (Mức chi tiêu hằng tháng /giá mỗi SKU)/30 = số yêu cầu tối đa mỗi ngày (đối với một API).
Theo dõi mức sử dụng trên mỗi kênh
Để theo dõi mức sử dụng qua các kênh số, bạn phải thêm thuộc tính "kênh" tham số đối với yêu cầu API của bạn. Các giá trị kênh duy nhất được chấp nhận là các số từ 0 đến 999. Dưới đây là một số ví dụ:
- API dịch vụ web mã hóa địa lý
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY&channel=1 - API Maps JavaScript
<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap" async defer></script>
Giám sát hoạt động sử dụng kênh của bạn ngay trên Báo cáo thanh toán. Kênh sẽ phản ánh trong Nhãn dưới dạng goog-maps-channel chính.
Cách lọc báo cáo thanh toán theo SKU và kênh
- Sử dụng bộ lọc Nhóm theo SKU.
- Chọn con nháy Nhãn.
- Chọn trình đơn thả xuống Key (Khoá) rồi chọn goog-maps-channel.
- Chọn trình đơn thả xuống Giá trị rồi chọn những kênh dạng số mà bạn muốn lọc.
Nhóm theo khoá Nhãn goog-maps-channel để xem chi phí do mỗi kênh tạo ra.
Sau khi triển khai dữ liệu sử dụng kênh trong yêu cầu của mình, bạn có thể phải chờ một khoảng thời gian ngắn (tối đa 24 giờ) trước khi dữ liệu được phản ánh trong báo cáo thanh toán của bạn.
Xuất dữ liệu thanh toán bằng BigQuery
Bạn cũng có thể xuất dữ liệu thanh toán sang BigQuery.
BigQuery Export giúp bạn xuất dữ liệu chi tiết về Cloud Billing (chẳng hạn như dữ liệu sử dụng và tự động dữ liệu ước tính chi phí) suốt cả ngày để Tập dữ liệu BigQuery mà bạn chỉ định. Sau đó, bạn có thể truy cập vào dữ liệu thanh toán từ BigQuery để phân tích chi tiết. Điều này giúp bạn hiểu thêm về nguồn gốc dữ liệu sử dụng Nền tảng Google Maps của mình.
Nếu muốn bắt đầu sử dụng tính năng xuất sang BigQuery và truy vấn dữ liệu, bạn có thể thử truy vấn mẫu bên dưới. Trước khi chạy truy vấn này, bạn phải:
- Bật tính năng thanh toán và Tính năng Xuất dữ liệu thanh toán của BigQuery trên tài khoản của bạn.
- Định dạng bảng là PROJECT_ID.DATASET_NAME.gcp_billing_exportv1BILLING_ACCOUNT_ID trong đó:
- PROJECT_ID là mã dự án thực tế của bạn (ví dụ: "my-project-123456").
- DATASET_NAME là tên của tập dữ liệu mà bạn đã tạo (ví dụ: "SampleDataSet").
- BILLING_ACCOUNT_ID là tham chiếu của ID tài khoản thanh toán của bạn,
có tiền tố là "gcp_billing_exportv1" và thay đổi dấu gạch ngang (-) thành dấu gạch dưới (_).
Ví dụ: mã tài khoản thanh toán 123456-7890AB-CDEF01 sẽ trở thành
gcp_billing_export_v1_123456_789AB_CDEF01.
#standardSQL
SELECT Date(usage_start_time, "America/Los_Angeles") AS billing_day,
invoice.month AS invoice_month,
service.description AS service,
sku.description AS sku,
(
SELECT l.value
FROM Unnest(labels) AS l
WHERE l.KEY = 'goog-maps-channel' ) AS goog_maps_channel,
Round(Sum(usage.amount), 2) AS usage_amount,
usage.unit AS usage_unit,
Round(Sum(cost), 2) AS cost,
cost_type,
currency
FROM PROJECT_ID.DATASET_NAME.gcp_billing_export_v1_BILLING_ACCOUNT_ID
WHERE invoice.month = '202002' -- Change the invoice month with the same format as the example.
GROUP BY billing_day,
invoice_month,
service,
sku,
goog_maps_channel,
usage_unit,
cost_type,
currency
ORDER BY billing_day,
service,
sku
Thông tin có liên quan
Thanh toán qua đám mây:
- Tạo, sửa đổi hoặc đóng tài khoản thanh toán Cloud
- Sửa đổi chế độ cài đặt thanh toán của dự án
- Xem báo cáo thanh toán và xu hướng chi phí
- Thiết lập ngân sách và thông báo về ngân sách
- Giới hạn mức sử dụng API
Trạng thái phản hồi và báo cáo
Bảng dưới đây cho thấy mối liên kết giữa trạng thái của API Maps, mã phản hồi HTTP được trả về trong phản hồi của API Maps và lớp mã phản hồi HTTP trong Báo cáo sử dụng, đồng thời cho biết yêu cầu tương ứng có xuất hiện trong báo cáo Sử dụng, Hạn mức và Thanh toán không.
Báo cáo về việc sử dụng trong Các chỉ số của Nền tảng Google Maps
cung cấp độ chi tiết HTTP response code class. Nếu bạn cần cấp độ
thông tin chi tiết, hãy xem Mã trạng thái phản hồi
có sẵn trong
Giám sát việc sử dụng Nền tảng Google Maps.
| Mã phản hồi có trong phản hồi của API Maps | Có trong Báo cáo về việc sử dụng | Đã báo cáo cho | |||
|---|---|---|---|---|---|
| Trạng thái của API Maps | Mã phản hồi HTTP | Lớp mã phản hồi HTTP | Cách sử dụng | Hạn mức | Thanh toán |
| OK | 200, 204, 302 |
2xx, 3xx |
Có | Có | Có |
| DATA_NOT_AVAILABLE, KHÔNG TÌM THẤY, ZERO_RESULTS |
200, 404 |
4xx1 | Có | Có | Có |
| INVALID_REQUEST (giá trị thông số không hợp lệ), MAX_ROUTE_LENGTH_EXCEEDED, MAX_WAYPOINTS_EXCEEDED, và hơn thế nữa |
200, 400 |
4xx | Có | Có | Có |
| INVALID_REQUEST (thông số không hợp lệ/bị thiếu, lỗi phân tích cú pháp yêu cầu) | 200, 400 |
4xx | Có | Không | Không |
| REQUEST_DENIED | 200, 400, 403 |
4xx1 | Có | Không | Không |
| OVER_DAYS_LIMIT, OVER_QUERY_LIMIT, TÀI NGUYÊN_EXHAUSTED, Đã vượt quá giới hạn hằng ngày, Đã vượt quá giới hạn tỷ lệ, userRateLimitExceeded |
200, 403, 429 |
4xx1 | Có | Không | Không |
| UNKNOWN_ERROR | 200, 500, 503 |
5xx1 | Có | Có | Không |
1
Để cải thiện tính nhất quán của báo cáo mã lỗi, Nền tảng Google Maps
Các API đang di chuyển:
1) từ lớp mã phản hồi HTTP 2xx đến 4xx đối với
Các trạng thái của API Maps: DATA_NOT_AVAILABLE, NOT_FOUND,
ZERO_RESULTS - trạng thái,
2) từ lớp mã phản hồi HTTP 2xx đến 4xx cho
Các trạng thái của API Maps: REQUEST_DENIED, OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT, dailyLimitExceeded,
rateLimitExceeded, userRateLimitExceeded,
3) từ lớp mã phản hồi HTTP 2xx đến 5xx cho
Trạng thái của API Maps: UNKNOWN_ERROR.
Bạn có thể thấy cả hai mã phản hồi trong quá trình chuyển đổi
6 tháng. Mã phản hồi được trả về trong các phản hồi của API Maps không thay đổi.
Xác nhận rằng 4xx và/hoặc 5xx tăng lên
Các chỉ số trên Nền tảng Google Maps
liên quan đến việc di chuyển này bằng cách kiểm tra xem mã phản hồi chính xác nào sẽ tăng trong
Trình khám phá chỉ số
(tìm hiểu thêm về cách sử dụng
Giám sát của Google Cloud dành cho Nền tảng Google Maps).
|
|||||
Báo cáo tham gia
Thông tin chi tiết về doanh nghiệp
Nền tảng Google Maps cung cấp cho bạn thông tin chi tiết về cách người dùng tương tác với bản đồ của bạn. Những thông tin chi tiết này bao gồm các chỉ số tương tác chính, chẳng hạn như số lượt xem trên bản đồ hoặc số lượt tương tác với một địa điểm yêu thích. Bạn có thể phân tích những thông tin chi tiết này để khám phá những vị trí phổ biến cho hoạt động quảng cáo và tiếp thị hoặc để tối ưu hoá trải nghiệm người dùng.
Sau đây là các chức năng báo cáo thông tin chi tiết về doanh nghiệp:
- Xem thông tin tổng quan nhanh về thông tin chi tiết về doanh nghiệp để xem nhanh các xu hướng chính về thông tin kinh doanh
- Xem chi tiết để phân tích một chỉ số cụ thể trong bảng điều khiển để tìm hiểu kỹ hơn về các chỉ số
- Xuất các chỉ số sang CSV để bạn có thể phân tích dữ liệu thông tin chi tiết về doanh nghiệp trong công cụ phân tích doanh nghiệp mà bạn yêu thích
Các chỉ số tương tác hiện có bao gồm:
- Chế độ xem bản đồ: Theo dõi các chế độ xem trên bản đồ do xoay, thu phóng hoặc nghiêng. Số lượt xem bản đồ được tính theo mã bưu chính hàng tuần (từ Chủ Nhật đến Thứ Bảy theo giờ Thái Bình Dương). Dữ liệu mới sẽ được phát hành hằng tuần vào thứ Tư đầu tiên sau thời gian quan sát.
Người dùng có thể xem thông tin chi tiết về doanh nghiệp trên trang Chỉ số trong Cloud Console. Dự án phải bật Maps JavaScript API.
Bạn có thể phân tích các chỉ số tương tác ngay trong bảng điều khiển bằng các tính năng Lọc và Nhóm theo để tìm hiểu kỹ hơn về các chỉ số. Ví dụ: bạn có thể chọn lọc theo một khu vực cụ thể để tìm hiểu xu hướng lượt xem bản đồ chỉ đối với các mã bưu chính trong khu vực đó. Mặt khác, bạn có thể muốn nhóm theo khu vực cụ thể để tổng hợp các tương tác trong khu vực đó.
Người dùng có thể xuất toàn bộ tập dữ liệu hoặc chế độ xem đã lọc sang CSV để phân tích thêm trong công cụ phân tích doanh nghiệp mà bạn yêu thích. Bạn có thể tải xuống tối đa 90 ngày cùng một lúc và các tệp tải xuống lớn hơn 60.000 ô sẽ bị cắt bớt. Việc xuất dữ liệu về chế độ xem bản đồ sang CSV có thể mất vài phút, tuỳ thuộc vào khoảng thời gian đã chọn.
Các chỉ số thông tin chi tiết về doanh nghiệp được ẩn danh và do đó, chỉ phản ánh xu hướng tổng thể về việc tương tác với bản đồ của bạn. Số lượng thấp có thể được làm tròn đến 0 và đóng góp từ các điểm ngoại lai có thể giảm.
Bạn có thể kiểm soát quyền truy cập vào thông tin chi tiết về doanh nghiệp cho dự án Cloud của mình trong Google Cloud Console bằng cách sử dụng quyền Maps Analytics. Chủ sở hữu dự án được cấp quyền này theo mặc định và có thể cấp quyền truy cập cho người dùng khác khi cần.
Bạn không nên sử dụng thông tin chi tiết về hoạt động kinh doanh để ước tính chi phí sử dụng. Vui lòng tham khảo báo cáo sử dụng để biết thêm thông tin về mức sử dụng.
Công cụ định vị Plus
Đối với người dùng Locator Plus, trang tổng quan về số liệu phân tích sẽ giúp bạn phân tích và tạo thông tin chi tiết từ dữ liệu của bạn, cung cấp cho bạn thông tin rõ ràng về mức độ hiệu quả của người mua sắm tương tác với công cụ định vị cửa hàng của bạn. Bạn có thể đo lường hiệu suất qua tuần, bao gồm số lượt xem, số lượt tương tác với Tìm kiếm và Thông tin chi tiết về địa điểm và tỷ lệ tương tác tổng thể. Ngoài ra, trang tổng quan cung cấp các điểm chuẩn quan trọng về mức độ triển khai của bạn so với các nhà bán lẻ khác.
- Chuyển đến Locator Plus trong bảng điều khiển Google Cloud.
- Chuyển đến phần Báo cáo mức độ tương tác của Google Cloud Console để xem trang tổng quan về số liệu phân tích.
Báo cáo đo điểm chuẩn cho phép bạn so sánh dữ liệu của mình với dữ liệu ngành từ các công ty khác chia sẻ dữ liệu của họ. Phép so sánh cung cấp bối cảnh có giá trị, giúp bạn đặt ra mục tiêu có ý nghĩa, thông tin chi tiết về các xu hướng trong ngành và tìm hiểu hiệu suất của bạn so với đối thủ cạnh tranh của mình.
Để xem dữ liệu đo điểm chuẩn, dữ liệu tương tác của bạn được bao gồm ẩn danh trong các điểm chuẩn của Google. Để chọn không xem và bao gồm dữ liệu tương tác ẩn danh trong báo cáo đo điểm chuẩn, hãy gửi phiếu yêu cầu hỗ trợ. Thông thường, phiếu yêu cầu hỗ trợ sẽ được giải quyết trong vòng 3 ngày.