Báo cáo nền tảng Google Maps

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

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 hình ảnh được xác định trước, cho phép bạn dễ dàng xem 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. Bạn có thể nhanh chóng xác định số lượng lệnh gọi API, bạn sắp đạt đến hạn mức sử dụng API và giám sát việc sử dụng thanh toán theo thời gian.

Các loại báo cáo bao gồm:

  • Báo cáo mức 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 cho các API của 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 các biểu đồ có thể nhóm trong 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 sẽ hiển thị trong các 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 cụ thể theo 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 Mức độ tương tác: Báo cáo số lượt xem, số lượt tương tác và tỷ lệ tương tác của người dùng Locator Plus.

Hãy xem Báo cáo và trạng thái phản hồi bên dưới để 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 liệu một yêu cầu có xuất hiện trong các báo cáo Sử dụng, Hạn mức và/hoặc Thanh toán hay không.

Xem báo cáo về mức sử dụng, hạn mức và thanh toán trên Nền tảng Google Maps bằng Cloud Console.

Báo cáo 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 thực hiện cho các API của Nền tảng Google Maps bằng cách sử dụng thông tin đăng nhập liên kết với dự án của bạn. Các 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 ứng dụng. Thông tin xác thực bao gồm các 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).

Các chỉ số sử dụng sẽ 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:

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

Trang tổng quan 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 của tất cả cá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 tổng quan có ba biểu đồ và một 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 thấy mức sử dụng trong truy vấn/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 đồ Latency (Độ trễ) cho biết độ trễ trung bình của các yêu cầu cho 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. 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 đã dẫn đến lỗi này. Độ 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

Cách truy cập vào trang tổng quan API và dịch vụ:

  1. Mở trang bộ chọn Dự án trong Cloud Console:

    Trang bộ chọn dự án

  2. Chọn dự án của bạn. Trang tổng quan API và dịch vụ xuất hiện.

    Nếu trang không xuất hiện, hãy chọn nút trình đơn 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 trên Google Maps bao gồm các API đã bật cho trang thông tin trên bảng 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ạng biểu đồ. Biểu đồ thanh toán cho bạn xem hóa đơn hiện tại và tổng mức sử dụng trong 3 tháng gần nhất.

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

Cách truy cập vào Trang tổng quan về Nền tảng Google Maps:

  1. Mở trang Google Maps Platform trong Cloud Console:

    Chuyển đến trang Nền tảng Google Maps

  2. Trong trình đơn bên trái, hãy chọn Tổng quan.

Trang API Nền tảng Google Maps

Trang API Google Maps bao gồm hai bảng. Bảng API được bật cho biết số lượng yêu cầu, số lỗi và độ trễ trung bình của từng 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

Cách truy cập vào trang API Nền tảng Google Maps:

  1. Mở trang Google Maps Platform trong Cloud Console:

    Chuyển đến trang Nền tảng Google Maps

  2. Trong trình đơn bên trái, hãy chọn API.

Trang Chỉ số Google Maps

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

Sử dụng API thả xuống ở trên cùng, và các tùy 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 các API cụ thể hoặc nhiều, 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à độ 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 thể hiện các bộ lọc Nền tảngMiền của một API khi nhóm theo Nền tảngMiền trong danh sách thả xuống Được nhóm theo:

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

Cách truy cập vào trang Chỉ số API của Nền tảng Google Maps:

  1. Mở trang Google Maps Platform trong Cloud Console:

    Chuyển đến trang Nền tảng Google Maps

  2. Trong trình đơn bên trái, hãy chọn Chỉ số.

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

Biểu đồ Lưu lượng truy cập theo mã phản hồiLỗ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 dưới đây 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 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ính đế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ính đến hạn mức.

Ví dụ: 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.
DỮ LIỆU KHÔNG CÓ 4xx(1) Phản hồi thành công cho biết không có dữ liệu cho các vị trí nhập.

Đây là yêu cầu có thể lập hoá đơn và sẽ tính đến hạn mức.
ZERO_RESULTS (Kết quả chi tiết) 4xx(1) Không trả về kết quả phản hồi thành công.

Đây là yêu cầu có thể lập hoá đơn và sẽ tính đến hạn mức.
KHÔNG_TÌM_THẤY 4xx(1) Đối với API Chỉ đường, tình trạng này cho biết rằng không thể mã hoá địa lý ít nhất một trong số các vị trí được chỉ định tại điểm gốc, điểm đến hoặc điểm của yêu cầu.

Đối với API Địa điểm, API này cho biết không tìm thấy vị trí đã tham chiếu (place_id) trong cơ sở dữ liệu Địa điểm.

Đây là yêu cầu có thể lập hoá đơn và sẽ tính đế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 xem phản hồi của API để biết thêm thông tin.

