Informes de Google Maps Platform

Los informes de Google Maps Platform proporcionan un conjunto informes de uso básico de la API, cuotas y datos de facturación en la Consola de Google Cloud. Usa estos informes para determinar la cantidad de APIs llamadas realizadas, qué tan cerca está de alcanzar las cuotas de uso de la API y supervisar el uso de la facturación a lo largo del tiempo.

Entre los tipos de informes, se incluyen los siguientes:

• Informes de uso: Indican la cantidad de solicitudes que se realizan en tu proyecto a las APIs de Google Maps Platform mediante las credenciales asociadas con tu proyecto.
• Informes de cuota: Indican el uso de la cuota en gráficos que se pueden agrupar en solicitudes por minuto. Los límites de cuota actuales para las API seleccionadas se muestran en forma de tablas debajo de los gráficos sobre el uso de la cuota.
• Informes de facturación: Muestran los costos en el tiempo como un gráfico de líneas apiladas. Consulta el uso de la cuota del mes actual, incluidos los créditos de uso específicos aplicados, así como el costo previsto total para todo el mes actual.
• Informes de participación: Proporciona estadísticas empresariales sobre cómo interactúan los usuarios con tus apps de mapas.

Para obtener una lista completa de los estados y códigos de respuesta que definen si una solicitud aparece en las secciones Uso, Cuota, o de Facturación, consulte Informes y estado de respuesta.

Consulta los informes de uso, cuota y facturación de Google Maps Platform en la consola de Cloud.

Informes de uso

El uso se basa en la cantidad de solicitudes que se realicen a la las APIs de Google Maps Platform que usan las credenciales asociadas con tu en un proyecto final. Se contabilizan las solicitudes exitosas, las que generan errores y solicitudes que generen errores de cliente. Las credenciales incluyen las claves de API y los IDs de cliente (para el plan Premium y los proyectos migrados del plan Premium). Para conocer los detalles, consulta la Descripción general del plan Premium y información sobre el uso de un ID de cliente.

Las métricas de uso se muestran en tablas (Solicitudes, Errores y Latencia) y gráficos (Tráfico, Errores y Latencia). Para fines de seguimiento, ten en cuenta lo siguiente:

• Todas las APIs: Puedes filtrar y agrupar métricas de uso para todas las APIs en estas maneras:

  • Filtra por período y API.
  • Ver el tráfico, los errores y la latencia agrupados por código de respuesta, API y de Google Cloud.

• Una API específica: Puedes filtrar y agrupar las métricas de uso de una API específica. de las siguientes maneras:

  • Filtra por período, versiones de la API, credenciales y métodos.
  • Agrupación de tráfico, errores y latencia por código de respuesta y método de API versión y credencial.

Página Panel de API y servicios

Las APIs y Servicios Panel proporciona una descripción general de las métricas de uso de todas las APIs habilitado para tu proyecto: las APIs de Google Maps Platform y otras APIs y servicios.

• La página Panel (Dashboard) presenta tres gráficos y una tabla. Puedes filtrar el uso que se muestra en los gráficos y las tablas mediante la selección de un período desde 1 hora hasta los últimos 30 días.

• En el gráfico Tráfico, se muestra el uso en consultas por minuto (QPM) por API.

• El gráfico Errores (Errors) muestra el porcentaje de solicitudes que generaron errores. por API.

• El gráfico Latencia muestra la latencia mediana de las solicitudes por API.

Debajo de los gráficos, una tabla enumera las APIs y los servicios habilitados. Las solicitudes representan la cantidad de solicitudes (en el período seleccionado). Los errores representan la cantidad de solicitudes que generaron errores. La latencia (latencia media y percentil) es la latencia correspondiente a estas solicitudes.

Para acceder a las APIs y Página Panel de servicios:

1. Abre la página del selector de proyectos en la consola de Cloud:

   Página del selector de proyectos

2. Elige tu proyecto. Las APIs y Aparecerá la página Panel de servicios.
   
   Si no aparece la página, selecciona el botón de menú . y, luego, selecciona APIs y Servicios.

Si deseas obtener más información, consulta Cómo supervisar el uso de tu API.

Página Descripción general de Google Maps

