Informes de Google Maps Platform

La sección Informes de Google Maps Platform proporciona un conjunto de informes visuales predefinidos que te permiten ver con facilidad el uso básico de las API, la cuota y los datos de facturación en Google Cloud Console. Puedes determinar rápidamente la cantidad de llamadas a las API, ver qué tan cerca estás de alcanzar las cuotas de uso de las 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 API 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.

Consulta Informes y estado de respuesta abajo para ver una lista completa de los estados y códigos de respuesta que definen si una solicitud aparece en los informes de Uso, Cuota o Facturación.

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

Informes de uso

El uso se basa en la cantidad de solicitudes que se realizan en tu proyecto a las API de Google Maps Platform con las credenciales asociadas a tu proyecto. Se contabilizan las solicitudes exitosas, las que generan errores de servidor y las que generan errores de cliente. Las credenciales incluyen las claves de API y los ID de cliente (para el plan Premium y los proyectos migrados del plan Premium).

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:

  • Las métricas de uso de todas las API se pueden filtrar por período y API. También puedes ver los datos de tráfico, error y latencia agrupados por código de respuesta, API y credencial.
  • Las métricas de uso de una API específica se pueden filtrar por período y las versiones, credenciales y métodos de la API. También puedes ver los datos de tráfico, error y latencia agrupados por código de respuesta, método y versión de la API y credencial.

Página Panel de API y servicios

La página Panel de API y servicios proporciona una descripción general de las métricas de uso correspondientes a todas las API habilitadas para tu proyecto (tanto las API de Google Maps Platform como otras API y servicios).

La página Panel presenta tres gráficos y una tabla. Puedes seleccionar un período (desde 1 hora hasta los últimos 30 días) para filtrar el uso que se muestra en los gráficos y las tablas.

En el gráfico Tráfico, se muestra el uso en consultas por segundo (QPS) de cada API. El gráfico Errores 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 API 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.

supervisión de las api

Para acceder a la página Panel de API y servicios, siga estos pasos:

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

    Página del selector de proyectos

  2. Selecciona tu proyecto. Aparecerá la página del panel API y servicios.

    Si no aparece la página, selecciona el botón de menú menú y, luego, API y servicios.

Si deseas obtener más información, consulta el artículo 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.

Captura de pantalla de un gráfico de descripción general que muestra una tabla con las API habilitadas y las solicitudes a la API durante los últimos 30 días.

Sigue estos pasos para acceder a la página Descripción general de Google Maps Platform:

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

    Ir a la página de Google Maps Platform

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

Página API de Google Maps Platform

En la página API de Google Maps, se incluyen dos tablas. En la tabla API habilitadas (Enabled APIs), se muestra la cantidad de solicitudes, la cantidad de errores y la latencia promedio en los últimos 30 días de cada API habilitada. En la tabla API adicionales (Additional APIs) se enumeran las API que no se habilitaron.

api

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

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

    Ir a la página de Google Maps Platform

  2. En el menú de la izquierda, selecciona API.

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 que se ven en los gráficos se pueden agrupar por código de respuesta, API, método de API o credencial.

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 de la parte superior y las opciones de filtrado en el panel derecho, puedes filtrar las métricas de uso que se muestran mediante la selección de una o varias API, credenciales, códigos de respuesta o plataformas. 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.

La página Métricas muestra tres gráficos: Tráfico (Traffic), Errores (Errors) y Mediana de latencia (Median Latency).

El filtro de plataforma aparece únicamente cuando hay seleccionada una sola API.

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

    Ir a la página de Google Maps Platform

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

Gráficos del código de respuesta

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

Estado de respuesta Clase del código de respuesta
(2xx, 3xx, 4xx, 5xx)
Notas
OK 2xx Respuesta correcta.

Esta es una solicitud facturable y consumirá parte de la cuota disponible.
OK 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 2xx Respuesta correcta que indica que no hay datos disponibles para las ubicaciones de entrada.

Esta es una solicitud facturable y consumirá parte de la cuota disponible.
ZERO_RESULTS 2xx La respuesta correcta no mostró ningún resultado.

Esta es una solicitud facturable y consumirá parte de la cuota disponible.
NOT_FOUND 2xx Para la API de Directions, esto indica que no se pudo geocodificar al menos una de las ubicaciones especificadas en el origen, el destino o los puntos de referencia de la solicitud.

Para la API de Places, esto indica que la ubicación indicada (place_id) no se encontró 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, etcétera.
2xx Ocurrió un error debido a un valor del parámetro no válido, se proporcionaron demasiados valores, etc. 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 del cliente debido a un error de autenticación, de acceso, etc. 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. Vuelve a enviar la solicitud más tarde. Consulta la respuesta de la API para obtener más detalles.
INVALID_REQUEST (parámetro no válido, parámetro faltante, error de análisis de la solicitud) 4xx Error del cliente debido a una solicitud no válida. Consulta la respuesta de la API para obtener más detalles.
NOT_FOUND (404) 4xx Para la API de Geolocation, esto indica que no se pudo obtener una estimación de la ubicación a partir de las entradas proporcionadas.

Para la API de Roads, esto indica que las entradas no se pudieron ajustar a las rutas de manera razonable.

Esta es una solicitud facturable y consumirá parte de la cuota disponible.
UNKNOWN_ERROR 5xx Error de servidor que indica que no se puede procesar la solicitud: error interno, sobrecarga del servicio, no disponible, tiempo de espera agotado, etcétera.

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

Parámetro de soluciones de Google Maps Platform

