Trang này được dịch bởi Cloud Translation API.

Báo cáo của Nền tảng Google Maps

Tính năng báo cáo trong Nền tảng Google Maps cung cấp một tập hợp các báo cáo trực quan được xác định trước, cho phép bạn dễ dàng xem thông tin cơ bản về mức sử dụng, hạn mức và thông tin thanh toán trong Google Cloud Console. Bạn có thể nhanh chóng xác định số lượng lệnh gọi API, tiến gần đến hạn mức sử dụng API 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 như 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 đưa ra cho API Google Maps Platform bằng cách sử dụng thông tin xác thực đượ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 yêu cầu mỗi phút. Giới hạn hạn mức hiện tại cho các API đã chọn 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 dành riêng cho mức sử dụng đã á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 cho doanh nghiệp về cách người dùng tương tác với ứng dụng bản đồ của bạn.

Hãy xem phần Trạng thái phản hồi và báo cáo dưới đây để biết 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 báo cáo Mức sử dụng, Hạn mức và/hoặc Thanh toán hay không.

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 Cloud Console.

Báo cáo về việ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 API Google Maps Platform bằng thông tin xác thực được liên kết với dự án của bạn. Các yêu cầu bao gồm các yêu cầu thành công, các yêu cầu dẫn đến lỗi máy chủ và các 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 (đối với các dự án Gói đặc biệt và Gói đặc biệt đã di chuyển).

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:

Chỉ số sử dụng cho tất cả các API có thể được lọc theo khoảng thời gian và API. Bạn cũng có thể 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.

Chỉ số sử dụng cho một API cụ thể có thể được lọc theo khoảng thời gian và các phiên bản, thông tin xác thực cũng như phương thức của API. Bạn cũng có thể 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 và phiên bản API, cũng như thông tin xác thực.

Trang tổng quan về API và dịch vụ

Trang Trang tổng quan API và dịch vụ cung cấp thông tin tổng quan về chỉ số sử dụng cho tất cả các API được hỗ trợ cho dự án của bạn (API Google Maps Platform cũng như các API và dịch vụ khác).

Trang tổng quan có ba biểu đồ và một bảng. Bạn có thể lọc mức sử dụng hiển thị trong các 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 cho thấy mức sử dụng các truy vấn trong mỗi giây (QPS) 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 trên 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 các biểu đồ là 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). Số lỗi là số lượng những yêu cầu đã dẫn đến lỗi. Độ trễ (độ trễ trung bình và phân vị) là độ trễ của những yêu cầu này.

API theo dõi

Để truy cập vào trang Trang tổng quan API và dịch vụ:

Mở trang Bộ chọn Dự án trong Cloud Console:
Trang bộ chọn dự án
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 Giám sát mức sử dụng API.

Trang Tổng quan của Google Maps

Trang Tổng quan của Google Maps có một bảng liệt kê các API được bật và các yêu cầu sử dụng trong 30 ngày qua. Các yêu cầu theo API cũng 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 của bạn trong 3 tháng qua.

Ảnh chụp màn hình biểu đồ Tổng quan cho thấy một bảng liệt kê các API và yêu cầu API được bật trong 30 ngày qua.

Để 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 Cloud Console:
Truy cập vào trang Nền tảng Google Maps
Trên trình đơn bên trái, hãy chọn Tổng quan.

Trang API Google Maps Platform

Trang API của Google Maps có hai bảng. Bảng API đã bật cho thấy số lượng yêu cầu, số lỗi và độ trễ trung bình cho mỗi API đã bật trong 30 ngày qua. Bảng API bổ sung liệt kê các API chưa được bật.

API

Để truy cập vào trang API Nền tảng Google Maps:

Mở trang Nền tảng Google Maps trong Cloud Console:
Truy cập vào trang Nền tảng Google Maps
Ở trình đơn bên trái, hãy chọn API.

Trang Chỉ số trên Google Maps

Trang Chỉ số của Google Maps hiển thị ba biểu đồ: Lưu lượng truy cập, Lỗi và Độ trễ trung bình. Dữ liệu sử dụng trong các biểu đồ có thể được nhóm 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 thấy các yêu cầu, lỗi và độ trễ cho các API bạn đã chọn.