La página Descripción general de Google Maps incluye una tabla con las API habilitadas y las solicitudes de uso de los últimos 30 días. Las solicitudes por API también se muestran en forma de gráfico. Un gráfico de facturación muestra tu factura actual y el uso total de los últimos 3 meses.

Nota: Si seleccionas el nombre de una API habilitada, se te redireccionará. a la página Métricas (Metrics) de Google Maps para esa API.

Para acceder a la página Descripción general de Google Maps Platform, sigue estos pasos:

1. Abre la página de Google Maps Platform en la consola de Cloud:

   Ir a la página de Google Maps Platform

2. En el menú de la izquierda, selecciona Descripción general.

APIs de Google Maps Platform y Página Servicios

Google Maps APIs y Página Servicios contiene una cuadrícula de mosaicos que representan las APIs, los SDKs y otros servicios disponibles para tu proyecto. En cada tarjeta, puedes habilitar o inhabilitar seleccionando Habilitar o Inhabilitar, y podrás acceder a las credenciales información, métricas y guías del usuario para APIs habilitadas. También puedes usar los filtros de página para ver los servicios habilitados o inhabilitados y otras categorías de servicios.

Para acceder a las APIs de Google Maps Platform y Página Servicios:

1. Abre la página de Google Maps Platform en la consola de Cloud:

   Ir a la página de Google Maps Platform

2. En el menú de la izquierda, selecciona APIs y Servicios

Página Métricas de Google Maps

La página Métricas de Google Maps muestra tres gráficos: Tráfico, Errores y Latencia mediana. Los datos de uso en los gráficos pueden agruparse por clase de código de respuesta, API, método de API, credencial, plataforma y dominio.

Debajo de los gráficos, la página Métricas incluye una tabla de API que muestra las solicitudes, los errores y la latencia para las API que seleccionaste.

Con el menú desplegable de la API en la parte superior y las opciones de agrupación y filtrado en el panel derecho, puedes agrupar y filtrar las métricas de uso que se muestran seleccionando APIs específicas o múltiples Credenciales, clases de códigos de respuesta, tipo de plataforma o dominio. También puedes seleccionar un período (desde una hora hasta los últimos 30 días) y un nivel de detalle (por segundo o día) para las métricas de uso que se muestran.

Nota: Las opciones Plataforma y Dominio de la lista desplegable Agrupado por, y las Los filtros Plataforma y Dominio solo aparecen cuando seleccionas una sola API. en la lista desplegable de selección de API.

Las siguientes imágenes muestran los filtros de Plataforma y Dominio para una sola API cuando En la lista desplegable Agrupado por, se selecciona la opción para agrupar por Plataforma y Dominio:

Para acceder a la página Métricas (Metrics) de la API de Google Maps Platform, haz lo siguiente:

1. Abre la página de Google Maps Platform en la consola de Cloud:

   Ir a la página de Google Maps Platform

2. En el menú de la izquierda, selecciona Métricas.

Informes de credenciales

Puedes filtrar y agrupar métricas según la credencial utilizada para cargar la en la API de Cloud.

Formato de las credenciales	Significado
Nombre de la clave Por ejemplo, "Clave app para dispositivos móviles"	Se usó una clave de API para cargar la API con ?key=...: Puedes encontrar los nombres de las claves en Maps Platform. Consola en Claves y Credenciales.
Número de proyecto Por ejemplo, "project_number:123456", donde 123456 es el número de tu proyecto.	Si ves esta credencial, hay dos posibilidades: Para las APIs que aceptan IDs de cliente de Maps Platform: A Se usó el ID de cliente de Maps Platform para cargar la API. Por ejemplo: usando &client=gme-_mycompany_. Estas APIs aceptan IDS de cliente: Maps JavaScript API y Maps Static API, API de Street View Static, API de Elevation, API de Directions, Distance API de Matrix, API de Geocoding y API de Time Zone. Para obtener más información, consulta Administración de IDs de cliente del plan Premium. Para las APIs que aceptan OAuth: Se cargó la API. con OAuth sin una clave de API.

Nota: No hay APIs de Maps Platform que admitan ambos IDs de cliente de Maps Platform y OAuth, de modo que puedas saber si la API se cargó con un ID de cliente o OAuth en función de la API que se usó