Google Maps Platform proporciona muchos tipos de códigos de muestra para ayudarte a comenzar rápidamente. Por ejemplo, puedes usar la Herramienta de creación rápida en Cloud Console, seguir las guías de implementación de soluciones de la industria y aprender con los Codelabs.

A fin de comprender el uso y las formas de mejorar nuestras soluciones, Google incluye el parámetro de búsqueda 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.
  • Si deseas inhabilitarlo, puedes borrar el parámetro de consulta solution_channel y su valor del código de muestra.
  • No es necesario mantener el parámetro. Quitar el parámetro de búsqueda no afectará 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 búsqueda es independiente de las estadísticas y los informes específicos de la API. Esto significa que quitar el parámetro del código de muestra de la solución no inhabilitará los informes internos de la API de Maps JavaScript.

Informes sobre la cuota

La cuota limita la cantidad de solicitudes que puede hacer tu proyecto a las API de Google Maps Platform. Las solicitudes se pueden limitar de tres maneras: por día, por minuto y por usuario, por minuto. De la cuota, se descuentan solo las solicitudes exitosas y las que causan errores de servidor. Las solicitudes en las que falla la autenticación no se descuentan de la cuota.

El uso de la cuota se muestra en gráficos de la página Cuotas en Cloud Console y se puede 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.

Usa esta calculadora para obtener el valor de tu cuota por minuto para cualquier producto de la API de GMP.

Página Cuotas de Google Maps

La página Cuotas 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 Google Cloud Console muestra el tráfico total de tus ID de cliente y claves de API. El tráfico de los ID de cliente también está disponible en el gráfico de métricas en Cloud Console.

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 (errores de autenticación, autorización y argumento no válido [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 API de Google Maps Platform (API de Maps Static, API de Street View Static, API de Geocoding, API de Directions, API de Places, API de Time Zone, API de Geolocation y API de Elevation). Sin embargo, existen 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.
  • Para el SDK de Maps para Android y el SDK de Maps para iOS, la unidad de cuota es una solicitud de Street View/carga de panorámica (las cargas de mapas son sin cargo y no consumen la cuota disponible).

Captura de pantalla de la página Cuotas (Quotas) de Maps en Google Cloud Console. Muestra las cuotas por API con un selector y, luego, muestra las cargas de mapa en relación con las cuotas establecidas para la API en cuestión.

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

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

    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 la siguiente tabla, se muestra la unidad de cuota para las API 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 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 Directions 1 solicitud
API de Distance Matrix 1 elemento (par de origen y destino)
API de Roads 1 solicitud
Places
API de Places 1 solicitud
API de Geocoding 1 solicitud
API de Geolocation 1 solicitud
API de Time Zone 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 están disponibles en Google Cloud Console (consulta Facturación).

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

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

    Página del selector de proyectos

  2. Selecciona un proyecto.
  3. Selecciona el botón de menú 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. En la vista predeterminada, se muestran los costos diarios del mes actual específicos de cada uso, agrupados por proyecto (para todos los productos), incluidos los créditos aplicados específicos de cada uso, así como el costo previsto total para todo el mes actual. 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.

Captura de pantalla del informe de facturación que muestra el gráfico y la tabla con la vista predeterminada
Figura 1: El informe de facturación muestra el gráfico y la tabla 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 prepagos y cómo afecta a tu implementación, consulta el uso y el costo por SKU.

Informe de facturación agrupado por SKU
Figura 2: La tabla del informe de facturación muestra el uso y las líneas de pedido con el costo y el uso de cada SKU.
Captura de pantalla de los filtros del informe de facturación
Figura 3: Filtros del informe de facturación.
Para cambiar la vista del informe a fin de mostrar las líneas de pedido 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 del informe de facturación disponibles incluyen Intervalo de tiempo (Time range), Proyectos (Projects), Productos (Products), SKU y Ubicaciones (Locations), que permiten filtrar por desde dónde se entregan las solicitudes a la API.

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

Puedes cambiar la vista del gráfico a fin de excluir los créditos específicos de usos determinados si desmarcas la casilla de verificación Include credits in cost en el panel de la derecha.

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). Ten en cuenta que tu implementación puede usar varias API facturables, por lo que debes ajustar tu ecuación según sea necesario. Recuerda que hay disponible un crédito mensual de USD 200 en Google Maps Platform. Por lo tanto, asegúrate de incluir dicho importe 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. A continuación, se incluyen 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.

Filtrar por etiquetas
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 los datos 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 se convertirá en 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
  

Facturación de Cloud:

Google Maps Platform:

Informes y estado de respuesta

En la siguiente tabla, se muestra el estado y la clase del código de respuesta y se indica si la solicitud correspondiente aparece en los informes de uso, cuota o facturación.

Estado de respuesta Clase del código de respuesta
(2xx, 3xx, 4xx, 5xx)
Informe de uso Informe de cuota Informe de facturación
OK 2xx,
3xx
ZERO_RESULTS,
DATA_NOT_AVAILABLE,
NOT_FOUND
2xx
INVALID_REQUEST (valor del parámetro no válido),
MAX_WAYPOINTS_EXCEEDED,
MAX_ROUTE_LENGTH_EXCEEDED,
etcétera.
2xx
REQUEST_DENIED 4xx No No
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
dailyLimitExceeded,
rateLimitExceeded,
userRateLimitExceeded
4xx No No
INVALID_REQUEST (parámetro no válido, error de análisis de la solicitud) 4xx No No
NOT_FOUND (API de Geolocation y Roads) 4xx
UNKNOWN_ERROR 5xx No