Antes de implementar un nuevo proyecto de Google Maps en producción, asegúrate de que la configuración sea correcta para pagar el importe correcto por los productos que usas. En este documento, abordamos los siguientes aspectos para asegurarnos de que tengas (i) transparencia en la facturación, para que se pueda verificar el uso antes de que se genere una factura y (ii) la configuración correcta del proyecto para garantizar que puedas usar nuestros productos.
Si bien este debería ser un proceso relativamente sencillo, los socios de Maps pueden trabajar contigo para garantizar que tus proyectos se transfieran correctamente.
Conceptos
En esta sección, queremos asegurarnos de que comprendes la información básica sobre la facturación de Google Maps y las diferentes configuraciones que pueden existir. No hay buenas o malas situaciones en muchas situaciones, depende del tipo de resultado que intentes lograr.
A lo largo de este documento, hablaremos mucho sobre tu proyecto de Google Cloud. Esto se debe a que los productos de Google Maps están disponibles a través de ella. Esto significa que la configuración que se describe en este documento se realiza en tu proyecto de Google Cloud.
Cuentas de facturación
En la actualidad, todas las empresas que usan productos de Google Maps tienen asociado un proyecto de Google Cloud. Este proyecto debe tener configurada una cuenta de facturación. La cuenta de facturación es responsable de acumular todo el uso de Google Maps y de crear una factura todos los meses en función de ese uso.
Para Movilidad, se aprovisiona una cuenta de facturación especial. Esta cuenta de facturación está diseñada para usarse solo con casos de uso relacionados con la movilidad, como transporte privado con conductor, entrega y logística.
Varios proyectos de Google Cloud o solo uno de ellos pueden usar una misma cuenta de facturación.
Proyecto único que apunta a la misma cuenta de facturación:
- Caso de uso específico (es decir, casos de uso de movilidad)
- Facturas separadas
- El descuento se realiza en función del volumen de este único proyecto.
Varios proyectos que apuntan a la misma cuenta de facturación:
- Mismo caso de uso
- Aprovecha los niveles de descuento si agregas uso
- Factura única
Para obtener información adicional sobre las cuentas de facturación y otros datos relevantes, consulta este vínculo.
Como se mencionó anteriormente, una sola cuenta de facturación puede apuntar a varios proyectos. Si tienes más de un proyecto, debes identificar cuáles usarán nuestros servicios de movilidad y dirigirlos a una cuenta de facturación de movilidad. Los proyectos que no tengan un caso de uso de movilidad asociado deben continuar apuntando a la cuenta de facturación normal de Google Maps Platform que usas en la actualidad. Para obtener una cuenta de facturación de movilidad, se debe firmar un acuerdo de movilidad con Google o a través de un socio. A continuación, puedes ver cómo una cuenta de facturación se ajusta a todo el esquema y las diferentes configuraciones posibles:
Recursos de Cloud, cuenta de facturación y generación de facturas
Hablando de precios, en Google Maps Platform hay diferentes niveles de descuentos, disponibles a través de los Socios de Maps o directamente con Google en algunos casos. Estos niveles están basados en el volumen, por lo que pagas menos cuanto más uses nuestros productos (los descuentos se aplican a cada SKU de forma individual). Nuestro sistema de facturación identifica tus proyectos según la credencial que usaste para llamar a nuestros productos. Puede ser una clave de API o una cuenta de servicio para algunas APIs de movilidad:
Claves de API
Las APIs de Google Maps Platform se autentican con una clave de API. Google identifica la cuenta de facturación del proyecto de Google Cloud correspondiente en función de esta clave de API, donde se producirá el consumo.
Ejemplo de una solicitud a la API de Geocoding:
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJeRpOeF67j4AR9ydy_PIzPuM&key=YOUR_API_KEY
JWT
Algunas APIs requieren un ID de proyecto de Google Cloud en la URL y usan un JWT para la autenticación. Por lo tanto, es importante asegurarse de que los sistemas correctos usen el método de autenticación correcto para garantizar que la facturación se realice de forma adecuada.
Ejemplo de una solicitud a la API de Fleet Engine:
curl -X GET \ https://fleetengine.googleapis.com/v1/providers/project_id/deliveryVehicles/vehicle-1234 \
-H 'authorization: Bearer eyJ0eXAiOi...' \
-H 'cache-control: no-cache' \
-H 'content-type: application/json' \
-d '{
"lastLocation": {
"location": {
"latitude": 37.432,
"longitude": -122.094
},
"updateTime": "2022-11-13T17:55:00Z"
}
}'
Costos
En Google Maps Platform, los costos se calculan en función del volumen de solicitudes a la API. En el caso de los servicios de movilidad, cobramos en función del volumen de transacciones de movilidad facturables, que son viajes o tareas completados correctamente (envío, no retiro). Esto se define antes de firmar el contrato. Si representas a una empresa de transporte compartido o entrega de comida, tu métrica de éxito es completar un viaje o una entrega. Este mapa se asigna a un Viaje. Las tareas se usan para las empresas de logística y los minoristas que deben entregar paquetes de forma correcta.
Reconocemos que los clientes de movilidad también usan los productos de Google Maps Platform para realizar sus viajes y entregas. Por lo tanto, si usas una cuenta de facturación de movilidad, puedes llamar a Google Maps Platform sin costo, siempre y cuando se respeten los límites predefinidos dentro del mismo caso de uso de movilidad.
Por ejemplo, si tienes una empresa de entrega de comida, por cada viaje exitoso que realices, puedes llamar a la API de Geocoding diez veces. Para obtener más información sobre estos límites, consulta los límites de uso en la documentación de movilidad. Cualquier cambio en los límites requiere una enmienda al contrato, así que trabaja con tu representante de Google o tu representante de socios para analizar tus necesidades específicas.
Al final del mes, se generará una factura en función de (i) la cantidad de viajes o tareas correctos que se informaron en el sistema y (ii) cualquier volumen de llamadas a la API de Google Maps Platform que exceda los límites preestablecidos (“excedentes”). Nuestros límites están alineados con lo que hemos considerado como necesario en el mercado.
Te sugerimos que leas con atención la documentación oficial sobre la facturación de movilidad, que puedes encontrar aquí.
Pruebas piloto y evaluación
Los clientes pueden ejecutar una prueba piloto pequeña (prueba de concepto, evaluación) de servicios de movilidad en una cuenta de facturación de Google Maps Platform durante un período limitado antes de firmar un contrato. Si deseas realizar una prueba piloto, habla con tu socio de Maps o tu contraparte de Google.
Como se mencionó, durante la fase piloto, no hay una cuenta de facturación de movilidad disponible porque aún no se firma el contrato. Esto significa que, cuando se utilicen los productos de Google Maps Platform, se cobrarán los productos, pero no así los productos específicos de movilidad. En otras palabras, esto significa que, durante la fase piloto, la facturación no se basa en tareas ni viajes, por lo que los límites de uso no se aplican durante esta fase.
Una vez que la prueba piloto se lance oficialmente a producción, se debe pagar según el contrato.
En síntesis:
Fase piloto o de desarrollo: Se te cobra solo por las APIs de Google Maps que están disponibles para el público. Las APIs y los SDKs que no están disponibles públicamente no generarán cargos hasta que se use una cuenta de facturación de movilidad en el proyecto. Ten en cuenta que Google ofrece USD 200 en créditos para las APIs de Google Maps Platform a cualquier cuenta de facturación nueva que se cree. Esto debería ser suficiente para un entorno controlado durante el período de evaluación.
Fase de producción: Se te cobra por viajes o tareas. Los costos asociados con Google Maps Platform solo se aplicarán si el uso supera los límites de uso (“límites”) del contrato. Si es así, pagarás por los excedentes. Los excedentes se cobran según se define aquí.
Cómo migrar a una cuenta de facturación de movilidad
Cuando migras a producción, por lo general, debes crear proyectos de Google Cloud adicionales para representar tus diferentes entornos, como QA (control de calidad) y producción. Antes de eso, probablemente tengas solo un es el entorno de desarrollo.
Requisitos
Una persona de tu lado que puede hacer lo siguiente:
- Administrar las cuentas de facturación en Google Cloud. Por lo general, el administrador de la cuenta de facturación o el propietario del proyecto realiza esta acción.
- Acceso al nuevo ID de la cuenta de facturación que se incluyó en la carta de bienvenida que se generó después de que se firmó el contrato.
- Acceso al proyecto de Google Cloud correspondiente al entorno de producción en el que se informarán los viajes o las tareas.
Sigue estos pasos para configurar proyectos nuevos y la facturación de ellos.
Configuración de un proyecto nuevo
Creación de proyectos
- [Tú] Creas un proyecto de GCP nuevo en la consola de Google Cloud para cada entorno nuevo. Por ejemplo, producción, etapa de pruebas y control de calidad.
- [Socio o equipo de Google] Agrega proyectos nuevos a una lista de entidades permitidas para tener acceso a los productos de movilidad. Trabaja con tu representante de ventas de Google Socio y proporciona el ID del proyecto creado en el paso anterior.
- [Tú] Actualizas los Contactos esenciales en tus proyectos. Este paso es muy importante para garantizar que los equipos de asistencia de Google puedan comunicarse con las personas adecuadas para tu proyecto si fuera necesario.
Configuración de proyectos
Completa los siguientes pasos del proyecto en la consola de Google Cloud creado en los pasos anteriores:
[Tú] Creas cuentas de servicio, incluida la asociación de los roles correctos de administración de identidades y accesos (IAM) de movilidad (basados en viajes y basados en tareas).
- como se hizo en el entorno de desarrollo o con una segregación de acceso más estructurada si es necesario (consulta esta sección).
[Tú] Crea claves de API, como se hizo en el entorno de desarrollo o con una segregación de acceso más estructurada (p. ej., por producto, dominio, etc.) si es necesario.
[Tú] Habilitas APIs como "Local Rides and Deliveries". y otros servicios de Google Maps Se necesitan las APIs de la plataforma (es decir, Geocoding, Autocomplete, Address Validation).
[Tú] Cuota: si necesitas aumentos de QPM (consultas por minuto) para ciertas APIs, abrir un ticket para brindar asistencia. Descubre cómo hacerlo aquí. Debes agregar una justificación comercial en la que se indique por qué se necesita el aumento. Puedes ver las cuotas predefinidas aquí.
[Tú] Si tienes sistemas desarrollados que usaban credenciales del entorno de desarrollo, asegúrate de que estos sistemas puedan apuntar a las credenciales nuevas que se crearon para los nuevos proyectos creados. Esto incluye apuntar los sistemas de frontend y backend a las credenciales nuevas, como las claves de API y las cuentas de servicio, y asegurarse de que se usen los IDs de proyecto correctos en cada entorno respectivo.
Configuración de facturación
Aquí suponemos que ya firmaste un contrato con Google directamente (si corresponde) o a través de un socio. Este es un requisito previo para recibir la cuenta de facturación de movilidad en la carta de bienvenida, que se usará en los próximos pasos.
- [Tú] Verifica si se recibió un ID de cuenta de facturación de movilidad como parte de la carta de bienvenida que Google envía por correo electrónico después de que se firma y firma el contrato. Importante: La carta de bienvenida se envía a los contactos técnicos y financieros que se indican en el formulario de pedido de tu contrato. Trabaja con tu equipo de proyecto para comprender quién podría haberlo recibido y pídele a esa persona que te proporcione el ID de la cuenta de facturación, que es una serie de caracteres y números separados por guiones.
- [Tú] Trabaja con Google o el socio para asegurarte de que se realice una validación de facturación, lo que significa que tus sistemas ya informan correctamente los viajes o las tareas a Google. Encontrarás más detalles en la siguiente sección.
- [Tú] Dirige tus proyectos de Google Cloud a la nueva cuenta de facturación con la consola de Cloud. Consulta la sección Configuración de la cuenta de facturación más adelante en este documento.
Obtenga más detalles sobre la facturación en general aquí y aquí.
Validación de facturación
La validación de facturación es importante para garantizar que se te cobre correctamente. A veces, las empresas implementan APIs de forma accidental, lo que genera más cargos o informes insuficientes.
La validación de la facturación consta de los siguientes pasos:
Verifica si las solicitudes a las APIs de Google Maps Platform tienen un tripId (o taskId) en el encabezado de la solicitud. Obtén más detalles aquí.
Verificar si los viajes (o tareas) se informan correctamente Esto depende del paquete de movilidad que se use:
- Mobility Starter y Optimize, o bien Accelerate (basado en viajes): Se requiere la integración con la API de ReportBillableEvent. Esto significa que cada vez que se completa un viaje de forma correcta, se debe realizar una solicitud a esta API. Para validar si esto sucede correctamente, debes seguir los pasos que se describen aquí.
- Aceleración de la movilidad (basada en tareas): La facturación no tiene que activarse mediante una llamada a la API. Ocurre automáticamente cuando el resultado de una tarea se establece como SUCCEEDED en una tarea de entrega. Por lo tanto, es muy importante que configures correctamente el resultado de la tarea como FAILED o SUCCEEDED. Los Ingenieros de Atención al cliente (Partners o Google) trabajarán con usted para verificar que la implementación se haya realizado correctamente. A través de Cloud Logging, puedes verificar si las tareas se actualizan correctamente ejecutando la siguiente consulta de Cloud Logging:
resource.type="fleetengine.googleapis.com/DeliveryFleet" jsonPayload.@type="type.googleapis.com/maps.fleetengine.delivery.log.v1.UpdateTaskLog" jsonPayload.request.task.taskOutcome="TASK_OUTCOME_LOG_SUCCEEDED"Si se muestran entradas, significa que tus sistemas de backend están estableciendo correctamente las tareas en SUCCEEDED.
Nota: Sin embargo, es importante verificar si el recuento de viajes o tareas reales que se completaron correctamente se corresponde con la cantidad de llamadas registradas. A veces, vemos que se registran eventos de facturación, pero no corresponden a la cantidad total de viajes o tareas que se completaron en la vida real (registro insuficiente).
Estado de la integración
Una migración exitosa a producción no solo debe garantizar que la facturación funcione correctamente, sino que las APIs no tengan errores de ejecución. En el caso de los servicios de movilidad, es importante verificar si la integración con Fleet Engine (API de Local Rides and Deliveries) se implementó correctamente.
Para ello, puedes abrir Cloud Logging y usar la siguiente consulta:
jsonPayload.errorResponse.code:*
Esto debería enumerar todas las entradas de registro con problemas. Por ejemplo:
Esos problemas se pueden exportar a otros productos de Cloud, como BigQuery. Las métricas y las alertas se pueden configurar en función de la consulta de Cloud Logging:
Como esos son productos de Google Cloud, se pueden generar costos adicionales. Puedes hablar con tu socio o representante de Google para obtener más información.
Configuración de la cuenta de facturación
Si todos tus sistemas ahora informan correctamente los viajes o las tareas, y no existen errores de integración, es momento de dirigir tus proyectos a la cuenta de facturación que recibiste como parte de la carta de bienvenida y de la que se explicó en secciones anteriores de este documento.
Nota: Si trabajas con un socio de Maps, este puede ayudarte en este momento, y no es necesario que sigas los pasos que se indican a continuación. Si trabajas directamente con Google, lo que puede suceder en algunas regiones, puedes seguir los siguientes pasos:
Para eso, siga estos pasos:
- Abre la consola de Google Cloud (https://console.cloud.google.com).
- Selecciona el proyecto nuevo que se usará en producción.
- Ve a la sección Facturación de ese proyecto. Puede acceder a este vínculo con un acceso directo: https://console.cloud.google.com/billing
- Facturación > Haz clic en "Administrar cuentas de facturación":
- En Facturación > Haz clic en el ícono de 3 puntos
.
junto al proyecto de producción que se creó y elige "Cambiar cuenta de facturación":
- Facturación > En Cuenta de facturación, elige el código de cuenta de facturación que recibiste en la carta de bienvenida en la lista desplegable. Luego, haz clic en “ESTABLECER CUENTA”:
- El proyecto se vinculará a la nueva cuenta de facturación:
- Después de agregar la nueva forma de facturación, ve a “Descripción general > Resumen de pagos” y “Configuración de pagos” para confirmar si la información es correcta. Para obtener más información sobre cómo actualizar la facturación y los pagos, consulta este vínculo. Para cualquier problema relacionado con la facturación, presenta un caso de asistencia de facturación o comunícate con tu socio o representante de Google.
Informes de facturación
Los informes de facturación te ayudan a comprender los costos asociados con la cuenta de facturación vinculada al proyecto.
Nota: Si trabajas con un socio de Maps, colabora con él para asegurarte de que se te proporcionen los datos de facturación relevantes que necesitas.
Abre la cuenta de facturación vinculada del proyecto y selecciona Informes. Luego, puedes usar el siguiente conjunto de filtros:
Aquí, el parámetro de configuración principal que debes tener en cuenta es el filtro Agrupar por por SKU, que mostrará información detallada sobre los viajes y las tareas, así como otras APIs si se usan, incluido si hubo excedentes o no, como se explicó anteriormente:
La información del informe se actualiza a diario. Si se necesita información intradía, se pueden usar las consultas de Cloud Logging para ver cuántos eventos facturables ocurrieron durante el día. Consulta las secciones anteriores para obtener más información.
Plan de período de adaptación
Un punto importante que debes mencionar es tu plan de implementación. Es normal que, según la naturaleza de tu empresa, no se migre todo el tráfico al proyecto de movilidad. Por ejemplo, algunas empresas se toman el tiempo para implementar la nueva solución en todas sus sucursales, franquicias, tiendas, oficinas, etc., lo que significa que una parte del tráfico utilizará los sistemas antiguos y otra parte del tráfico irá al proyecto nuevo.
Además, en muchos casos, no todo el tráfico pertenecerá a un caso de uso de movilidad, como es el caso de los buscadores de tiendas, la recolección en la puerta y otras soluciones internas. Estos deben dirigir a una cuenta de facturación de Google Maps Platform, ya que el tráfico de esa cuenta debe mantenerse separado de la cuenta de facturación de movilidad.
Es importante que cumplas con la Política de Implementación:
- Modelo basado en viajes: "La solución On-demand Rides & Deliveries está diseñada para usarse en servicios comerciales de viajes y entregas a pedido. Estos servicios suelen incluir (a) consumidores que envían solicitudes de viaje a un destino determinado (o entrega de un artículo específico) y (b) conductores que coinciden con solicitudes y que conducen un vehículo para completar los servicios”.
- Modelo basado en tareas: “La solución de flota de última milla de Google Maps Platform está diseñada para usarse en servicios comerciales de entrega de última milla y de retiro de primera milla. Estos servicios suelen incluir (a) una flota de Vehículos de entrega que el Cliente posee o contrata, (b) entregas basadas en una ruta planificada con anterioridad, (c) una red de centros de distribución con equipos operativos que respaldan la ejecución de la entrega, y (d) consumidores que realizan un seguimiento de los envíos y luego los reciben”.
Por lo tanto, debes comprender cuáles de tus sistemas deben dirigir a la cuenta de facturación de Google Maps Platform y cuáles deben dirigir a la cuenta de facturación de movilidad. Es común tener varios proyectos y cada uno de ellos apunta a la cuenta de facturación correcta.
A modo de ejemplo, supongamos que cada viaje o tarea incluye 10 solicitudes de geocodificación hoy según los límites de uso. Si la migración llevará algunos meses y comienzas a registrar 100,000 viajes o tareas en el primer mes, significa que podrías llamar a la API de Geocoding 1 millón de veces. Sin embargo, si la Geocoding de 5 millones de tu empresa solicita esa diferencia (4 millones) se podría registrar como excedentes. Aquí hay dos opciones posibles:
- Si aumentas la cantidad de viajes o tareas que nos informas (aceleras el plan de implementación), se aplican límites más altos. En este caso, deberás informar 500,000 viajes o tareas por mes.
- Negocias límites más altos durante las negociaciones del contrato, como se explicó antes.
- Diriges las solicitudes a la API de Geocoding a una API de Google Maps Platform para aprovechar niveles de descuento más altos y pagar menos que los excedentes.
Sabemos que la estimación de costos depende del tamaño y la complejidad de tu negocio, y los casos de uso pueden ser complejos. Trabaja con tu socio o contraparte de Google para determinar cuál es la mejor manera de prepararte para el lanzamiento de producción con tus proyectos existentes.
A modo de resumen, para crear un plan de aumento adecuado, se requieren los siguientes pasos: 1. Identifique qué casos de uso están relacionados con la movilidad y cuáles no cumplen con la Política de Implementación. 2. Identifica qué APIs de Google Maps Platform se usan actualmente para los casos de uso relevantes y sus volúmenes. 3. Identifica si las APIs de Google Maps Platform seguirán siendo necesarias después de que se implemente la solución de movilidad. Por ejemplo, el cálculo de la hora de llegada se realiza automáticamente en Fleet Engine, por lo que es posible que ya no necesites calcularlas con la API de Directions. 4. Identifica cuánto tiempo llevará migrar por completo los casos de uso de movilidad a la nueva plataforma de movilidad. 5. Verifica si los Límites de uso son suficientes para admitir tus casos de uso. 6. Identificar el punto de inflexión en el que todas las solicitudes de Google Maps Platform se pueden transferir a la cuenta de facturación de movilidad para casos de uso de movilidad
Conclusión
En conclusión, configurar correctamente la cuenta de facturación es esencial para la previsibilidad y la transparencia de los precios. Con nuestra tecnología de movilidad que incorpora los mejores servicios de ubicación, las empresas pueden estar seguras de que sus procesos de facturación son precisos y eficientes. Esto no solo ayuda a reducir los costos, sino que también proporciona los datos y las estadísticas necesarios para tomar decisiones empresariales fundamentadas. Además, la transparencia que ofrece este sistema permite que las empresas comprendan claramente sus gastos, lo que lleva a una mejor administración del presupuesto.
Acciones siguientes
- Configura tu cuenta de facturación en GCP Console.
- Puedes encontrar más detalles sobre la facturación en general en