Đây là yêu cầu có thể lập hoá đơn và sẽ tính đến hạn mức.
YÊU CẦU BỊ TỪ CHỐI 4xx Lỗi ứng dụng 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 thông tin.
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
rateVượt quá,
vượt quá giới hạn hằng ngày,
Đã vượt quá giới hạn tỷ lệ người dùng
4xx Lỗi ứng dụng do có quá nhiều yêu cầu trong mỗi khoảng thời gian cho phép. Hãy thử lại yêu cầu này vào lúc khác. Hãy xem phản hồi của API để biết thêm thông tin.
INVALID_REQUEST (thông số không hợp lệ/bị thiếu, yêu cầu phân tích cú pháp/lỗi xác thực) 4xx Lỗi ứng dụng khách do yêu cầu không hợp lệ gây ra. Hãy xem phản hồi của API để biết thêm thông tin.
NOT_FOUND (404) 4xx Đối với API vị trí địa lý, tín hiệu này cho biết dữ liệu đầu vào không đủ để đưa ra ước tính vị trí.

Đối với API Đường, cho biết rằng các đầu vào không thể gắn vào đường một cách hợp lý.

Đây là yêu cầu có thể lập hoá đơn và sẽ tính đến hạn mức.
LỖI_KHÔNG XÁC ĐỊNH 5xx Lỗi máy chủ cho biết rằng không thể xử lý yêu cầu: lỗi nội bộ, quá tải dịch vụ, không có sẵn, hết thời gian chờ, v.v.
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 các 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 Các chỉ số của Nền tảng Google Maps có 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 tăng trong Trình khám phá chỉ số (tìm hiểu thêm về việc 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 mã hoá địa lý hoặc Phản hồi chỉ đường).

Thông số giải pháp 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à sử dụ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 hướng dẫn triển khai cho các giải pháp ngành và tìm hiểu từ các 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 sẽ đư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.
  • Thông 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 để 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 tham gia bằng cách xóa 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 xóa thông 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.
  • Tham 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 xóa thông số khỏi mã mẫu giải pháp sẽ không vô hiệu hóa báo cáo API JavaScript 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ó thể thực hiện với API Nền tảng Google Maps. Các yêu cầu có thể bị giới hạn theo ba 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 không được tính vào hạn mức.

Mức sử dụng hạn mức hiển thị 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 các API đã chọn sẽ hiển thị trong các bảng bên dưới biểu đồ mức sử dụng hạn mức.

Sử dụng máy tính này để nhận giá trị hạn mức mỗi phút cho bất kỳ sản phẩm API GMP nào.

Trang hạn mức 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 đồ mức 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 chỉ hiển thị các yêu cầu sử dụng 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ị tham số không hợp lệ), UNKNOWN_ERROR).

Các yêu cầu gây ra lỗi ứng dụng khách — lỗi xác thực/uỷ quyền/lỗi đố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 cú pháp 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 của hầu hết các API Nền tảng Google Maps (API tĩnh, API tĩnh của Chế độ xem phố, API mã hóa địa lý, API Chỉ đường, API địa điểm, API múi giờ, API vị trí địa lý và API độ cao). Tuy nhiên, 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 đích-đích.
  • Đố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 Maps dành cho Android và SDK Maps dành cho iOS, đơn vị hạn mức là yêu cầu Chế độ xem phố/Tải toàn cảnh (Tải bản đồ miễn phí và không sử dụng hạn mức).

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

Cách truy cập vào trang Hạn mức Nền tảng Google Maps:

  1. Mở trang Google Maps Platform trong Cloud Console:

    Chuyển đến trang Nền tảng Google Maps

  2. Trong trình đơn bên trái, hãy chọn Hạn mức.
  3. Chọn một API trong danh sách API thả xuống.

Đơn vị hạn ngạch

Bảng dưới đây cho thấy đơn vị hạn mức cho 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 Toàn cảnh
SDK Maps dành cho iOS 1 Toàn cảnh
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) 1 yêu cầu
API tuyến đường (Ma trận tuyến tính) 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
Địa điểm
Places API 1 yêu cầu
API Xác thực địa chỉ 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

Báo cáo thanh toán

Xem báo cáo thanh toán

Báo cáo thanh toán về việc bạn sử dụng các sản phẩm Nền tảng Google Maps có sẵn trong Google Cloud Console (xem phần Thanh toán).

Cách truy cập vào báo cáo thanh toán:

  1. Mở trang bộ chọn Dự án trong Cloud Console:

    Trang bộ chọn dự án

  2. Chọn một dự án.
  3. Chọn nút trình đơn trình đơn rồi chọn Thanh toán.
  4. 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.
  5. 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 đã liên kết.

Cách đọc biểu đồ báo cáo thanh toán

Biểu đồ thanh toán thể hiện 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í sử dụng cụ thể 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ự 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 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 cách sử dụ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 cách sử dụ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 về chi tiết của mô hình thanh toán theo mức chi tiêu và mức độ ảnh hưởng của mô hình đó đối với cách bạn triển khai, 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ị các mục hàng sử dụng và chi phí theo SKU.
Ảnh chụp màn hình bộ lọc báo cáo thanh toán
Hình 3: Bộ lọc báo cáo thanh toán.
Để thay đổi chế độ xem báo cáo thành hiển thị mục hàng theo SKU:
  1. Trong bảng ở bên phải của biểu đồ, hãy mở rộng bộ lọc Nhóm theo.
  2. 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, SKUVị trí cho phép bạn lọc theo nơi 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 khóa liên quan đến API Nền tảng Google Maps là goog-maps-api-key-suffix (4 ký tự cuối 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ố đặt từ một truy vấn API). Xem thêm thông tin 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 từng mục đích sử dụng bằng cách bỏ chọn hộp đánh dấu Bao gồm các khoản tín dụng trong chi phí trong bảng điều khiển bên phải.