Gráficos del código de respuesta

Los gráficos de tráfico y de error por código de respuesta se dividen el uso por clase de código de respuesta HTTP. En esta tabla, se muestra la asignación el estado de respuesta de la API de Google Maps Platform y la clase del código de respuesta HTTP:

Estado de la API de Google Maps	Clase de código de respuesta HTTP: informe de uso (2xx, 3xx, 4xx, 5xx)	Notas
Aceptar	2xx	Respuesta correcta. Esta es una solicitud facturable y consumirá parte de la cuota disponible.
Aceptar	3xx	Respuesta correcta. Esta es una solicitud facturable y consumirá parte de la cuota disponible. Por ejemplo, las solicitudes exitosas de Place Photo muestran 302 y redireccionan a la imagen a la que se hace referencia.
DATA_NOT_AVAILABLE	4xx^(1)	Respuesta correcta que indica que no hay datos disponibles para el ubicaciones de entrada. Esta es una solicitud facturable y consumirá parte de la cuota disponible.
ZERO_RESULTS	4xx^(1)	La respuesta correcta no devolvió ningún resultado. Esta es una solicitud facturable y consumirá parte de la cuota disponible.
NOT_FOUND	4xx^(1)	Para el API de Directions, este mensaje indica que al menos una de las ubicaciones especificadas en no se pudo geocodificar el origen, el destino ni los puntos de referencia de la solicitud. Para el API de Places este mensaje indica que la ubicación indicada (place_id) no fue que se encuentra en la base de datos de Places. Esta es una solicitud facturable y consumirá parte de la cuota disponible.
INVALID_REQUEST (valor del parámetro no válido), MAX_WAYPOINTS_EXCEEDED, MAX_ROUTE_LENGTH_EXCEEDED y otros.	4xx	Error debido a un valor del parámetro no válido. Consulta la respuesta de la API para obtener más detalles. Esta es una solicitud facturable y consumirá parte de la cuota disponible.
REQUEST_DENIED	4xx	Error de cliente debido a un error de autenticación o de acceso, entre otros. Consulta la respuesta de la API para obtener más detalles.
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, rateLimitExceeded, dailyLimitExceeded, userRateLimitExceeded	4xx	Error del cliente debido a un exceso de solicitudes durante el período permitido. Reintentar la solicitud en otro momento. Consulta la respuesta de la API para obtener más detalles.
INVALID_REQUEST (parámetro faltante o no válido, solicitud) error de análisis o validación)	4xx	Error del cliente debido a una solicitud no válida. Consulta la respuesta de la API para obtener más información más detalles.
NOT_FOUND (404)	4xx	Para el API de Geolocation, este mensaje indica que las entradas no fueron suficientes para producir una estimación de la ubicación. Para la API de Roads, este mensaje indica que las entradas no se pudieron ajustar de forma razonable a las rutas. Esta es una solicitud facturable y consumirá parte de la cuota disponible.
UNKNOWN_ERROR	5xx	Error del servidor que indica que no se puede procesar la solicitud: interno error, sobrecarga del servicio, no disponible, tiempo de espera agotado, etcétera.
^1 Para mejorar la coherencia de los informes de código de error, las APIs de Google Maps Platform están migrando de la siguiente forma: 1) de la clase de código de respuesta HTTP 2xx a 4xx para los estados de la API de Google Maps: DATA_NOT_AVAILABLE, NOT_FOUND y ZERO_RESULTS (estado relacionado); 2) de la clase de código de respuesta HTTP 2xx a 4xx para los estados de la API de Google Maps: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded y userRateLimitExceeded, y 3) de la clase de código de respuesta HTTP 2xx a 5xx para el estado de la API de Google Maps: UNKNOWN_ERROR. Puedes ver ambos códigos de respuesta durante el período de transición. Los códigos de respuesta que se muestran en las respuestas de la API de Google Maps no cambiarán. Puedes ver qué código de respuesta exacto aumenta en el Explorador de métricas para confirmar si un aumento de 4xx o de 5xx en las Métricas de Google Maps Platform está relacionado con esta migración (más información sobre el uso de Google Cloud Monitoring para Google Maps Platform).