Khi sử dụng trình đơn thả xuống API ở trên cùng cũng như 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 được 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ờ cho đến 30 ngày qua) và mức độ chi tiết (mỗi giây hoặc ngày) cho các chỉ số sử dụng được hiển thị.

Trang chỉ số hiển thị ba biểu đồ: Lưu lượng truy cập, Lỗi và Độ trễ trung bình.

Các hình ảnh sau đây hiển thị bộ lọc Nền tảng và Miền cho một API khi bạn chọn nhóm theo Nền tảng và Miền trong danh sách thả xuống Nhóm theo:

Bộ lọc Nền tảng chỉ xuất hiện khi bạn chọn một API.

Để 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:
Truy cập vào trang Nền tảng Google Maps
Trên trình đơn bên trái, hãy chọn Chỉ số.

Biểu đồ mã phản hồi

Các 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 bên dưới cho thấy 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ể lập hoá đơn và sẽ tốn hạn mức.
OK	3xx	Phản hồi thành công. Đây là yêu cầu có thể lập hoá đơn và sẽ tốn hạn mức. Ví dụ: các yêu cầu thành công đối với Ảnh địa điểm sẽ trả về lệnh chuyển hướng 302 đến hình ảnh được tham chiếu.
DATA_NOT_AVAILABLE	4xx⁽¹⁾	Phản hồi thành công cho biết không có dữ liệu nào cho vị trí đầu vào. Đây là yêu cầu có thể lập hoá đơn và sẽ tốn hạn mức.
ZERO_RESULTS	4xx⁽¹⁾	Phản hồi thành công không trả lại kết quả. Đây là yêu cầu có thể lập hoá đơn và sẽ tốn hạn mức.
NOT_FOUND	4xx⁽¹⁾	Đối với API Chỉ đường, thuộc tính này cho biết rằng ít nhất một trong các vị trí được chỉ định trong điểm gốc, điểm đến hoặc điểm tham chiếu của yêu cầu không thể mã hoá địa lý. Đối với API Địa điểm, thuộc tính này cho biết rằng vị trí được tham chiếu (place_id) không được tìm thấy trong cơ sở dữ liệu Địa điểm. Đây là yêu cầu có thể lập hoá đơn và sẽ tốn hạn mức.
INVALID_REQUEST (giá trị thông số không hợp lệ), MAX_WayPOINTS_EXCEEDED, MAX_Route_LENGTH_EXCEEDED, v.v.	4xx	Lỗi do giá trị thông số không hợp lệ. Hãy kiểm tra phản hồi của API để biết thêm thông tin chi tiết. Đây là yêu cầu có thể lập hoá đơn và sẽ tốn 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.v. Hãy kiểm tra phản hồi của API để biết thêm chi tiết.
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, resource_EXHAUSTED, rateLimit luied, mỗi ngàyGiới hạn vượt quá, userRate USD	4xx	Lỗi ứng dụng do quá nhiều yêu cầu trong khoảng thời gian cho phép. Hãy thử gửi lại yêu cầu này vào lúc khác. 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ố không hợp lệ/thiếu, lỗi phân tích cú pháp/lỗi 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 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ý, lỗi 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, giá trị này cho biết không thể điều chỉnh hợp lý dữ liệu đầu vào cho các đường. Đây là yêu cầu có thể lập hoá đơn và sẽ tốn hạn mức.
UNKNOWN_ERROR	5xx	Lỗi máy chủ cho biết không thể xử lý yêu cầu: lỗi nội bộ, dịch vụ quá tải, không có sẵn, hết giờ, v.v.
¹ Để cải thiện tính nhất quán của báo cáo mã lỗi, API 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 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` sang `4xx` cho trạng thái API của Maps: `REQUEST_DENIED`, `OVER_DAILY_LIMIT`, `OVER_QUERY_LIMIT`, `dailyLimitExceeded`, `OVER_QUERY_LIMIT`, `dailyLimitExceeded`, từ trạng thái phản hồi HTTP sang `2xx`, từ trạng thái phản hồi HTTP sang `2xxrateLimitExceededuserRateLimitExceeded5xxUNKNOWN_ERROR` Bạn có thể thấy cả hai mã phản hồi trong giai đoạn chuyển đổi. Mã phản hồi được trả về trong phản hồi của API Maps không thay đổi. Hãy xác nhận rằng sự gia tăng về `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 xem mã phản hồi chính xác nào sẽ tăng trong Metrics Explorer (tìm hiểu thêm về cách sử dụng tính nă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 tài liệu phản hồi cho API mà bạn quan tâm (ví dụ: Phản hồi mã hoá địa lý hoặc Phản hồi chỉ đường).

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 thiết lập và chạy quảng cáo một cách nhanh chó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ác giải pháp trong ngành và học hỏi từ các phòng thí nghiệm lập trình.

Để 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 tham số truy vấn solution_channel vào lệnh gọi API để thu thập thông tin về việc 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ề số liệu phân tích về quá trình sử dụng giải pháp cho Google để cải thiện chất lượng giải pháp trong các vòng lặp sau này.
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.
Bạn không cần phải giữ lại thông số này. Việc xoá tham số truy vấn sẽ không ảnh hưởng đến hiệu suất.
Tham số truy vấn chỉ được dùng cho báo cáo về việc sử dụng mã mẫu.
Tham số truy vấn này tách biệt với mọi báo cáo và số liệu phân tích theo API cụ thể. Điều đó có nghĩa là việc xoá thông 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 của Maps nội bộ.

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 cho các API Nền tảng Google Maps. Số yêu cầu có thể được giới hạn 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 được thực hiện thành công và 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 được xác thực sẽ không được tính vào hạn mức.

Mức sử dụng hạn mức được hiển thị trong biểu đồ trên trang Hạn mức trong Cloud Console và có thể được nhóm trong các yêu cầu mỗi phút. Hạn mức hiện tại cho các API đã chọn hiển thị trong bảng bên dưới biểu đồ sử dụng hạn mức.

Sử dụng công cụ tính này để biết giá trị hạn mức trên mỗi phút cho mọi sản phẩm API GMP.

Trang Hạn mức trên Google Maps

Trang Hạn mức của Google Maps cho thấy 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 thấy tổng lưu lượng truy cập cho các 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 tiêu tốn hạn mức: cá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ị thông số không hợp lệ), UNKNOWN_ERROR).