Giám sát và hạn chế tiêu thụ

Để giúp bạn 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 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 sẽ không giới hạn mức sử dụng API, nó chỉ thông báo cho bạn khi số tiền chi tiêu của bạn gần đế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 cho yêu cầu mỗi ngày, 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ới hạn 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 = yêu cầu giới hạn mỗi ngày (cho một API). Xin lưu ý rằng quy trình triển khai của bạn có thể sử dụng nhiều API có thể thanh toán, vì vậy, hãy điều chỉnh phương trình nếu cần. Xin nhớ rằng khoản tín dụng Nền tảng Google Maps trị giá 200 đô la Mỹ được cung cấp mỗi tháng, vì vậy, hãy tính đến yếu tố đó để tính toán.

Theo dõi sử dụng trên mỗi kênh

Để theo dõi việc sử dụng của bạn thông qua các kênh số, bạn phải thêm thông số "channel" vào yêu cầu API của mình. 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>

Giám sát việc sử dụng kênh trực tiếp trên Báo cáo thanh toán của bạn. Các kênh sẽ phản ánh 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
  1. Sử dụng bộ lọc SKU Nhóm theo.
  2. Chọn con nháy Nhãn.
  3. Chọn trình đơn thả xuống Khóa rồi chọn goog-maps-channel.
  4. 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 các yêu cầu của bạn, có thể có một 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 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 cho phép bạn tự động xuất dữ liệu chi tiết về dịch vụ Thanh toán trên đám mây (chẳng hạn như dữ liệu sử dụng và chi phí ước tính chi phí) trong suốt 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 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 BigQuery Export 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 vào 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 bạn đã tạo (ví dụ: "SampleDataSet").
    • BILLING_ACCOUNT_ID là mã tham chiếu của Mã tài khoản thanh toá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
  

Thanh toán trên đám mây:

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 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 các báo cáo về Mức sử dụng, Hạn mức và Thanh toán hay không.

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

Mã phản hồi hiện 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 API Maps Mã phản hồi HTTP Lớp mã phản hồi HTTP Mức sử dụng Định mức Thanh toán
OK 200,
204,
302
2xx,
3xx
DATA_NOT_AVAILABLE,
NOT_FOUND,
ZERO_RESULTS
200 4xx1
NOT_FOUND (API tĩnh của Chế độ xem phố, Vị trí địa lý và Đường bộ),
ZERO_RESULTS (Street View Static API)
404 4xx
INVALID_REQUEST (giá trị thông số không hợp lệ),
MAX_ROUTE_LENGTH_EXCEEDED,
MAX_WAYPOINTS_EXCEEDED,
v.v.
200/400 4xx
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 Không Không
YÊU CẦU BỊ TỪ CHỐI 200/400/403 4xx1 Không Không
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
đã vượt quá giới hạn hằng ngày,
tỷ lệ vượt quá giới hạn,
userRateLimitVượt quá
200/403,
429
4xx1 Không Không
LỖI_KHÔNG XÁC ĐỊNH 200/500,
503
5xx1 Không
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 các 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 Các chỉ số của Nền tảng Google Maps có 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 tăng trong Trình khám phá chỉ số (tìm hiểu thêm về việc sử dụng Google Cloud Monitoring cho Nền tảng Google Maps).

Báo cáo tham gia

Đố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, cung cấp thông tin rõ ràng về mức độ hiệu quả của người mua sắm đối với bộ định vị cửa hàng. Bạn có thể đo lường hiệu suất theo tuần, bao gồm số lượt xem, số lượt tương tác với Google Tìm kiếm và Thông tin chi tiết về đị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 về cách so sánh cấu hình triển khai của bạn với các nhà bán lẻ khác.

Báo cáo đo điểm chuẩn cho phép bạn so sánh dữ liệu của bạn với dữ liệu ngành tổng hợp từ các công ty khác có chia sẻ dữ liệu của họ. Dữ liệu so sánh cung cấp bối cảnh có giá trị, giúp bạn đặt ra các mục tiêu có ý nghĩa, hiểu rõ hơn về xu hướng của ngành và tìm hiểu hiệu suất của bạn so với đối thủ cạnh tranh.

Để xem dữ liệu đo điểm chuẩn, dữ liệu tương tác của bạn được đưa ẩn danh vào điểm chuẩn của Google. Để chọn không xem và đưa dữ liệu tương tác của bạn một cách ẩn danh trong báo cáo đo điểm chuẩn, hãy gửi vé hỗ trợ. Chúng tôi sẽ giải quyết yêu cầu hỗ trợ trong vòng 3 ngày.