Para obtener más información sobre los códigos de estado y los mensajes de error, consulta la respuesta documentación de la API que te interesa (por ejemplo, Respuestas de Geocoding o Respuestas a las instrucciones sobre cómo llegar).

Parámetro de soluciones de Google Maps Platform

Google Maps Platform proporciona muchos tipos de códigos de muestra para ayudarte a comenzar y se ejecuta rápidamente. Por ejemplo, puedes usar Herramienta de creación rápida en la consola de Cloud, sigue las soluciones del sector guías de implementación, y aprender de codelabs.

Para comprender el uso y las formas de mejorar nuestras soluciones, Google incluye lo siguiente: Parámetro de consulta solution_channel en las llamadas a la API para recopilar información sobre el uso del código de muestra:

• El parámetro de consulta solution_channel se incluye de forma predeterminada. en el código de muestra de la solución.
• Este parámetro devuelve estadísticas sobre la adopción de la solución a Google para mejorar la calidad de la solución en futuras iteraciones.
• Para inhabilitar esta opción, puedes borrar la consulta solution_channel. y su valor del código de muestra.
• No es necesario mantener el parámetro. Quitando la consulta no afecta el rendimiento.
• El parámetro de búsqueda solo se usa para los informes de uso del código de muestra.
• El parámetro de consulta es independiente de las estadísticas informes. Esto significa quitar el parámetro del código de muestra de la solución No inhabilita los informes internos de la API de Maps JavaScript.

Informes sobre la cuota

Las cuotas establecen límites para la cantidad de solicitudes que puede hacer tu proyecto a APIs de Google Maps Platform. Las solicitudes se pueden limitar de tres maneras: por día, por minuto y por usuario, por minuto. Solo las solicitudes exitosas y las solicitudes que causan errores de servidor se descuentan de la cuota. Solicitudes que y las fallas de autenticación no se descuentan de la cuota.

El uso de la cuota se muestra en gráficos en la página Cuotas de la consola de Cloud. y se pueden agrupar en solicitudes por minuto. Los límites de cuota actuales para Las APIs seleccionadas se muestran en tablas debajo del límite de uso gráficos.

Para obtener el valor por minuto de tu cuota para cualquier producto de la API de GMP, usa este calculadora.

Página Cuotas de Google Maps

La página Cuotas (Quotas) de Google Maps muestra los límites y el consumo de la cuota correspondientes a la API específica que seleccionaste.

El gráfico de uso de la cuota en la consola de Google Cloud muestra el tráfico total de tus IDs de cliente y claves de API. El tráfico de los IDs de cliente también está disponible en el gráfico de métricas en la consola de Cloud.

La página muestra solo las solicitudes que consumen la cuota disponible: solicitudes exitosas (OK, ZERO_RESULTS, DATA_NOT_AVAILABLE) y aquellas que causan errores de servidor (NOT_FOUND, INVALID_REQUEST/INVALID_VALUE (valor de parámetro no válido), UNKNOWN_ERROR).

