Informes de uso de Google Maps

Esta página es solo para clientes que tengan la nueva versión de la Google Maps APIs Premium Plan, disponible desde enero de 2016.

¿Tienes una licencia anterior de Maps APIs for Work o de Maps API for Business? Consulta nuestra guía sobre licencias de Maps APIs for Work. Para determinar si tienes una licencia anterior: en el Google Cloud Support Portal, haz clic en Maps: Usage Report a la izquierda. Si el ID de la parte superior del informe se encuentra en el siguiente formato, contarás con el nuevo Premium Plan:
gme-[empresa] & proj-[número] ([tipo])
. De lo contrario, tu licencia será más antigua.

Información general

La herramienta de informes de uso de Google Maps te permite realizar un seguimiento del uso de Google Maps APIs de tu aplicación y su consumo de créditos de Maps API. Con ella, puedes ver informes diarios o mensuales en los que se detallen todas las API que se incluyan con tu Google Maps APIs Premium Plan. Los datos del informe está disponibles para solicitudes de API que incluyan un ID de cliente o proyecto.

Nota: La herramienta de informes de uso proporciona la misma información que Google emplea a fin de determinar el uso de tu aplicación para facturación.

Tipos de informes

Informes de solicitudes exitosas

En este informe se muestra el total de solicitudes por día o mes de tu aplicación para cada API. Usa este informe para comparar el uso entre diferentes períodos e identificar tendencias y períodos de picos de uso. Además, puedes usar el informe de solicitudes exitosas para ver los siguientes datos:

  • Errores de solicitud: para cada API, en el informe diario también se muestra el número de solicitudes exitosas y fallidas (errores); para las Web Service API, a las que accede tu aplicación usando un ID de cliente, en el informe también se muestran códigos de error que son útiles para solucionar problemas.
  • Datos de canal: Si incluyes el parámetro de canal en tus solicitudes, puedes generar un informe de solicitudes exitosas que muestre un desglose de las solicitudes de API de tu aplicación en diferentes aplicaciones que usen el mismo ID de cliente (como acceso externo e interno). Al usar canales, puedes generar informes con datos más detallados sobre el modo en que se usa tu aplicación.

Informe de créditos de Maps API

En este informe, se muestra el consumo total de créditos de tu aplicación por día o mes para todas las API combinadas. Usa este informe para determinar la cantidad de créditos que adquirirás. Para obtener información sobre cómo consume créditos tu aplicación, consulta Índices y límites de uso.

Funciones del informe

  • Gráficos de lectura sencilla: los informes diarios proporcionan gráficos que te permiten visualizar las tendencias de uso en el tiempo. Puedes ver información detallada del informe desplazando el puntero sobre el gráfico.

  • Datos históricos: puedes ver informes para cualquier período del año anterior.
  • Datos descargables: descarga solicitudes mensuales y totales de créditos en un archivo de valores (CSV) separados por comas para un análisis más profundo a través de una hoja de cálculo o herramientas de inteligencia empresarial, o para compartir los datos con otros.
  • Exploración de datos: accede a los informes diarios de manera directa desde informes mensuales haciendo hacer clic en los totales mensuales o los encabezados de columnas de estos. Por ejemplo:

    <img src="/maps/premium/reports/images/usage_rep_mo_total.png" width="200px" /" style="float: left; width: 30%; margin-right: 1%; margin-bottom: 0.5em;"><img src="/maps/premium/reports/images/usage_rep_mo_heading.png" width="200px" /" style="float: left; width: 30%; margin-right: 1%; margin-bottom: 0.5em;">

Acceso a los informes de uso

Para acceder a los informes de uso de Google Maps:

  1. Accede al Google Cloud Support Portal.
  2. En el panel izquierdo, haz clic en Maps: Usage Report.

Generación de informes

El informe predeterminado es el informe de solicitudes mensuales exitosas de los últimos 12 meses. Para generar diferentes informes, usa los filtros de informe:

Filtro Descripción
ID de cliente
Disponible solo si tienes varios ID de cliente. Selecciona el ID de cliente del cual desees ver informes.
ID de canal
Disponible solo para informes de solicitudes exitosas. Selecciona un canal para el que desees ver datos de uso. Como alternativa, selecciona Show all para ver los datos de uso de todos los canales.
Desde/hasta Selecciona un período de hasta un año para el informe. Haz clic en Update para generar un informe nuevo.
Tipos de informes
Selecciona Successful Requests o el informe Maps APIs Credits.
Selecciona la granularidad del período Elige el informe Monthly o Daily. Los informes mensuales también contienen vínculos a informes diarios. En los informes diarios se muestran solicitudes exitosas y fallidas, y códigos de error.
Tipo de API Solo disponible para informes diarios. Selecciona la API de la cual desees ver un informe.

Preguntas frecuentes

Informe de solicitudes exitosas

¿Cuánto tiempo se necesitará para que los datos de uso se muestren en los informes?

Los datos de informes no están disponibles en tiempo real. Los datos de uso para solicitudes en las que se use un ID de cliente se procesan a diario. Debido a que las fechas de informes se basan en la hora estándar del Pacífico, puedes experimentar una demora de 1 o 2 días. Los datos de solicitudes en las que se usan claves de API exigen procesamiento adicional y pueden tardar hasta 3 días en aparecer en los informes.

¿Qué son las cargas de mapa de la Google Maps JavaScript API? ¿Cómo se diferencian de las vistas de página?

Con la Google Maps APIs Premium Plan, el uso de Google Maps JavaScript API se determina a través de cargas de mapa (es decir, cuando los mapas se muestran realmente en una página). Las cargas de mapa difieren de las vistas de página, empleadas para calcular el uso de la Maps JavaScript API con las licencias de la Maps API o la Maps APIs for Work anteriores. Para obtener más información, consulta Índices y límites de uso.

¿Por qué el número de cargas de mapa no coincide con las estadísticas de acceso en nuestros servidores web?

A continuación, te mostramos algunas razones por las cuales el número de cargas de mapa difiere del número de aciertos en la URL en cuestión en los registros de tu servidor web:

  • El uso de mapas puede variar en una página: se genera una carga de mapa cada vez que se crea el objeto google.maps.Map en una página. Al comparar los informes de cargas de mapa con las estadísticas de acceso de tu servidor web, analiza con cuidado el uso de mapas en cada una de tus páginas web para buscar causas de discrepancias. Por ejemplo:
    • Una página tiene más de un mapa, de modo que se crean varios objetos Map.
    • En una página no se muestra un mapa, pero de todos modos se crea el objeto Map. Esto puede ocurrir, por ejemplo, si el objeto Map se ajunta a un elemento HTML div oculto.
    • Una página exige que un usuario realice una acción (como hacer clic en un botón) para mostrar un mapa. Si un usuario no lo hace, no se crea un objeto Map.
    • Una página no tiene mapas, de modo que no se crea el objeto Map.
  • Las zonas horarias son diferentes: los informes derivan de registros establecidos en la zona horaria del Pacífico. Puedes analizar tus registros de servidor según la zona horaria del Pacífico para reducir cualquier desplazamiento generado al acceder a tu zona horaria local.
  • HTML se almacena en caché: las cargas de mapa no se almacenan en caché. Si un usuario vuelve a cargar tu página, esta recarga genera otra carga de mapa para obtener un token de sesión. Sin embargo, en este caso, el navegador puede cargar el HTML desde el caché, lo cual hace que el número de cargas de mapa sea mayor que el número de aciertos de los registros de tu servidor.
¿Por qué el número de solicitudes es superior al esperado para la Google Maps Distance Matrix API?

En el informe de la Google Maps Distance Matrix API se muestra el número de elementos (pares de origen-destino) en lugar de solicitudes. Para obtener información detallada sobre elementos, consulta la guía del desarrollador.

Errores de solicitud

¿Cómo puedo ver los errores de solicitud de mi aplicación?