Các yêu cầu gây ra lỗi máy khách — lỗi xác thực/uỷ quyền/đối số không hợp lệ (REQUEST_DENIED, OVER_QUERY_LIMIT, INVALID_REQUEST (thông số không hợp lệ, lỗi phân tách yêu cầu)) – không sử dụng hạn mức và không được hiển thị.

Đơn vị hạn mức là một yêu cầu cho 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 nguồn gốc – đích đế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 Maps dành cho iOS, đơn vị hạn mức là một yêu cầu Chế độ xem đường phố/Tải toàn cảnh (Lượt tải bản đồ được cung cấp miễn phí và không tiêu thụ hạn mức).

Ảnh chụp màn hình trang Hạn mức của Maps trong Google Cloud Console. Công cụ này cho biết hạn mức theo API bằng cách sử dụng một bộ chọn, sau đó cho thấy Số lượt tải bản đồ tương ứng với hạn mức đã đặt cho API được đề cập.

Để 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:
Truy cập vào trang Nền tảng Google Maps
Trên 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.

Đơn vị hạn ngạch

Bảng dưới đâ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 Bản đồ dành cho Android	1 ảnh toàn cảnh
SDK Bản đồ dành cho iOS	1 ảnh toàn cảnh
API chế độ xem trên không của Maps	1 yêu cầu
Maps Static API	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
Maps Embed API	1 lượt tải bản đồ
Tuyến đường
API tuyến đường (Tính toán tuyến đường)	1 yêu cầu
API tuyến đường (Ma trận điện toán định tuyến)	1 phần tử (cặp nguồn gốc – đích đến)
Directions API	1 yêu cầu
Distance Matrix API	1 phần tử (cặp nguồn gốc – đích đến)
Roads 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
API phấn hoa	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 liên quan đến việc bạn sử dụng sản phẩm Nền tảng Google Maps sẽ có trong Google Cloud Console (xem phần 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:
Trang bộ chọn dự án
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 được 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 đồ trong báo cáo thanh toán

Báo cáo thanh toán vẽ 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 hiển thị chi phí hằng ngày theo mức sử dụng hằng ngày của tháng hiện tại được nhóm theo dự án (cho 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ể đã áp dụng, cũng như tổng chi phí dự đoá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 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.

Ảnh chụp màn hình báo cáo thanh toán cho thấy biểu đồ và bảng bằng chế độ xem đặt trước mặc định — **Hình 1:** Báo cáo thanh toán hiển thị biểu đồ và bảng bằng chế độ xem đặt trước mặc định.

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 thông tin chi tiết về mô hình định giá trả tiền theo mức dùng và cách mô hình này tác động đến quá trình triển khai của bạn, hãy xem xét mức sử dụng và chi phí theo SKU.

Báo cáo thanh toán được nhóm theo SKU — **Hình 2:** Bảng thanh toán hiển thị mục hàng sử dụng và chi phí theo SKU.

Ảnh chụp màn hình các bộ lọc trong báo cáo thanh toán — **Hình 3:** Lọc báo cáo thanh toán.

Để thay đổi chế độ xem báo cáo nhằm 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 hiện có bao gồm Phạm vi 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 bắt đầu phân phát yêu cầu API.

Để phân loại nguồn sử dụng cùng vớ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 Google Maps Platform 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 (giá trị kênh số được đặt từ truy vấn API). Thông tin 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 cho từng mức sử dụng bằng cách bỏ đánh dấu hộp Bao gồm tín dụng trong chi phí trong bảng điều khiển bên phải.

Theo dõi và hạn chế mức sử dụng

Để 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 mức độ tăng trưởng của mức chi tiêu đế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ỉ thông báo cho bạn khi số tiền chi tiêu 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 các API có tính phí. Bạn có thể giới hạn mức chi tiêu của mình bằng cách đặt giới hạn về số yêu cầu mỗi ngày. Hãy sử dụng một phương trình đơn giản để xác định hạn mức 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á mỗi SKU)/30 = số yêu cầu giới hạn mỗi ngày (cho một API). Xin lưu ý rằng quá trình triển khai có thể sử dụng nhiều API có tính phí, vì vậy, hãy điều chỉnh phương trình của bạn nếu cần. Xin nhớ rằng mỗi tháng, bạn sẽ nhận được 200 USD tín dụng trên Nền tảng Google Maps, vì vậy, hãy nhớ tính đến giá trị đó khi tính toán.

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 tham số "channel" vào các yêu cầu API. Các giá trị kênh duy nhất được chấp nhận là các số từ 0-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 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 việc sử dụng kênh ngay trên Báo cáo thanh toán. Các kênh sẽ phản ánh trong Nhãn là khóa goog-maps-channel.

Lọc theo nhãn — **Hình 4:** Lọc theo SKU và kênh

Cách lọc báo cáo thanh toán theo SKU và kênh

Hãy 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 Khóa 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 sử dụng kênh trong các yêu cầu của mình, có thể có sự chậm 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.

BigQuery Export cho phép bạn tự động xuất dữ liệu chi tiết của Cloud Billing (chẳng hạn như dữ liệu về mức sử dụng và chi phí ước tính) trong suốt cả ngày sang 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 để xem bản phân tích chi tiết. Điều này giúp bạn hiểu rõ hơn về nguồn gốc của việc 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 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 trong tài khoả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à mã tham chiếu đến Mã tài khoản thanh toán của bạn, với 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

Thanh toán qua đám mây:

Nền tảng Google Maps:

Trạng thái phản hồi và báo cáo

Bảng bên dưới cho biết 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 liệu yêu cầu tương ứng có xuất hiện trong báo cáo Mức sử dụng, Hạn mức và Thanh toán hay không.

Báo cáo sử dụng trong mục Chỉ số của nền tảng Google Maps cung cấp thông tin chi tiết về HTTP response code class. Nếu bạn cần mức độ chi tiết cao hơn, hãy xem Mã trạng thái phản hồi có trong tính năng Theo dõi mức sử dụng nền tảng Google Maps.

Mã phản hồi có trong các phản hồi của API Maps		Có trong Báo cáo 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	4xx¹	Có	Có	Có
NOT_FOUND (API tĩnh, API vị trí địa lý và đường của Chế độ xem đường phố), ZERO_RESULTS (API tĩnh của Chế độ xem đường phố)	404	4xx	Có	Có	Có
INVALID_REQUEST (giá trị thông 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, 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	4xx¹	Có	Không	Không
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, Resources_EXHAUSTED, DailyLimit Lỗi đã vượt quá, tỷ lệ Limit Trung	200/403, 429	4xx¹	Có	Không	Không
UNKNOWN_ERROR	200/500, 503	5xx¹	Có	Có	Không
¹ Để cải thiện tính nhất quán của báo cáo mã lỗi, API 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 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` sang `4xx` cho trạng thái API Maps: `REQUEST_DENIED`, `OVER_DAILY_LIMIT`, `OVER_QUERY_LIMIT`, `dailyLimitExceeded`, `OVER_QUERY_LIMIT`, `dailyLimitExceeded`, từ trạng thái phản hồi HTTP sang `2xx`, từ trạng thái phản hồi HTTP sang `2xxrateLimitExceededuserRateLimitExceeded5xxUNKNOWN_ERROR` Bạn có thể thấy cả hai mã phản hồi trong giai đoạn chuyển đổi. Mã phản hồi được trả về trong phản hồi của API Maps không thay đổi. Hãy xác nhận rằng sự gia tăng về `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 xem mã phản hồi chính xác nào sẽ tăng trong Metrics Explorer (tìm hiểu thêm về cách sử dụng tính nă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 như lượt xem trên bản đồ hoặc lượt tương tác với địa điểm yêu thích. Bạn có thể phân tích các thông tin chi tiết này để khám phá các 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.

Các chức 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 cấp cao về doanh nghiệp để nhanh chóng xem được các xu hướng chính trong thông tin chi tiết về doanh nghiệp
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 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 yêu thích của mình

Các chỉ số tương tác có sẵn bao gồm:

Chế độ xem bản đồ: Theo dõi 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 được cung cấp hằng tuần vào thứ Tư đầu tiên sau khoảng 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. Chế độ xem bản đồ hiện chỉ có sẵn cho một số nhà phát triển Maps JS API để thử nghiệm.

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 chức năng Lọc và Nhóm theo để đi sâu vào các chỉ số một cách chi tiết hơn. 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 của lượt xem bản đồ chỉ dành cho mã bưu chính ở 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 yêu thích của mình. Bạn có thể tải xuống mỗi lần tối đa 90 ngày và những tệp tải xuống lớn hơn 60 nghìn ô sẽ bị cắt bớt. Quá trình xuất dữ liệu lượt xem 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.

Xuất thông tin chi tiết về doanh nghiệp

Các chỉ số trong thông tin chi tiết về doanh nghiệp được ẩn danh nên chỉ phản ánh xu hướng tổng thể trong 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à số lượng đóng góp từ các điểm 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 đối với dự án trên Google 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ề doanh nghiệp để ước tính chi phí sử dụng. Vui lòng tham khảo báo cáo về việc sử dụng để biết thêm thông tin về việc sử dụng.

Bộ định vị Plus

Đối với người dùng Locator Plus, trang tổng quan về số liệu phân tích giúp bạn phân tích và tạo thông tin chi tiết từ dữ liệu của mình, giúp bạn hiểu rõ mức độ tương tác của người mua sắm với công cụ định vị cửa hàng. Bạn có thể đo lường hiệu suất hằng tuần, bao gồm số lượt xem, số lượt tương tác với Tìm kiếm và Chi tiết địa điểm cũng như tỷ lệ tương tác tổng thể. Ngoài ra, trang tổng quan này cung cấp các điểm chuẩn quan trọng để so sánh cách triển khai của bạn với các nhà bán lẻ khác.

Truy cập vào Locator Plus trong Google Cloud Console.
Hãy truy cập vào phần Báo cáo mức độ tương tác trong 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ổng hợp của những công ty khác có chia sẻ dữ liệu của họ. Thông tin so sánh này cung cấp bối cảnh hữu ích, giúp bạn đặt ra các mục tiêu có ý nghĩa, hiểu rõ hơn về các xu hướng trong ngành và tìm hiểu hiệu quả hoạt động của bạn so với các đối thủ cạnh tranh.

Để xem dữ liệu đo điểm chuẩn, dữ liệu về mức độ tương tác của bạn sẽ được đưa vào các điểm chuẩn của Google theo cách ẩn danh. Để chọn không hiển thị cả chế độ xem và bao gồm dữ liệu tương tác một cách ẩn danh trong báo cáo đo điểm chuẩn, hãy gửi thẻ hỗ trợ. Yêu cầu hỗ trợ thường sẽ được giải quyết trong vòng 3 ngày.