Las solicitudes que causan errores de cliente (autenticación, autorización y errores de argumentos no válidos (REQUEST_DENIED, OVER_QUERY_LIMIT, INVALID_REQUEST) (parámetro no válido, error de análisis de la solicitud) — no consumen la cuota y no se muestran.

La unidad de cuota es una solicitud para la mayoría de las APIs de Google Maps Platform (API de Maps Static, API de Street View Static, las APIs de Geocoding, Directions, las APIs de Places, Time Zone, API de Geolocation y API de Elevation), pero hay algunas excepciones:

• Para la API de Distance Matrix, la unidad de cuota es un elemento que equivale a un par de origen y destino.
• Para la API de Maps JavaScript, la unidad de cuota es una carga de mapa.
• En el caso del SDK de Maps para Android y el SDK de Maps para iOS, haz lo siguiente: la unidad de cuota es una solicitud de Street View o de Panorama de carga de trabajo. Las cargas de mapa están disponibles sin cargo y no consumen la cuota disponible.

Para acceder a la página Cuotas de Google Maps Platform, sigue estos pasos:

1. Abre la página de Google Maps Platform en la consola de Cloud:

   Ir a la página de Google Maps Platform

2. En el menú de la izquierda, selecciona Cuotas (Quotas).
3. Selecciona una API de la lista desplegable.

Unidades de cuota

En esta tabla, se muestra la unidad de cuota para las APIs de Google Maps Platform.

API de Google Maps Platform	Unidad de cuota
Maps
SDK de Maps para Android	1 panorámica
SDK de Maps para iOS	1 panorámica
API de Map Tiles	1 solicitud
API de Maps Aerial View	1 solicitud
API de Maps Static	1 solicitud
API de Maps JavaScript	1 carga de mapa
API de Street View Static	1 solicitud
API de Maps Embed	1 carga de mapa
Routes
API de Routes (Compute Routes)	1 solicitud
API de Routes (Compute Route Matrix)	1 elemento (par de origen y destino)
API de Directions	1 solicitud
API de Distance Matrix	1 elemento (par de origen y destino)
API de Roads	1 solicitud
API de Route Optimization	1 solicitud
Places
API de Places	1 solicitud
API de Address Validation	1 solicitud
API de Geocoding	1 solicitud
API de Geolocation	1 solicitud
API de Time Zone	1 solicitud
Entorno
API de Air Quality (CurrentConditions y HeatmapTile)	1 solicitud
API de Air Quality (History)	1 página
API de Pollen	1 solicitud
API de Solar	1 solicitud

Informes de facturación

Cómo consultar tu informe de facturación

Los informes de facturación por el uso que hagas de los productos de Google Maps Platform se encuentran en disponibles en la consola de Google Cloud. Para obtener más información, consulta Facturación.

Para acceder a los informes de facturación, haz lo siguiente:

1. Abre la página del selector de proyectos en la consola de Cloud:

   Página del selector de proyectos

2. Selecciona un proyecto.
3. Selecciona el botón de menú  y, luego, Facturación.
4. Si tienes varias cuentas de facturación, selecciona Ir a la cuenta de facturación vinculada para abrir la página Descripción general de esa cuenta.
5. En el menú de la izquierda, selecciona Informes para abrir la página Informes de facturación de la cuenta de facturación vinculada.

Cómo leer el gráfico del informe de facturación

Los informes de facturación representan el costo en el tiempo como un gráfico de líneas apiladas. Predeterminado La vista muestra los costos diarios específicos de uso del mes actual agrupados por proyecto (para todos los productos), incluidos los créditos de uso específico aplicados, así como el costo previsto total para todo el mes en curso. Cada línea del gráfico (y cada fila en la tabla de resumen) corresponde al proyecto, que se clasifica de mayor a menor en función del costo. Obtén más información para interpretar el gráfico del informe de facturación.

Figura 1: El informe de facturación muestra el gráfico con la vista predeterminada.

Sugerencia: Analiza el uso y el costo por SKU

Para comprender con mayor precisión los detalles del modelo de precios de pago por uso y y cómo afecta a tu implementación, observa el uso y el costo por SKU.

Figura 2: La tabla de facturación muestra el uso y líneas de pedido de costo por SKU.

Figura 3: Filtros del informe de facturación.

Para cambiar la vista del informe de modo que muestre elementos de una sola línea por SKU, haz lo siguiente:

1. En el panel a la derecha del gráfico, expande el filtro Agrupar por (Group by).
2. Selecciona SKU.

Otros filtros de informes de facturación disponibles incluyen Intervalo de tiempo, Proyectos, Productos, SKU y Ubicaciones, que te permiten filtrar por donde desde donde se entregan las solicitudes a la API.

Para categorizar la fuente del uso además del producto, agrupa la facturación informes por uno de los valores enumerados. Las tres claves que se relacionan con Las APIs de Google Maps Platform son goog-maps-api-key-suffix (las cuatro caracteres de una clave de API), goog-maps-platform-type (la plataforma: Android, iOS, JavaScript o servicio web), y goog-maps-channel (un valor numérico el valor del canal a partir de una consulta a la API). Obtén más información sobre el filtrado y la agrupación.

Puedes cambiar la vista del gráfico para excluir los créditos de uso específico borrando la casilla de verificación Incluir créditos en el costo en el panel derecho.

Supervisa y restringe el consumo

Para planificar tu presupuesto y controlar los costos, puedes hacer lo siguiente:

• Configura una alerta de presupuesto para hacer un seguimiento de cómo aumentan tus gastos en relación con un importe determinado. Configurar un presupuesto no limita el uso de la API; solo te alerta cuando tu gasto se acerca al importe especificado.

• Limita tu uso diario de la API para administrar el costo de uso de las API facturables. Si configuras límites para las solicitudes por día, puedes limitar tus gastos. Usa una ecuación simple para determinar tu límite diario según el importe que desees invertir. Por ejemplo: (gasto mensual /precio por cada SKU)/30 = límite de solicitudes por día (para una API).

  Nota: Tu implementación puede usar varias APIs facturables, por lo que debes ajustar tu ecuación según sea necesario. Recuerda que un plan de USD 200 de Google Maps Platform de crédito está disponible cada mes, así que asegúrate de incluir eso en tu cálculo.

Seguimiento de uso por canal

Para realizar un seguimiento de tu uso a través de canales numéricos, debes agregar el parámetro "channel" a tus solicitudes a la API. Los únicos valores aceptables de canal son números del 0 al 999. Estos son algunos ejemplos:

• API de Geocoding Web Service

  https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY&channel=1

• API de Maps JavaScript

  <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap"
  async defer></script>

Supervisa tu uso de los distintos canales directamente en tu informe de facturación. Los canales se verán en la sección Etiquetas (Labels) como la clave goog-maps-channel.

Nota: Los datos del canal no están disponibles para el SDK de Maps para Android. SDK de Maps para iOS, API de Places (nueva), API de Address Validation, API de Aerial View, API de Air Quality, API de Map Tiles y API de Maps Datasets, API de Roads, las APIs de Routes, la API de Pollen, la API de Solar y API de Route Optimization.

Figura 4: Filtrar por SKU y canales

Para filtrar tu informe de facturación por SKU y canal, haz lo siguiente:

1. Utiliza el filtro de SKU Agrupar por (Group by).
2. Selecciona el signo de intercalación de Etiquetas (Labels).
3. Selecciona el menú desplegable Clave (Key) y, luego, goog-maps-channel.
4. Selecciona el menú desplegable Valor (Value) y elige los canales numéricos que deseas filtrar.

Agrupa los datos por clave de etiqueta goog-maps-channel si quieres ver el costo generado en cada canal.

Una vez que implementes los datos de uso del canal en tus solicitudes, puede haber un retraso breve (hasta 24 horas) antes de que estos se reflejen en tu informe de facturación.

Exporta tus datos de facturación con BigQuery

También puedes exportar tus datos de facturación a BigQuery.

BigQuery Export te permite exportar datos de Facturación de Cloud detallados (como datos de uso y estimación de costos) automáticamente durante el día al conjunto de datos de BigQuery que especifiques. Luego, puedes acceder a tus datos de facturación desde BigQuery para realizar un análisis detallado. Esto proporciona un nivel adicional de detalle para comprender cómo se origina tu uso de Google Maps Platform.

Si quieres comenzar a usar las exportaciones de BigQuery y consultar los datos, puedes probar la siguiente consulta de muestra. Antes de ejecutar esta consulta, debes hacer lo siguiente:

• Habilita la facturación y la exportación de facturación de BigQuery en tu cuenta.
• El formato de la tabla es PROJECT_ID.DATASET_NAME.gcp_billing_exportv1BILLING_ACCOUNT_ID, donde:
• PROJECT_ID es el ID del proyecto real (p. ej., “my-project-123456”).
• DATASET_NAME es el nombre del conjunto de datos que creaste (p. ej., "SampleDataSet").
• BILLING_ACCOUNT_ID es una referencia del ID de tu cuenta de facturación, con el prefijo "gcp_billing_exportv1" y el cambio de los guiones medios (-) a guiones bajos (_). Por ejemplo, el ID de la cuenta de facturación 123456-7890AB-CDEF01 pasaría a ser gcp_billing_export_v1_123456_789AB_CDEF01

Nota: Cuando creas un nuevo conjunto de datos, este aparecerá en la interfaz de inmediato. En cambio, la tabla para consultar no, ya que se generará automáticamente después de unas horas. Demorará alrededor de 24 horas que puedas ver tus datos. Tu conjunto de datos de BigQuery solo refleja los datos de uso y costos generados a partir de la fecha en que configuraste la exportación de facturación. En otras palabras, los datos de facturación no se agregan de forma retroactiva, por lo que no verás datos de facturación anteriores a la fecha en que habilitaste las exportaciones de BigQuery.

  #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
  

Recursos relacionados

Facturación de Cloud:

• Crea, modifica o cierra la cuenta de Facturación de Cloud
• Modifica la configuración de facturación de un proyecto
• Consulta los informes de facturación y las tendencias de costos
• Configura presupuestos y alertas de presupuesto
• Limitar el uso de API

Google Maps Platform:

• Facturación de Google Maps Platform
• Guía de optimización
• Prácticas recomendadas relacionadas con las claves de API

Informes y estado de respuesta

En la siguiente tabla, se muestra la correspondencia entre el estado de la API de Google Maps, el código de respuesta HTTP que se muestra en las respuestas de la API de Google Maps y la clase de código de respuesta HTTP en el Informe de uso, y se indica si la solicitud correspondiente aparece en los informes de uso, cuota y facturación.

Nota: Por razones históricas, el código de respuesta HTTP que se muestra para las solicitudes a la API de Google Maps Platform puede ser diferente del código de respuesta HTTP de los informes de uso (Métricas de Google Maps Platform). Las métricas de los informes de uso utilizan un conjunto de valores de código de respuesta que son coherentes con los que se usan en las APIs más nuevas. Esto mejora la observabilidad del uso de APIs en Métricas de Google Maps Platform y en Monitoring de Google Maps Platform.

El Informe de uso de Métricas de Google Maps Platform proporciona el nivel de detalle correspondiente a HTTP response code class. Si necesitas un mayor nivel de detalle, consulta los códigos de estado de la respuesta disponibles en la supervisión del uso de Google Maps Platform.

Códigos de respuesta que se muestran en las respuestas de la API de Google Maps		Disponible en el Informe de uso	Informado a
Estado de la API de Google Maps	Código de respuesta HTTP	Clase de código de respuesta HTTP	Uso	Cuota	Facturación
OK	200, 204, 302	2xx, 3xx	Sí	Sí	Sí
DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS	200, [404]	4xx^1	Sí	Sí	Sí
INVALID_REQUEST (valor del parámetro no válido), MAX_ROUTE_LENGTH_EXCEEDED, MAX_WAYPOINTS_EXCEEDED, etcétera	200, 400	4xx	Sí	Sí	Sí
INVALID_REQUEST (parámetro no válido o faltante, error de análisis de la solicitud)	200, 400	4xx	Sí	No	No
REQUEST_DENIED	200, 400 ( ) [403]	4xx^1	Sí	No	No
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded	200, 403, 429	4xx^1	Sí	No	No
UNKNOWN_ERROR	200, 500 503	5xx^1	Sí	Sí	No
^1 Para mejorar la coherencia de los informes de código de error, las APIs de Google Maps Platform están migrando de la siguiente forma: 1) de la clase de código de respuesta HTTP 2xx a 4xx para los estados de la API de Google Maps: DATA_NOT_AVAILABLE, NOT_FOUND y ZERO_RESULTS (estado relacionado); 2) de la clase de código de respuesta HTTP 2xx a 4xx para los estados de la API de Google Maps: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded y userRateLimitExceeded, y 3) de la clase de código de respuesta HTTP 2xx a 5xx para el estado de la API de Google Maps: UNKNOWN_ERROR. Puedes ver ambos códigos de respuesta durante el período de transición. Los códigos de respuesta que se muestran en las respuestas de la API de Google Maps no cambiarán. Puedes ver qué código de respuesta exacto aumenta en el Explorador de métricas para confirmar si un aumento de 4xx o de 5xx en las Métricas de Google Maps Platform está relacionado con esta migración (más información sobre el uso de Google Cloud Monitoring para Google Maps Platform).

