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 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 biểu đồ, một bảng liệt kê các API và dịch vụ đã bật. 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.

API giám sát

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:
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 Theo dõi mức sử dụng API.

Trang tổng quan trên 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.

Ả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 đã bật và yêu cầu API trong 30 ngày 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:
Truy cập trang Nền tảng Google Maps
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, đồng thời 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.

API

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:
Truy cập trang Nền tảng Google Maps
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ị.

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

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:

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

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:
Truy cập trang Nền tảng Google Maps
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.

Đị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: Đối với các API chấp nhận mã ứng dụng Maps Platform: Mã ứng dụng Maps Platform được dùng để tải API. Ví dụ: sử dụng `&client=gme-_mycompany_`. Các API này chấp nhận mã nhận dạng ứng dụng khách: API Maps JavaScript, API Maps Static, API Street View Static, API Elevation, API Directions, API Distance Matrix, API Geocoding, API Time Zone. Để biết thêm thông tin, hãy xem phần Quản lý mã ứng dụng của gói Premium. Đối với các API chấp nhận OAuth: API được tải bằng OAuth mà không có khoá API.

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:

Đối với các API chấp nhận mã ứng dụng Maps Platform: Mã ứng dụng Maps Platform được dùng để tải API. Ví dụ: sử dụng &client=gme-_mycompany_.
Các API này chấp nhận mã nhận dạng ứng dụng khách: API Maps JavaScript, API Maps Static, API Street View Static, API Elevation, API Directions, API Distance Matrix, API Geocoding, API Time Zone. Để biết thêm thông tin, hãy xem phần Quản lý mã ứng dụng của gói Premium.
Đối với các API chấp nhận OAuth: API được tải bằng OAuth mà không có khoá API.

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⁽¹⁾	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⁽¹⁾	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⁽¹⁾	Đố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 của API để biết thêm thông tin 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.
¹ Để 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 lớp học 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 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ề số liệu phân tích về việc sử dụng giải pháp cho Google để 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 ra 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 — lỗi 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 Distance Matrix, đơ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 bị tính hạn mức.

Ảnh chụp màn hình trang Hạn mức của Maps trong Google Cloud Console. Thẻ này cho thấy hạn mức theo API bằng cách sử dụng 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ó liên quan.

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:
Truy cập trang Nền tảng Google Maps
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.

Các đơn vị hạn ngạ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:
Trang bộ chọn dự án
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 đồ đườ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.

Ảnh chụp màn hình 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 — **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í cho mỗi SKU

Để hiểu chính xác 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.

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 về mức sử dụng và chi phí theo SKU.

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

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).

Lưu ý: Quá trình triển khai của bạn có thể sử dụng nhiều API có thể tính phí, vì vậy, hãy điều chỉnh phương trình của bạn nếu cần. Hãy nhớ rằng bạn có thể sử dụng khoản tín dụng 200 USD trên Nền tảng Google Maps mỗi tháng, vì vậy, hãy nhớ tính khoản tín dụng đó vào khi tính toán. Ưu đãi tín dụng 200 USD mỗi tháng trên Nền tảng Google Maps có hiệu lực đến 23:59 ngày 28 tháng 2 năm 2025 (theo giờ địa phương). Kể từ ngày 1 tháng 3 năm 2025, khoản tín dụng 200 đô la sẽ được thay thế bằng ngưỡng sử dụng miễn phí cho mỗi API. Để biết thêm thông tin, hãy xem phần Câu hỏi thường gặp.

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.

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

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 Key (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

Cloud Billing:

Nền tảng Google Maps:

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ề 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, NOT_FOUND, ZERO_RESULTS	200, 404	4xx¹	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	4xx¹	Có	Không	Không
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded	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 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 cấp cao về thông tin chi tiết về doanh nghiệp để 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.

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

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.