Antes de implementar un nuevo proyecto de Google Maps en producción, debes asegurarte de que la configuración sea correcta para pagar el importe correcto por los productos que usas. En este documento, abordamos aspectos para garantizar que tengas (i) transparencia en la facturación, de modo que se pueda verificar el uso antes de que se genere una factura, y (ii) la configuración de proyecto correcta para asegurarte de poder 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 comprendas la información básica sobre la facturación de Google Maps y las diferentes configuraciones que pueden existir. En muchas situaciones, no hay una opción correcta o incorrecta, sino que 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
Actualmente, todas las empresas que usan productos de Google Maps tienen un proyecto de Google Cloud asociado. 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 cada mes 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 pueden usar una sola cuenta de facturación.
Un solo proyecto que apunta a la misma cuenta de facturación:
- Caso de uso específico (p. ej., 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 agregando el uso
- Factura única
Para obtener información adicional sobre las cuentas de facturación y otros datos relevantes, consulta este vínculo.
Como se indicó 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 seguir apuntando a la cuenta de facturación normal de Google Maps Platform que usas actualmente. 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 se ajusta una cuenta de facturación en todo el esquema y las diferentes configuraciones posibles:
Recursos de Cloud, cuenta de facturación y generación de facturas
En cuanto a los precios, en Google Maps Platform, existen diferentes niveles de descuentos disponibles a través de los Socios de Maps o directamente con Google en algunos casos. Estos niveles se basan en el volumen, por lo que pagas menos cuanto más usas 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 realizará 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 autenticarse. 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 correctamente.
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 tienes una empresa de viajes compartidos o de entrega de comida, tu métrica de éxito es completar un viaje o una entrega, lo que 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 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 a tu contrato, así que trabaja con tu representante de Google o 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 exitosos informados en el sistema y (ii) cualquier volumen de llamadas a la API de Google Maps Platform que supere los límites preestablecidos (“excedentes”). Nuestros límites se alinean con lo que hemos visto en general como necesario en el mercado.
Te sugerimos que leas atentamente la documentación oficial de facturación de movilidad que se encuentra aquí.
Pruebas piloto y evaluación
Los clientes pueden ejecutar una prueba piloto pequeña (prueba de concepto, evaluación) de los servicios de movilidad en una cuenta de facturación de Google Maps Platform durante un período limitado antes de firmar un contrato. Si quieres ejecutar una prueba piloto, comunícate con tu socio de Maps o con 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, cada vez que se usen los productos de Google Maps Platform, se les cobrará, pero no a 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 los excesos. Los excedentes se cobran como 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, es probable que solo tengas un entorno, el de desarrollo.
Requisitos
Una persona que pueda ayudarte a 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 cuenta de facturación que se incluye en la carta de bienvenida que se generó después de firmar 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 su facturación.
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 o de un socio y proporciona el ID del proyecto que creaste 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 en la consola de Google Cloud para el proyecto 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 otras APIs de Google Maps Platform necesarias (es decir, Geocoding, Autocomplete y Address Validation).
[Tú] Cuota: Si necesitas aumentos de QPM (consultas por minuto) para ciertas APIs, abre un ticket para obtener 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 proyectos nuevos. 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 recibiste 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 ejecuta 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. Obtén 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.
Puedes obtener más detalles sobre la facturación en general aquí y aquí.
Validación de facturación
La validación de la facturación es importante para garantizar que se te cobre correctamente. A veces, las empresas implementan APIs de forma incorrecta por accidente, 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 información aquí.
Verifica si los viajes (o las tareas) se informan correctamente. Esto depende del Paquete de movilidad que se use:
- Mobility Starter y Optimize, o 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 de publicación se establece como CORRECTO. Por lo tanto, es muy importante que configures correctamente el resultado de la tarea como FAILED o SUCCEEDED. Los ingenieros de clientes (socios o Google) trabajarán contigo 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 configurando correctamente las tareas para que se marquen como SUCCEEDED.
Nota: Sin embargo, es importante verificar si el recuento de viajes o tareas reales completados correctamente corresponde a la cantidad de llamadas registradas. En ocasiones, 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 fallan en la 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:*
En esta lista, se deben incluir 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 se trata de productos de Google Cloud, es posible que se generen 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 registran correctamente los viajes o las tareas y no hay errores de integración, es hora de dirigir tus proyectos a la cuenta de facturación que recibiste como parte de la carta de bienvenida y que se analizó en secciones anteriores de este documento.
Nota: Si trabajas con un socio de Maps, este puede ayudarte en este momento y no tienes que seguir los pasos que se indican a continuación por tu cuenta. Si trabajas directamente con Google, lo que puede suceder en algunas regiones, puedes seguir estos 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. Puedes acceder a este vínculo para obtener un atajo: 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 "Resumen > Descripción general 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. Si tienes problemas relacionados con la facturación, presenta un caso de asistencia sobre facturación o trabaja 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, asegúrate de que te proporcione la información de facturación relevante 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 de los informes se actualiza a diario. Si necesitas información intradía, puedes 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 aumento
Un punto importante que debes mencionar es tu plan de implementación. Es común que no todo el tráfico se migre al proyecto de movilidad según la naturaleza de tu empresa. Por ejemplo, algunas empresas se toman su tiempo para lanzar la nueva solución a todas sus sucursales, franquicias, tiendas, oficinas, etc., lo que significa que parte del tráfico usará los sistemas anteriores y 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 apuntar a una cuenta de facturación de Google Maps Platform, ya que el tráfico 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. Por lo general, estos servicios incluyen (a) consumidores que envían solicitudes de viajes a un destino determinado (o la entrega de un artículo específico) y (b) conductores que coinciden con las 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. Por lo general, estos servicios incluyen (a) una flota de vehículos de reparto que son propiedad del cliente o que este contrata, (b) entregas basadas en una ruta planificada con anticipación, (c) una red de centros de distribución con equipos operativos que respaldan la ejecución de las entregas y (d) consumidores que hacen un seguimiento de los envíos y, luego, los reciben”.
Por lo tanto, debes comprender cuáles de tus sistemas deben apuntar a la cuenta de facturación de Google Maps Platform y cuáles deben apuntar a la cuenta de facturación de movilidad. Es común tener varios proyectos, cada uno de los cuales 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 tu empresa realiza 5 millones de solicitudes de geocodificación, esa diferencia (4 millones) podría informarse como un exceso. 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 beneficiarte de niveles de descuento más altos y pagar menos que los sobrecargos.
Sabemos que la estimación de costos puede ser compleja según el tamaño y la complejidad de tu empresa y los casos de uso. Trabaja con tu socio o contraparte de Google para determinar cuál es la mejor manera de prepararte para el lanzamiento en producción con tus proyectos existentes.
A modo de resumen, para crear un plan de aumento adecuado, se requieren los siguientes pasos: 1. Identificar qué casos de uso están relacionados con la movilidad y cuáles no, según 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 implementar la solución de movilidad. Por ejemplo, el cálculo de la hora de llegada estimada se realiza automáticamente en Fleet Engine, por lo que es posible que ya no necesites calcularla 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 los 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. Cuando las empresas utilizan nuestra tecnología de movilidad que incorpora los mejores servicios de ubicación, pueden confiar en 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 comerciales 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