En esta guía, se explica cómo realizar la integración con Google para brindar a los usuarios una experiencia de búsqueda de transporte fluida en varias plataformas de Google, como Google Maps y la Búsqueda de Google. En términos generales, las principales especificaciones de integración incluyen lo siguiente:
- Hay dos opciones para proporcionar datos estáticos:
- Integración basada en GTFS: Proporciona un feed GTFS con extensiones de venta de boletos en los casos en los que seas el proveedor de los datos de programación. Tenemos algunos requisitos adicionales para la integración basada en GTFS.
- Integración solo de paradas: Proporciona solo una lista de paradas, para los casos en los que Google ya tiene los datos de programación de otra fuente.
- Una especificación de la API de socio para proporcionar datos dinámicos:
- Configuración del socio: Proporciona información del socio, como la marca y los detalles de contacto.
- Servidor del socio: Son los servidores de implementación que admiten las APIs de Partner Server.
Pasos para la integración con Travel Transport
A continuación, se incluye una descripción general de los pasos necesarios para compilar y probar un sistema integral que admita las funciones de transporte de Google. La integración consta de tres pasos principales:
- Revisar los requisitos de participación
- Proporcionar un feed de datos estáticos a Google
- Compatibilidad con la API de Travel Transport para habilitar consultas dinámicas de datos que cambian rápidamente, como precios y disponibilidad La API utiliza los identificadores proporcionados por el feed de datos estáticos del paso 1, por ejemplo,
ticketing_stop_idpara identificar las paradas.
1. Requisitos de participación
La unidad de funciones de transporte de Google muestra itinerarios y opciones de reserva con precios. Para mostrar tu oferta en la lista, se espera un vínculo de buena calidad y un precio final coincidente. Para obtener más detalles, consulta nuestros requisitos de participación.
2. Cómo proporcionar un feed de datos estáticos
Existen dos opciones para proporcionar datos estáticos, cada una aplicable en circunstancias específicas. El criterio principal para decidir qué opción usar es si eres el proveedor de los datos de programación de las conexiones de transporte público para las que deseas ofrecer la función de reserva. La forma más sencilla de verificar si Google ya tiene datos de horarios es intentar encontrar conexiones para un operador en particular en Google Maps.
| Función | Integración basada en GTFS | Integración de solo detención |
|---|---|---|
| Caso práctico | Ya proporcionas el GTFS con información sobre horarios y venta de boletos. | Google ya tiene los datos de programación del operador de otra fuente. |
| Datos obligatorios | Son los IDs de GTFS. | Es una lista de tus IDs de parada, con sus coordenadas geográficas. |
| Esfuerzo | Baja | Medio |
La opción 1 se aplica si eres el proveedor del feed de GTFS de un operador. En este caso, también debes configurar un feed de GTFS para proporcionar primero la información de programación a Google. Luego, sigue las instrucciones de la sección de integración basada en GTFS.
La opción 2 se aplica si Google ya recibe datos de programación del operador desde otra fuente. En este caso, no necesitamos la información completa del programa, pero sí una lista de los IDs de las paradas que podemos usar en la API de Travel Transport (consulta a continuación). Para proporcionar la lista de paradas, sigue las instrucciones de la sección Integración solo de paradas.
3. Compatibilidad con la API de Travel Transport
Para que se te incluya en la lista de socios de reservas con precios en la unidad de transporte, Google debe poder recuperar la información más reciente sobre precios y disponibilidad de los socios. Para habilitar esta función, los socios deben proporcionar un servicio que implemente las APIs del servidor de socios.
3.1. Implementa la API de Partner Server
Encontrarás detalles para implementar la API de Partner Server en la Referencia de la API y en la Guía del servidor de socios. La API permite que Google obtenga la información de precios y disponibilidad más actualizada de los socios, y Google la llamará para hacer lo siguiente:
- Genera una caché para mostrar los precios rápidamente.
- Obtén los precios más recientes cuando un usuario haga clic en un itinerario específico.
La implementación de la API de Partner Server es obligatoria si el socio desea que Google muestre los precios.
3.2. Validación y pruebas de la API
Una vez que la implementación de la API esté casi completa y el servicio que la implementa esté en funcionamiento, comunícate con transport-help@google.com y proporciona la información del servidor para que podamos comenzar a validar tu implementación.
En el futuro, planeamos ofrecer herramientas automatizadas para validar la implementación de tu API, pero aún no están disponibles.