Informes de uso del plan premium

Nota: El plan premium de Google Maps Platform ya no está disponible para registros o clientes nuevos.

Esta página es solo para los clientes que tienen la versión nueva del plan premium de Google Maps Platform, que está disponible desde enero de 2016.

¿Tienes el plan premium o una licencia anterior?
Para determinar qué licencia tienes, haz lo siguiente:
> En el Portal de asistencia de Google Cloud, haz clic en Maps: Informe de uso a la izquierda.
> ¿El ID que aparece en la parte superior del informe tiene el siguiente formato?
   gme-[company] & proj-[number] ([type])
Si es así, tienes el plan Premium.
De lo contrario, tienes una licencia anterior (Maps API for Work o Maps API for Business).

Descripción general

Como cliente del plan premium, puedes usar la herramienta Informes de uso de Google Maps para realizar un seguimiento del uso que hace tu aplicación del servicio de Google Maps Platform y su consumo de créditos de las API de Google Maps. Con la herramienta, puedes ver informes diarios o mensuales en los que se detallen todas las API que se incluyen con tu plan premium de Google Maps Platform. Los datos del informe están disponibles para las solicitudes a la API que incluyan un ID de cliente o un ID de proyecto.

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

Tipos de informes

Informe de solicitudes exitosas

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

  • Errores de solicitud: Para cada API, en el informe diario también se muestra la cantidad de solicitudes exitosas y fallidas (errores); para las API de servicio web, a las que accede tu aplicación con un ID de cliente, en el informe también se muestran códigos de error que son útiles a fin de solucionar problemas.
  • Datos del 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 a la API de tu aplicación en diferentes aplicaciones que usen el mismo ID de cliente (como acceso externo o interno). Al usar canales, puedes generar informes con datos más detallados sobre la manera en que se usa tu aplicación.

Informe de créditos de las API de Google Maps

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 los Índices y límites de uso.

Funciones del informe

  • Gráficos fáciles de leer: Los informes diarios proporcionan gráficos que te permiten visualizar las tendencias de uso en el tiempo. Para consultar los detalles del informe, coloca el cursor sobre el gráfico.

  • Datos históricos: Puedes ver informes de cualquier período del último año.
  • Datos descargables: Descarga solicitudes mensuales y totales de créditos en un archivo de valores separados por comas (CSV) para un análisis más profundo a través de una hoja de cálculo o herramientas de inteligencia empresarial, o bien para compartir los datos con otros.
  • Desglose de datos: Accede a los informes diarios directamente desde los informes mensuales. Para ello, haz clic en los totales mensuales o en los encabezados de columnas del informe. Por ejemplo:

Cómo acceder a los informes de uso

Para acceder a los informes de uso de Google Maps, sigue estos pasos:

  1. Accede al Portal de asistencia de Google Cloud.
  2. En el panel izquierdo, haz clic en Maps: Informe de uso.

Cómo generar informes

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

Filtro Descripción
ID de cliente
Está disponible solo si tienes varios ID de cliente. Selecciona el ID de cliente del cual desees ver informes.
ID de canal
Está disponible solo para informes de solicitudes exitosas. Selecciona un canal para el que desees ver datos de uso. O selecciona Mostrar todo para ver los datos de uso de todos los canales.
Desde/hasta Selecciona un período de hasta 1 año para el informe. Haz clic en Actualizar para generar un informe nuevo.
Tipo de informe
Selecciona el informe de Solicitudes exitosas o Créditos de las API de Google Maps.
Selecciona el nivel de detalle del período Elige si desea generar un informe Mensual o Diario. Los informes mensuales también contienen vínculos a informes diarios. En los informes diarios, se muestran las solicitudes exitosas y fallidas, y los códigos de error.
Tipo de API Se encuentra disponible solo para los informes diarios. Selecciona la API de la cual desees ver un informe.

Preguntas frecuentes

Informe de solicitudes exitosas

¿Cuánto tardarán en aparecer los datos de uso en los informes?

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

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

Con el plan premium de Google Maps Platform, el uso de la API de Maps para JavaScript se determina mediante las cargas de mapa, es decir, cuando los mapas realmente se muestran en una página. Las cargas de mapa difieren de las páginas vistas, que se usan para calcular el uso de la API de Maps para JavaScript con las licencias anteriores de Maps API for Business o Maps API for Work. Para obtener más información, consulta los Índices y límites de uso.