Informes de participación

Este producto o función está en versión experimental (fase previa a la DG). Los productos y las funciones que se encuentran en la fase previa a la DG pueden tener asistencia limitada, y los cambios en estos productos y funciones podrían no ser compatibles con otras versiones de la fase previa a la DG. Las ofertas que se encuentran en la fase previa a la DG se rigen por las Condiciones Específicas del Servicio de Google Maps Platform. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Información empresarial

Google Maps Platform te ofrece estadísticas sobre cómo interactúan los usuarios con tus mapas. Estas estadísticas incluyen métricas de participación clave, como las vistas en un mapa o las interacciones con un lugar de interés. Puedes analizar esta información para descubrir ubicaciones populares donde enfocar tus iniciativas de publicidad y marketing, o bien para optimizar la experiencia del usuario.

Entre las funciones de los informes de estadísticas empresariales, se incluyen las siguientes:

• Ver un resumen general de las estadísticas empresariales para consultar rápidamente las tendencias clave relacionadas
• Desglosar una métrica específica en la consola para analizarla a fondo y poder comprenderla en más detalle
• Exportar las métricas a un archivo CSV para analizar las estadísticas empresariales en tu herramienta favorita para tales fines

Entre las métricas de participación disponibles, se incluyen las siguientes:

• Vistas de mapa: Haz un seguimiento de las vistas de mapa que se generan cuando los usuarios se desplazan lateralmente por un mapa, hacen zoom en él o lo inclinan. Las vistas de mapa se procesan semanalmente (de domingo a sábado, hora del Pacífico) por código postal. Los datos nuevos se publican todas las semanas, el primer miércoles posterior al período de observación.

