Antes de implementar un proyecto nuevo de Google Maps en producción, asegúrate de que la configuración sea correcta para que pagues el importe correcto por los productos que utilizas. En este documento, se abarcan aspectos para garantizar (i) la transparencia de la facturación, de manera 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 proceso debería ser relativamente sencillo, los socios de Maps pueden trabajar contigo para garantizar que tus proyectos se trasladen 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 nada correcto o incorrecto en muchas situaciones, ya que depende del tipo de resultado que se quiera obtener.
En este documento, hablamos mucho sobre tu proyecto de Google Cloud. Esto se debe a que los productos de Google Maps están disponibles a través de él. Esto significa que la configuración que abordamos en este documento se realiza en tu proyecto de Google Cloud.
Cuentas de facturación
Todas las empresas que usan productos de Google Maps en la actualidad 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 la 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 compartido, entregas y logística.
Se puede usar una sola cuenta de facturación en varios proyectos de Google Cloud o solo en uno.
Proyecto único 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 aplica sobre el volumen de este proyecto individual
Varios proyectos apuntan a la misma cuenta de facturación:
- Mismo caso de uso
- Agrega uso para aprovechar los niveles de descuento
- 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 tiene más de un proyecto, debe identificar cuáles utilizarán nuestros servicios de movilidad y dirigirlos a una cuenta de facturación de movilidad. Los proyectos que no tienen un caso de uso de movilidad asociado deben seguir haciendo referencia a la cuenta de facturación normal de Google Maps Platform que utilizas 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 una cuenta de facturación se adapta a todo el esquema y a 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 algunas situaciones. 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, que 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 según esta clave de API, en la que 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 del proyecto de Google Cloud en la URL y usan un JWT para autenticarse. Por lo tanto, es importante asegurarse de que los sistemas adecuados utilicen 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 las 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íos, no retiros). 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 será completar un viaje o una entrega. Esto se mapea con un Viaje. Las tareas se utilizan para las empresas y los minoristas de logística que deben entregar paquetes correctamente.
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 utilizas 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.
A modo de ejemplo, si tienes una empresa de entrega de comida, por cada viaje exitoso que realices puedes llamar a la API de geocodificación diez veces. Para obtener más información sobre estos límites, consulta los límites de uso en la documentación sobre movilidad. Cualquier cambio en los límites requiere una enmienda en el 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 que se completaron correctamente en el sistema y (ii) de cualquier volumen de llamadas a la API de Google Maps Platform que supere los límites preestablecidos ("excedentes"). Nuestros límites están alineados con lo que, en general, consideramos necesario en el mercado.
Le sugerimos que lea atentamente la documentación oficial sobre facturación de dispositivos móviles que puede consultar aquí.
Pruebas piloto y evaluación
Los clientes pueden ejecutar una pequeña prueba piloto (prueba de concepto, evaluación) de servicios de movilidad en una cuenta de facturación de Google Maps Platform por un tiempo limitado antes de que se firme el contrato. Si deseas realizar una prueba piloto, comunícate con tu socio de Maps o tu contraparte de Google.
Durante la fase piloto, como se mencionó, no hay una cuenta de facturación de movilidad disponible, ya que aún no se firmó el contrato. Esto significa que, siempre que se usen productos de Google Maps Platform, se les cobrará, pero no los productos específicos para movilidad. En otras palabras, esto significa que, durante la fase piloto, la facturación no se basa en Tareas ni Viajes como consecuencia de ello, los límites de uso no se aplican durante esta fase.
Una vez que se lance oficialmente la prueba piloto a producción, se deberá pagar según el contrato.
En síntesis:
Fase piloto / de desarrollo: Se te cobra solo por las APIs de Google Maps que estén disponibles públicamente. 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 $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 generarán si el uso excede los límites de uso (“límites”) del contrato. Si es así, tendrás que pagar 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 otros proyectos de Google Cloud Platform (GCP) para representar tus diferentes entornos, como QA (control de calidad) y producción. Antes de eso, probablemente tengas un único entorno, el de desarrollo.
Requisitos
Una persona de tu lado que pueda hacer lo siguiente:
- Administrar cuentas de facturación en Google Cloud; por lo general, esto lo hace el administrador de la cuenta de facturación o el propietario del proyecto.
- Acceso al nuevo ID de la cuenta de facturación incluido en la carta de bienvenida que se generó después de la firma del contrato.
- Acceso al proyecto de Google Cloud correspondiente al entorno de producción en el que se informarán los viajes o las tareas.
A continuación, te mostramos los pasos necesarios para configurar un proyecto nuevo y cómo configurar la facturación en ellos.
Configuración de un nuevo proyecto
Creación de proyectos
- [Usted] Creación de nuevos proyectos de GCP para los nuevos entornos (es decir, producción, control de calidad, etcétera). Esto se hace a través de la consola de Google Cloud. Vínculo directo aquí.
- [Socio o equipo de Google] Este proyecto debe estar incluido en la lista de entidades permitidas para poder acceder a los productos de movilidad. Para hacerlo, trabaja con tu representante de ventas de Google o socio. Proporciona el ID del proyecto que se creó en el paso anterior.
- [Tú] Actualiza los contactos esenciales de tus proyectos. Esto es muy importante para garantizar que los equipos de Atención al cliente de Google puedan llegar a las personas adecuadas de tu lado.
Configuración de proyectos
Los siguientes pasos deben realizarse en la consola de Google Cloud en el proyecto que se creó en los pasos anteriores:
- [Tú] Creación de cuentas de servicio, incluida la asociación de los roles correctos de Mobility Identity & Access Management (IAM) (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ú] Creación de 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
- [Usted] Habilitar APIs, como "Local Rides & Deliveries" y otras APIs de Google Maps Platform, es necesario (p.ej., Geocoding, Autocomplete y Address Validation).
- [Tú] Cuota: Si necesitas aumentos de QPS (consultas por segundo) para ciertas APIs, abre un ticket de asistencia. Descubre cómo hacerlo aquí. Debes agregar una justificación comercial que indique por qué se necesita el aumento. Puedes consultar 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 nuevas credenciales que se crearon para los proyectos nuevos creados. Esto incluye apuntar los sistemas de backend y frontend a las nuevas credenciales, como las claves de API, las cuentas de servicio y asegurarse de que se utilicen los ID de proyecto correctos en cada entorno respectivo.
Configuración de facturación
En este caso, suponemos que ya firmó un contrato con Google de forma directa (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, la cual se utilizará en los próximos pasos.
- [Usted] Verifique si se recibió un ID de cuenta de facturación de movilidad como parte de la Carta de bienvenida que se envía por correo electrónico de Google después de firmar y ejecutar el contrato. Importante: La carta de bienvenida se envía a los contactos técnicos y financieros que figuran en el formulario del pedido de tu contrato. Trabaja con tu equipo del proyecto para saber quién podría haber recibido el mensaje 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ú] Trabajas con Google o un socio para asegurarte de que se realice una validación de facturación. Esto significa que tus sistemas ya informan correctamente sobre viajes o tareas a Google. Encontrarás más detalles en la próxima sección.
- [Tú] Dirige tus proyectos de Google Cloud a la cuenta de facturación nueva mediante la consola de Cloud. Consulta la sección Configuración de la cuenta de facturación más adelante en este documento.
Puedes encontrar 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, lo que genera más cargos o informes insuficientes.
La validación de la facturación consta de los siguientes pasos:
Cómo verificar 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í.
Verificar si los viajes (o tareas) se informan correctamente Depende del paquete de movilidad que se use:
- Mobility Starter y Optimize, o Accelerate (Trip based): Se requiere la integración con la API de ReportBillableEvent. Esto significa que cada vez que un viaje se completa correctamente, 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): No es necesario activar la facturación con 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 establezcas correctamente el resultado de la tarea en FALLIDO o SUCCEEDED. Los Ingenieros de Atención al cliente (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 están actualizando de forma correcta 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 las tareas de forma correcta en SUCCEEDED.
Nota: Es importante verificar si la cantidad de viajes o tareas reales que se completaron correctamente corresponde a la cantidad de llamadas registradas. A veces, vemos que se informan eventos de facturación, pero no corresponden a la cantidad total de viajes o tareas que en realidad se completaron en la vida real (informes insuficientes).
Estado de la integración
Una migración exitosa a la producción no solo debería garantizar que la facturación funcione correctamente, sino también que las APIs no fallen en la ejecución. En lo que respecta a 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:*
Se deberían enumerar todas las entradas de registro con problemas. Por ejemplo:
Esos problemas pueden exportarse 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, se podrían generar costos adicionales. Puedes hablar con tu socio o representante de Google para obtener más claridad.
Configuración de la cuenta de facturación
Si todos tus sistemas ahora informan correctamente sobre viajes o 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 que se analizó en las secciones anteriores de este documento.
Nota: Si trabajas con un socio de Maps, podrá ayudarte en este momento, y no tienes que seguir solo los pasos que se indican a continuación. Si trabajas de forma directa con Google, lo que puede suceder en algunas regiones, sigue estos pasos:
Para eso, siga estos pasos:
- Abra la consola de Google Cloud (https://console.cloud.google.com).
- Selecciona el proyecto nuevo que se usará en la producción.
- Ve a la sección Facturación de ese proyecto. Se puede acceder a este vínculo mediante 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 la cuenta de facturación que recibiste en la carta de bienvenida de 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 > Descripción general de los 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 de billing 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 a la cuenta de facturación vinculada al proyecto.
Nota: Si trabajas con un socio de Maps, asegúrate 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:
Este es el parámetro de configuración principal que se debe tener en cuenta es el filtro Agrupar por por SKU, que mostrará información detallada sobre Viajes y Tareas, así como sobre otras APIs si se usan, incluido si hubo excedentes o no, como se explicó anteriormente:
La información del informe se actualiza todos los días. Si se necesita información intradía, se pueden usar las consultas en Cloud Logging para ver cuántos eventos facturables ocurrieron durante el día. Consulta las secciones anteriores.
Plan de adaptación
Es importante mencionar su plan de adaptación. Según la naturaleza de tu empresa, es común que no se migre todo el tráfico al proyecto de movilidad. Por ejemplo, algunas empresas se toman el tiempo para lanzar la nueva solución en todas sus sucursales, franquicias, tiendas, oficinas, etc., lo que significa que parte del tráfico utilizará los sistemas antiguos 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 sucede con los localizadores de tiendas, los retiros en la puerta y otras soluciones internas. Estas deben apuntar a una cuenta de facturación de Google Maps Platform, ya que el tráfico de allí 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 entrega y de transporte a pedido. Por lo general, estos servicios incluyen (a) consumidores que envían solicitudes de viaje a un destino determinado (o que entregan 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: “The Google Maps Platform Last Mile Fleet Solution está diseñado para usarse en servicios comerciales de entrega en el último tramo y servicios de retiro para el tramo inicial. Estos servicios suelen incluir (a) una flota de Vehículos de entrega propiedad o contratada por el Cliente, (b) entregas basadas en una ruta previamente planificada, (c) una red de centros de distribución con equipos operativos que brindan asistencia para la ejecución de las entregas y (d) consumidores que rastrean y luego reciben los envíos”.
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 y cada uno apunta a la cuenta de facturación correcta.
Como ejemplo, ten en cuenta que cada viaje / tarea incluye actualmente 10 solicitudes de geocodificación, según los límites de uso. Si tu migración va a tardar unos meses y comienzas a informar 100,000 viajes o tareas en el primer mes, significa que puedes llamar a la API de Geocoding 1 millón de veces. Sin embargo, si tu empresa solicita la geocodificación 5M, esa diferencia (4 millones) podría informarse como excedente. Aquí tienes dos opciones posibles:
- Como aumentas la cantidad de viajes o tareas que informas (se acelera el plan de adaptación), se aplican límites más altos. En este caso, tendrás que informar 500,000 viajes o tareas por mes.
- Como se explicó anteriormente, se negocian límites más altos durante las negociaciones del contrato.
- 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 más económico que los excedentes.
Sabemos que la estimación de costos depende del tamaño y la complejidad de tu empresa, y que los casos de uso pueden ser complejos. Trabaja con tu socio o con tu contraparte de Google para determinar cuál es la mejor manera de prepararte para el lanzamiento de producción con tus proyectos existentes.
En resumen, para crear un plan de aumento adecuado, se requieren los siguientes pasos: 1. Identifica qué casos de uso están relacionados con la movilidad y cuáles no cumplen con las políticas de implementación. 2. Identifica qué APIs de Google Maps Platform se usan en la actualidad para los casos de uso relevantes y sus volúmenes. 3. Identifica si se seguirán solicitando las APIs de Google Maps Platform después de que se implemente la solución de movilidad. Por ejemplo, el cálculo de la hora de llegada estimada se realiza automáticamente en Fleet Engine. Es posible que ya no tengas que hacerlo 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 de tu lado. 5. Vuelve a verificar si los límites de uso son suficientes para admitir tus casos de uso. 6. Identifica el punto de inflexión en el que todas las solicitudes de Google Maps Platform se pueden plegar a la cuenta de facturación de movilidad para casos de uso de movilidad.
Conclusión
En conclusión, configurar adecuadamente la cuenta de facturación es esencial para la previsibilidad y transparencia de los precios. Gracias al uso de nuestra tecnología de movilidad que incorpora los mejores servicios de ubicación, las empresas pueden confiar en que sus procesos de facturación son precisos y eficientes. Esto no solo ayuda a reducir costos, sino que también proporciona los datos y las estadísticas que se necesitan para tomar decisiones empresariales fundamentadas. Además, la transparencia que ofrece este sistema les permite a las empresas tener una comprensión clara de sus gastos, lo que lleva a una mejor gestió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