¿Por qué la cantidad de cargas de mapa no coincide con las estadísticas de acceso en nuestros servidores web?

A continuación, se incluyen algunos motivos por los que la cantidad de cargas de mapa puede diferir de la cantidad de hits 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. Cuando compares los informes de cargas de mapa con las estadísticas de acceso de tu servidor web, analiza detenidamente el uso de mapas en cada una de tus páginas web a fin de encontrar las causas de las discrepancias. Por ejemplo:
    • Una página tiene más de un mapa, de modo que se crean varios objetos de mapa.
    • En una página no se muestra un mapa, pero de todos modos se crea el objeto de mapa. Esto puede ocurrir, por ejemplo, si el objeto de mapa se adjunta 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 el usuario no realiza la acción, no se crea un objeto de mapa.
    • Una página no tiene mapas, de modo que no se crea el objeto de mapa.
  • Las zonas horarias son diferentes: Los informes se generan a partir de registros establecidos en la zona horaria del Pacífico. Puedes analizar los registros de tu servidor según la zona horaria del Pacífico para reducir cualquier desplazamiento generado al acceder en tu zona horaria local.
  • El archivo HTML está almacenado 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 ese caso, el navegador puede cargar el HTML desde la caché, lo cual hace que la cantidad de cargas de mapa sea mayor que la cantidad de hits en los registros de tu servidor.
¿Por qué la cantidad de solicitudes es superior a la esperada para la API de Distance Matrix?

En el informe de la API de Distance Matrix se muestra la cantidad de elementos (pares de origen-destino) en lugar de las solicitudes. Para obtener detalles sobre los elementos, consulta la Guía para desarrolladores.

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 Tipos de API. Verás un gráfico y una tabla que muestran la cantidad de solicitudes exitosas y fallidas que realizó tu aplicación; para las API de servicio web a las que accede tu aplicación con 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 informes de uso muestra los códigos de estado de las API de servicios web a las que accede tu aplicación con un ID de cliente. Puedes encontrar descripciones de los códigos en la Guía para desarrolladores de cada API:

La API de Geolocation, la API de Places y la API de Roads siempre requieren una clave de API. Para estas y otras API a las que tu aplicación accede con una clave, consulta los códigos de estado en tu Developers Console.

¿Los errores consumen créditos de la API de Google Maps?

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í consumen créditos.

Datos de canales

¿Qué son los canales?

Para realizar un seguimiento del uso en diferentes aplicaciones que usan el mismo ID de cliente o clave de API, puedes utilizar el parámetro channel con las solicitudes a la API. Si especificas diferentes valores channel para distintos aspectos 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 con un channel establecido en customer, mientras que tu departamento de marketing interno puede usar un channel establecido en mkting. En tus informes se mostrará un desglose del uso de la API conforme a esos valores de canal.

¿Qué API admiten canales?

Los informes de canal se encuentran disponibles para las aplicaciones que usan la API de Maps para JavaScript, la API de Maps Static, la API de Street View Static y los servicios web de Google Maps Platform. Los canales no están disponibles para la API de Geolocation, la API de Places, la API de Roads ni los SDK de Maps para dispositivos móviles.

¿Cuántos canales puedo usar?

Puedes usar hasta 2,000 canales diferentes por ID de cliente o clave de API.

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

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

  • Debe ser una string ASCII alfanumérica.
  • Puede incluir caracteres como un guion bajo (_) o guion medio (-).
  • Debe admitir la distinción entre mayúsculas y minúsculas: Los parámetros channel en mayúsculas sostenidas 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 del 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 del canal para realizar un seguimiento de usuarios individuales.

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

API del cliente

Adjunta el parámetro del canal al valor src de tu etiqueta de secuencia de comandos:

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

API de Maps Static y Street View Static

Incluye este parámetro de canal 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 de canal 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 las API de Google Maps

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

Las solicitudes que tu aplicación realiza a las API consumen créditos de las API de Google Maps de un conjunto de créditos que adquieres con tu plan premium de Google Maps Platform. Para obtener más información sobre los créditos y cómo los consume tu aplicación, consulta los Índices y límites de uso.

¿Cuánto tardarán en aparecer los datos de créditos en los informes?

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