Los usuarios pueden ver las estadísticas empresariales en la página Métricas de la consola de Cloud. El proyecto debe Tener habilitada la API de Maps JavaScript

Puedes analizar las métricas de participación de manera más detallada directamente en la consola con las funciones Filtrar y Agrupar por. Por ejemplo, podrías optar por filtrar una región específica para conocer las tendencias de las vistas de mapa correspondientes únicamente a los códigos postales de esa región. Por otro lado, es posible que desees agrupar los mapas de una región específica para agregar las interacciones que ocurrieron allí.

Los usuarios pueden exportar todo el conjunto de datos o una vista filtrada a un archivo CSV para analizar la información más a fondo en su herramienta favorita de análisis de estadísticas empresariales. Puedes descargar los datos de hasta 90 días a la vez, pero las descargas con más de 60,000 celdas se truncarán. Exportar los datos de las vistas de mapa a un archivo CSV puede llevar unos minutos según el período seleccionado.

Las métricas de estadísticas empresariales se anonimizan, por lo que solo reflejan las tendencias generales de interacción con tus mapas. Es posible que las cifras bajas se redondeen a cero y que las contribuciones de valores atípicos se reduzcan.

Puedes controlar el acceso a las estadísticas empresariales de tu proyecto de Cloud en la consola de Google Cloud con el permiso de Maps Analytics. Los propietarios del proyecto tienen este permiso de forma predeterminada y pueden otorgar acceso a otros usuarios según sea necesario.

