Tính năng báo cáo trong Nền tảng Google Maps cung cấp một bộ báo cáo trực quan được xác định trước về thông tin cơ bản về việc sử dụng API, hạn mức và thông tin thanh toán trong Google Cloud Console. Hãy sử dụng các báo cáo này để xác định số lượng lệnh gọi API mà bạn đã thực hiện, mức sử dụng API gần đạt đến hạn mức và theo dõi mức sử dụng tính năng thanh toán theo thời gian.
Có các loại báo cáo sau:
- 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 gửi đến các API Nền tảng Google Maps bằng thông tin xác thự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 mức sử dụng hạn mức trong biểu đồ có thể được nhóm theo số yêu cầu mỗi phút. Hạn mức hạn mức hiện tại cho các API đã chọn sẽ 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 mức sử dụng hạn mức của tháng hiện tại, bao gồm mọi khoản tín dụng dành riêng cho mức sử dụng đã áp dụng, cũng như tổng chi phí dự kiến cho toàn bộ tháng hiện tại.
- Báo cáo về mức độ tương tác: Cung cấp thông tin chi tiết về hoạt động kinh doanh liên quan đến cách người dùng tương tác với ứng dụng bản đồ của bạn.
Để biết danh sách đầy đủ các trạng thái phản hồi và mã phản hồi xác định xem một yêu cầu có xuất hiện trong báo cáo Mức sử dụng, Hạn mức và/hoặc Thanh toán hay không, hãy xem phần Trạng thái phản hồi và báo cáo.
Xem báo cáo về mức sử dụng, hạn mức và thông tin thanh toán của Nền tảng Google Maps bằng Cloud Console.
Báo cáo về mức sử dụng
Mức sử dụng dựa trên số lượng yêu cầu mà dự án của bạn gửi đến các API Nền tảng Google Maps bằng thông tin xác thự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 lỗi máy chủ và yêu cầu dẫn đến lỗi máy khách. Thông tin xác thực bao gồm khoá API và mã ứng dụng khách (dành cho các dự án sử dụng Gói Premium và dự án đã di chuyển sang Gói Premium). Để biết thông tin chi tiết, hãy xem phần Tổng quan về gói Premium và thông tin về cách sử dụng mã ứng dụng.
Các 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 các chỉ số sử dụng cho tất cả API theo các cách sau:
- 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à thông tin xác thực.
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 những 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 và thông tin xác thực.
Trang tổng quan về API và dịch vụ
Trang tổng quan về API và dịch vụ 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ụ khác.
Trang Trang tổng quan có 3 biểu đồ và 1 bảng. Bạn có thể lọc mức sử dụng được hiển thị trong biểu đồ và bảng bằng cách chọn một khoảng thời gian từ 1 giờ đến 30 ngày qua.
Biểu đồ Lưu lượng truy cập cho biết mức sử dụng theo số lượng truy vấn mỗi phút (QPM) trên mỗi API.
Biểu đồ Lỗi cho biết tỷ lệ phần trăm số yêu cầu dẫn đến lỗi cho mỗi API.
Biểu đồ Độ trễ cho biết độ trễ trung bình của các yêu cầu trên mỗi API.
Bên dưới các biểu đồ, một bảng liệt kê các API và dịch vụ đã bật. Số 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 yêu cầu trong số này dẫn đến lỗi. Độ trễ (độ trễ trung bình và phần trăm) là độ trễ của các yêu cầu này.
Cách truy cập vào trang Tổng quan về API và dịch vụ:
- Mở trang Bộ chọn dự án trong Cloud Console:
- Chọn dự án của bạn. Trang tổng quan về API 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 và dịch vụ.
Để biết thêm thông tin, hãy xem bài viết Theo dõi mức sử dụng API.
Trang tổng quan về Google Maps
Trang Tổng quan của Google Maps có một bảng liệt kê các API đã bật và các yêu cầu sử dụng trong 30 ngày qua. Yêu cầu theo API cũng được hiển thị dưới dạng biểu đồ. Biểu đồ thanh toán cho biết hoá đơn hiện tại và tổng mức sử dụng trong 3 tháng qua.
Cách truy cập vào trang Tổng quan về Nền tảng Google Maps:
- Mở trang Nền tảng Google Maps trong Cloud Console:
- Trong trình đơn bên trái, hãy chọn Tổng quan.
Trang API và dịch vụ của Nền tảng Google Maps
Trang API và dịch vụ của Google Maps chứa một lưới thẻ thông tin đại diện cho các API, SDK và 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 dịch vụ đó bằng cách chọn Bật hoặc Tắt. Ngoài ra, bạn có thể truy cập vào thông tin xác thực, chỉ số và hướng dẫn sử dụng cho các API đã bật. Bạn cũng có thể sử 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.
Cách truy cập vào trang API và dịch vụ của Nền tảng Google Maps:
- Mở trang Nền tảng Google Maps trong Cloud Console:
- Trong trình đơn bên trái, hãy chọn API và dịch vụ.
Trang Chỉ số của Google Maps
Trang Chỉ số của Google Maps hiển thị 3 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 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ố có một bảng API cho biết các yêu cầu, lỗi và độ trễ của các API mà bạn đã chọn.
Bằng cách sử dụng trình đơn thả xuống API ở trên cùng và các tuỳ chọn nhóm và lọc trong ngăn bên phải, bạn có thể nhóm và lọc các chỉ số sử dụng hiển thị bằng cách chọn một hoặc nhiều API, 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ừ một giờ đến 30 ngày qua) và mức độ chi tiết (mỗi giây hoặc mỗi ngày) cho các chỉ số sử dụng hiển thị.
Các hình ảnh sau đây cho thấy bộ lọc Nền tảng và Miền cho một API duy nhất khi 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 Cloud Console:
- 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 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 tên khoá trên Maps Platform Console trong phần 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ó hai khả năng nếu bạn thấy thông tin xác thực này:
|
Biểu đồ mã phản hồi
Biểu đồ Lưu lượng truy cập theo mã phản hồi và Lỗi theo mã phản hồi phân chia mức sử dụng theo lớp mã phản hồi HTTP. Bảng này cho thấy mối liên kết giữa trạng thái phản hồi API của 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ẽ tiêu hao 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ẽ tiêu hao hạn mức. Ví dụ: các yêu cầu Đặt ảnh thành công sẽ trả về lệnh chuyển hướng 302 đến hình ảnh được tham chiếu. |
DATA_NOT_AVAILABLE | 4xx(1) | Phản hồi thành công cho biết không có dữ liệu nào cho các vị trí đầu vào. Đây là yêu cầu có thể tính phí và sẽ tiêu hao 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ẽ tiêu hao hạn mức. |
NOT_FOUND | 4xx(1) | Đối với API chỉ đường, thông báo này cho biết ít nhất một trong các vị trí được chỉ định trong điểm xuất phát, điểm đến hoặc điểm trung gian của yêu cầu không thể được mã hoá địa lý. Đối với Places API, thông báo này cho biết rằng không tìm thấy vị trí được tham chiếu (place_id) trong cơ sở dữ liệu của Places. Đây là yêu cầu có thể tính phí và sẽ tiêu hao hạn mức. |
INVALID_REQUEST (giá trị tham số không hợp lệ), MAX_WAYPOINTS_EXCEEDED, MAX_ROUTE_LENGTH_EXCEEDED và các lỗi khác. |
4xx | Lỗi do giá trị thông số không hợp lệ. Hãy kiểm tra phản hồi API để biết thêm chi tiết. Đây là yêu cầu có thể tính phí và sẽ tiêu hao hạn mức. |
REQUEST_DENIED | 4xx | Lỗi máy 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_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, rateLimitExceeded, dailyLimitExceeded, userRateLimitExceeded |
4xx | Lỗi ứng dụng do có quá nhiều yêu cầu trong mỗi khoảng thời gian được phép. Thử lại yêu cầu vào lúc khác. Hãy kiểm tra phản hồi API để biết thêm chi tiết. |
INVALID_REQUEST (tham số 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 yêu cầu) | 4xx | Lỗi máy khách do yêu cầu không hợp lệ. Hãy kiểm tra phản hồi API để biết thêm 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 thông tin ước tính vị trí. Đối với API Đường, thông báo này cho biết rằng không thể chụp nhanh dữ liệu đầu vào một cách hợp lý vào đường. Đây là yêu cầu có thể tính phí và sẽ tiêu hao hạn mức. |
UNKNOWN_ERROR | 5xx | Lỗi máy chủ cho biết không thể tiếp tục yêu cầu: lỗi nội bộ, 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 việc báo cáo mã lỗi, các API của Nền tảng Google Maps đang di chuyển:
1) từ lớp mã phản hồi HTTP 2xx sang 4xx cho
trạng thái API Maps: DATA_NOT_AVAILABLE , NOT_FOUND ,
ZERO_RESULTS – trạng thái,
2) từ lớp mã phản hồi HTTP 2xx sang 4xx cho
trạng thái API Maps: REQUEST_DENIED , OVER_DAILY_LIMIT ,
OVER_QUERY_LIMIT , dailyLimitExceeded ,
rateLimitExceeded , userRateLimitExceeded ,
3) từ lớp mã phản hồi HTTP 2xx sang 5xx cho
trạng thái API Maps: UNKNOWN_ERROR .
Bạn có thể thấy cả hai mã phản hồi trong khoảng thời gian chuyển đổi. Các mã phản hồi được trả về trong phản hồi của API Maps không thay đổi.
Xác nhận rằng việc tăng 4xx và/hoặc 5xx trong
Chỉ số của Nền tảng Google Maps
có liên quan đến quá trình di chuyển này bằng cách kiểm tra mã phản hồi chính xác tăng lên trong
Trình khám phá chỉ số
(tìm hiểu thêm về cách sử dụng
Google Cloud Monitoring 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 tài liệu phản hồi cho API mà bạn quan tâm (ví dụ: Phản hồi về việc mã hoá địa lý hoặc Phản hồi về chỉ đường).
Tham số giải pháp trên 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 nhanh chóng bắt đầu sử dụng. Ví dụ: bạn có thể sử dụng Trình tạo nhanh trong Cloud Console, làm theo hướng dẫn triển khai của các giải pháp trong ngành và tìm hiểu qua codelabs.
Để hiểu rõ 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 thông số truy vấn solution_channel
vào các lệnh gọi API để thu thập thông tin về cách sử dụng mã mẫu:
- Theo mặc định, tham số truy vấn
solution_channel
được đưa vào mã mẫu giải pháp. - Tham số truy vấn trả về cho Google số liệu phân tích về việc sử dụng giải pháp để cải thiện chất lượng giải pháp trong các lần lặp lại trong tương lai.
- Bạn có thể chọn không sử dụng bằng cách xoá tham số truy vấn
solution_channel
và giá trị của tham số đó khỏi mã mẫu. - Không có yêu cầu nào về việc giữ lại tham số này. Việc xoá tham số truy vấn sẽ không ảnh hưởng đến hiệu suất.
- Thông số truy vấn chỉ được dùng để báo cáo mức sử dụng mã mẫu.
- Thông số truy vấn tách biệt với mọi báo cáo và số liệu phân tích dành riêng cho API. Điều đó có nghĩa là việc xoá tham số khỏi mã mẫu giải pháp sẽ không tắt tính năng báo cáo API JavaScript nội bộ của Maps.
Báo cáo hạn mức
Hạn mức đặt giới hạn về số lượng yêu cầu mà dự án của bạn có thể gửi tới các API trên Nền tảng Google Maps. Bạn có thể giới hạn số lượng 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à yêu cầu gây ra lỗi máy chủ mới được tính vào hạn mức. Các yêu cầu không xác thực được sẽ không tính vào hạn mức.
Mức sử dụng hạn mức được hiển thị dưới dạng biểu đồ trên trang Hạn mức trong Cloud Console và có thể được nhóm theo số yêu cầu mỗi phút. Hạn mức hạn mức hiện tại cho các API đã chọn sẽ hiển thị trong bảng bên dưới biểu đồ sử dụng hạn mức.
Để biết giá trị hạn mức mỗi phút cho bất kỳ sản phẩm API GMP nào, hãy sử dụng máy tính này.
Trang Hạn mức trên Google Maps
Trang Hạn mức của Google Maps cho biết các giới hạn 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 đồ sử dụng hạn mức trên Google Cloud Console cho biết tổng lưu lượng truy cập cho khoá API và mã ứng dụng của bạn. Lưu lượng truy cập theo 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à 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 sử dụng hạn mức và không hiển thị.
Đơn vị hạn mức là một yêu cầu đối với hầu hết các API của Nền tảng Google Maps (API tĩnh của Maps, API tĩnh của Chế độ xem đường phố, API mã hoá địa lý, API chỉ đường, API Địa điểm, API Múi giờ, 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à một cặp điểm xuất phát-điểm đến.
- Đối với API JavaScript của Maps, đơn vị hạn mức là một lượt tải bản đồ.
- Đối với SDK Bản đồ dành cho Android và SDK Bản đồ dành cho iOS, đơn vị hạn mức là một yêu cầu Chế độ xem đường phố hoặc một lượt tải Chế độ xem toàn cảnh. Bạn có thể tải bản đồ mà không mất phí và không tiêu hao 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 Cloud Console:
- Trong trình đơn bên trái, hãy chọn Hạn mức.
- Chọn một API trong danh sách thả xuống API.
Các đơn vị hạn ngạch
Bảng này cho biết đơn vị hạn mức cho các API của 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 đường phố 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 | |
Routes API (Tính toán tuyến đường) | 1 yêu cầu |
Routes API (Tính toán ma trận tuyến đường) | 1 Phần tử (cặp điểm xuất phát-điểm đến) |
Directions API | 1 yêu cầu |
Distance Matrix API | 1 Phần tử (cặp điểm xuất phát-điểm đến) |
Roads API | 1 yêu cầu |
Route Optimization API | 1 yêu cầu |
Navigation SDK cho Android | 1 đích đến |
Navigation SDK cho iOS | 1 đích đến |
Đị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 | |
Air Quality API (CurrentConditions và HeatmapTile) | 1 yêu cầu |
Air Quality API (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ạn có thể xem báo cáo thanh toán cho việc sử dụng các sản phẩm của Nền tảng Google Maps trong Google Cloud Console. Để biết thêm thông tin, hãy xem phần Thanh toán.
Cách xem báo cáo thanh toán:
- Mở trang Bộ chọn dự án trong Cloud Console:
- Chọn một 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 được liên kết để mở trang Tổng quan của 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 về việc 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 lập biểu đồ chi phí theo thời gian dưới dạng biểu đồ dạng đường xếp chồng. Chế độ xem mặc định cho biết chi phí hằng ngày theo mức sử dụng 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 áp dụng, cũng như tổng chi phí dự kiến cho toàn bộ tháng hiện tại. Mỗi dòng trong biểu đồ (và hàng trong bảng tóm tắt) tương ứng với một 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í cho mỗi SKU
Để hiểu rõ hơn về thông tin chi tiết của mô hình giá trả theo mức sử dụng và tác động của mô hình này đến việc triển khai, hãy xem mức sử dụng và chi phí theo SKU.
Cách 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 bao gồm Khoảng thời gian, Dự án, Sản phẩm, SKU và Vị trí. Các bộ lọc này cho phép bạn lọc theo nơi các yêu cầu API được phân phát.
Để phân loại nguồn sử dụng ngoài sản phẩm, hãy nhóm các báo cáo thanh toán theo một trong các giá trị được liệt kê. Ba khoá liên quan đến API Nền tảng Google Maps là goog-maps-api-key-suffix (bốn ký tự cuối cùng của 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 giá trị kênh dạng số được đặt từ truy vấn API). Thông tin khác về tính năng 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 dành riêng cho mức sử dụng 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.
Giám sát và hạn chế mức tiêu thụ
Để lập 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 mức chi tiêu của bạn đang tăng lên một số tiền cụ thể. Việc đặt ngân sách không giới hạn mức sử dụng API, mà chỉ cảnh báo cho bạn khi mức chi tiêu của bạn sắp đạt đến mức đã chỉ định.
Giới hạn mức sử dụng API hằng ngày để quản lý chi phí sử dụng các API có tính phí. Bằng cách đặt giới hạn về số yêu cầu mỗi ngày, bạn có thể giới hạn mức chi tiêu. Sử dụng một phương trình đơn giản để xác định giới hạn chi tiêu hằng ngày 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á của mỗi SKU)/30 = giới hạn số yêu cầu mỗi ngày (đối với một API).
Theo dõi mức sử dụng theo kênh
Để theo dõi mức sử dụng thông qua các kênh dạng số, bạn phải thêm thông số "channel" vào các yêu cầu API. Giá trị duy nhất được chấp nhận cho kênh là các số từ 0 đến 999. Dưới đây là một số ví dụ:
- API Dịch vụ web mã hoá địa lý
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY&channel=1
- API JavaScript cho Maps
<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap" async defer></script>
Theo dõi mức sử dụng kênh ngay trên Báo cáo thanh toán. Các kênh sẽ xuất hiện trong phần Nhãn dưới dạng khoá goog-maps-channel.
Cách lọc báo cáo thanh toán theo SKU và kênh
- Sử dụng bộ lọc SKU Nhóm theo.
- Chọn dấu mũi tên Labels (Nhãn).
- Chọn trình đơn thả xuống Khoá rồi chọn goog-maps-channel.
- Chọn trình đơn thả xuống Giá trị rồi chọn các 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 bạn triển khai dữ liệu về mức sử dụng kênh trong các yêu cầu, có thể sẽ có độ trễ 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.
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.
Tính năng Xuất sang BigQuery cho phép bạn tự động xuất dữ liệu chi tiết về Cloud Billing (chẳng hạn như dữ liệu về mức sử dụng và chi phí ước tính) trong cả ngày sang một 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 của mình trong BigQuery để phân tích chi tiết. Điều này giúp bạn hiểu rõ hơn về nguồn sử dụng Nền tảng Google Maps.
Nếu muốn bắt đầu sử dụng tính năng xuất dữ liệu 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à xuất dữ liệu thanh toán sang 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à thông tin tham chiếu về Mã tài khoản thanh toán của bạn, được thêm tiền tố "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
Cloud Billing:
- Tạo, sửa đổi hoặc đóng tài khoản Cloud Billing
- 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í
- Đặt ngân sách và cảnh báo về ngân sách
- Giới hạn mức sử dụng API
Báo cáo và trạng thái phản hồi
Bảng dưới đây cho thấy mối liên kết giữa trạng thái API Maps, mã phản hồi HTTP được trả về trong các phản hồi API Maps và lớp mã phản hồi HTTP trong Báo cáo mức sử dụng, đồng thời cho biết liệu yêu cầu tương ứng có xuất hiện trong Báo cáo mức sử dụng, Báo cáo hạn mức và Báo cáo thanh toán hay không.
Báo cáo mức sử dụng trong phần Chỉ số của Nền tảng Google Maps cung cấp thông tin chi tiết ở cấp HTTP response code class
. Nếu bạn cần thông tin chi tiết hơn, hãy xem Mã trạng thái phản hồi có trong phần Theo dõi mức sử dụng Nền tảng Google Maps.
Các mã phản hồi có trong phản hồi của API Maps | Có trong Báo cáo về mứ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, NOT_FOUND, ZERO_RESULTS |
200, 404 |
4xx1 | Có | Có | Có |
INVALID_REQUEST (giá trị tham số không hợp lệ), MAX_ROUTE_LENGTH_EXCEEDED, MAX_WAYPOINTS_EXCEEDED, v.v. |
200, 400 |
4xx | Có | Có | Có |
INVALID_REQUEST (thông số không hợp lệ/thiếu thông số, 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_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, dailyLimitExceeded, rateLimitExceeded, 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 việc báo cáo mã lỗi, các API của Nền tảng Google Maps đang di chuyển:
1) từ lớp mã phản hồi HTTP 2xx sang 4xx cho
trạng thái API Maps: DATA_NOT_AVAILABLE , NOT_FOUND ,
ZERO_RESULTS – trạng thái,
2) từ lớp mã phản hồi HTTP 2xx sang 4xx cho
trạng thái API Maps: REQUEST_DENIED , OVER_DAILY_LIMIT ,
OVER_QUERY_LIMIT , dailyLimitExceeded ,
rateLimitExceeded , userRateLimitExceeded ,
3) từ lớp mã phản hồi HTTP 2xx sang 5xx cho
trạng thái API Maps: UNKNOWN_ERROR .
Bạn có thể thấy cả hai mã phản hồi trong khoảng thời gian chuyển đổi. Các mã phản hồi được trả về trong phản hồi của API Maps không thay đổi.
Xác nhận rằng việc tăng 4xx và/hoặc 5xx trong
Chỉ số của Nền tảng Google Maps
có liên quan đến quá trình di chuyển này bằng cách kiểm tra mã phản hồi chính xác tăng lên trong
Trình khám phá chỉ số
(tìm hiểu thêm về cách sử dụng
Google Cloud Monitoring 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 như lượt xem trên bản đồ hoặc 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 để tìm hiểu những vị trí phổ biến để quảng cáo và tiếp thị hoặc để tối ưu hoá trải nghiệm người dùng.
Các tính năng báo cáo thông tin chi tiết về doanh nghiệp bao gồm:
- Xem thông tin tổng quan nhanh về thông tin chi tiết về doanh nghiệp ở cấp cao để xem nhanh các xu hướng chính trong thông tin chi tiết về doanh nghiệp
- Tìm hiểu sâu để phân tích một chỉ số cụ thể trong bảng điều khiển để tìm hiểu chi tiết hơn về các chỉ số
- Xuất chỉ số sang tệp 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 kinh doanh mà bạn yêu thích
Sau đây là một số chỉ số tương tác:
- Lượt xem trên bản đồ: Theo dõi lượt xem trên bản đồ do thao tác xoay, thu phóng hoặc nghiêng. Số lượt xem trên 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 được phát hành hằng tuần vào thứ Tư đầu tiên sau khoảng thời gian quan sát.
Chủ sở hữu dự án và người dùng có vai trò Người xem Analytics của Maps có thể xem thông tin chi tiết về doanh nghiệp trong Trang chỉ số trên Cloud Console. Dự án phải bật API Maps JavaScript.
Bạn có thể phân tích các chỉ số về mức độ 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 chi tiết 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 về số lượt xem trên bản đồ chỉ dành cho các mã bưu chính trong khu vực đó. Mặt khác, bạn có thể muốn nhóm theo một khu vực cụ thể để tổng hợp các lượt 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 tệp CSV để phân tích thêm trong công cụ phân tích kinh doanh mà bạn yêu thích. Bạn có thể tải tối đa 90 ngày xuống cùng một lúc và các tệp tải xuống có nhiều hơn 60.000 ô sẽ bị cắt bớt. Quá trình xuất dữ liệu lượt xem trên bản đồ sang CSV có thể mất vài phút tuỳ thuộc vào phạm vi 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ề mứ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 thành 0 và mức đóng góp của các giá trị ngoại lai có thể bị 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 trên Google Cloud trong Google Cloud Console bằng cách sử dụng quyền truy cập vào Maps Analytics. Theo mặc định, Chủ sở hữu dự án được cấp quyền này và có thể cấp quyền truy cập cho người dùng khác nếu cần.
Bạn không nên sử dụng thông tin chi tiết về doanh nghiệp để ướ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.