Genera un informe diario de solicitudes exitosas y luego elige una API en la lista de tipos de API. Verás un gráfico y una tabla que muestra el número de solicitudes exitosas y fallidas que realizó tu aplicación; para las Web Service API a las que accede tu aplicación usando un ID de cliente, también verás los códigos de estado que muestran esas solicitudes:

¿Qué significan los códigos de estado?

La herramienta de los informes de uso muestra los códigos de estado de las Web Service API a las que tu aplicación accede usando un ID de cliente. Puedes encontrar descripciones de los códigos en la guía del desarrollador para cada API:

Las Geolocation API, Places API, y Roads API siempre exigen una clave de API. Para estas y otras API a las que accede tu aplicación con una clave, verifica tu Developers Console en busca de códigos de estado.

¿Los errores consumen créditos de Maps API?

No, las solicitudes que reciben un código de error no consumen créditos. Sin embargo, las solicitudes que reciben los códigos OK o ZERO_RESULTS sí lo hacen.

Datos de canales

¿Qué son los canales?

Para realizar un seguimiento de las diferentes aplicaciones empleando el mismo ID de cliente, puedes usar el parámetro channel con tus solicitudes de API. Especificando diferentes valores channel para aspectos diferentes de tu aplicación, puedes determinar con precisión la forma en que esta se usa.

Por ejemplo, tu sitio web externo puede acceder a una API usando un channel fijado en customer, mientras que tu departamento de marketing interno puede usar un channel fijado en mkting. En tus informes se mostrará un desglose del uso de la API conforme a esos valores del canal.

¿Qué API admiten canales?

Los informes de canal se encuentran disponibles para aplicaciones en cuales se usen la Maps JavaScript API, la Static Maps API, la Street View Image API y los servicios web de Google Maps APIs. Los canales no están disponibles para la Geolocation API, la Places API, la Roads API ni los Maps Mobile SDK.

¿Cuántos canales puedo usar?

Puedes usar hasta 2000 canales diferentes por ID de cliente.

¿Cómo puedo configurar canales para las solicitudes de mi aplicación?

Asegúrate de que el valor channel de tus solicitudes cumpla con los siguientes requisitos:

  • Debe ser una string ASCII alfanumérica.
  • Puede incluir caracteres como un punto (.), guión bajo (_) y guión medio (-).
  • Debe admitir la distinción entre mayúsculas y minúsculas: los parámetros channel en mayúsculas, y mayúsculas y minúsculas, se combinan para formar su equivalente en minúsculas. Por ejemplo, el uso en el canal CUSTOMER se combina con el uso en el canal customer.
  • Debe ser estático y se debe asignar por instancia de aplicación (no se puede generar de manera dinámica). Por ejemplo, no puedes usar los valores de canal para realizar un seguimiento de usuarios individuales.

Agrega el parámetro de canal a tus solicitudes, de la siguiente manera:

API de cliente

Adjunta el parámetro channel al valor src de tu etiqueta script:

<script src="https://maps.googleapis.com/maps/api/js?v=3
&client=gme-yourclientid
&channel=your_channel"></script>

Static Maps API y Street View API

Incluye este parámetro channel en la URL de la solicitud:

https://maps.googleapis.com/maps/api/staticmap
?center=15.800513,-47.91378
&zoom=11
&size=300x300
&client=gme-yourclientid
&channel=your_channel
&signature=your_signature

Servicios web

Incluye este parámetro channel en la URL de la solicitud:

https://maps.googleapis.com/maps/api/geocode/json
?address=101+Main+St
&client=gme-yourclientid
&channel=your_channel
&signature=your_signature

Informe de créditos de Maps API

¿Qué son los créditos de Maps API?

Las solicitudes que tu aplicación realiza a las API consumen créditos de las Maps API de un conjunto de créditos que adquieres con tu Google Maps APIs Premium Plan. Para obtener más información sobre los créditos y la manera en que tu aplicación los consume, consulta Índices y límites de uso.

¿Cuánto tiempo se necesitará para que los datos de créditos se muestren en los informes?

Los datos sobre consumo de créditos de los informes de uso de Google Maps requieren procesamiento y pueden tardar hasta 3 días en aparecer en los informes.