Las estadísticas empresariales no deben utilizarse para estimar los costos de uso. Consulta los informes de uso para obtener más información sobre el uso.

Locator Plus

Si eres usuario de Locator Plus, un panel de análisis te permite examinar los datos y generar estadísticas a partir de ellos para tener una idea clara de cómo los compradores interactúan con tu localizador de tiendas. Puedes medir tu rendimiento semana tras semana, incluida la cantidad de vistas, la cantidad de interacciones con la Búsqueda y Place Details, y la tasa de participación general. Además, el panel proporciona comparativas importantes que te permiten ver cómo se posiciona tu implementación respecto de otras tiendas.

• Ve a Locator Plus en la consola de Google Cloud.
• Ve a la sección Informes de participación en la consola de Google Cloud para ver el panel de estadísticas.

El informe de comparativas te permite comparar tus datos con los datos agregados de la industria correspondientes a otras empresas que comparten sus datos. La comparación proporciona un contexto valioso, lo que te ayuda a establecer objetivos significativos, obtener estadísticas sobre las tendencias de la industria y conocer tu rendimiento en comparación con la competencia.

Para ver los datos de comparativas, tus datos de participación se incluyen de forma anónima en las comparativas de Google. Si deseas inhabilitar la visualización de los informes de comparativas y que tus datos se incluyan en ellos de forma anónima, envía un ticket de asistencia. Por lo general, el ticket de asistencia se resolverá en un plazo de 3 días.