Descripción general
Si no eres el proveedor de los feeds de GTFS para Google Maps, tu integración es de solo paradas. Para esta integración, necesitamos comprender cómo identificas las diferentes paradas de tren o autobús.
Especificaciones generales del feed
Cuando iniciamos la integración, creamos un identificador único para cada integración, por ejemplo: ch_google_test (código de país, nombre del socio, integración) o eu_google (código de región, nombre del socio).
Los socios pueden proporcionar un archivo ZIP que contenga archivos de texto en formato CSV que se apliquen de forma global o por integración:
Ejemplo 1:
- ch_google_test_stops.txt
- ch_google_test_markets.txt
Ejemplo 2:
- stops.txt (se aplica a todas las integraciones)
- eu_google_integration1_markets.txt
- eu_google_integration2_markets.txt
Especificación del feed de paradas (obligatorio)
El archivo de detención debe contener las siguientes columnas:
| Nombre del campo | Tipo (consulta GTFS) | Descripción |
|---|---|---|
stop_id |
ID (obligatorio) | Es el identificador único que identifica una parada o estación. Las estaciones más grandes solo deben contener una entrada. Se usa cuando se realizan llamadas a la API de tu servidor de socios y en los vínculos directos de venta de entradas. |
stop_name |
Texto (obligatorio) | Es un nombre legible por humanos para depurar la asignación de paradas, el llenado de caché y los datos de precisión de precios. |
stop_lat |
Latitud (obligatorio) | Latitud de la parada. |
stop_lon |
Longitud (obligatorio) | Es la longitud de la parada. |
Usaremos un proceso de transferencia automatizado en el que los socios podrán proporcionar archivos ZIP actualizados de forma continua cuando cambie la información que contienen. Por ejemplo, un socio puede expandir el inventario proporcionado extendiendo la lista de paradas. Sin embargo, al igual que en las GTFS, los stop_ids deben ser estables.
Especificación del feed de conjuntos de mercados (opcional)
Con las paradas asignadas, generamos el mercado establecido para esta integración (una lista que contiene pares de origen y destino populares). Desde allí, tienes la opción de reducir este conjunto de mercados proporcionando un feed de conjunto de mercados.
El conjunto de mercados actúa como una lista de entidades permitidas: si no se proporciona un conjunto de mercados, todos los mercados están habilitados en la integración. Si se proporciona un conjunto de mercados, se inhabilita cualquier mercado que no esté en la lista.
El archivo de conjunto de mercados debe contener las siguientes columnas:
| Nombre del campo | Tipo (consulta GTFS) | Descripción |
|---|---|---|
origin_stop_id |
ID (obligatorio) | El stop_id de origen del mercado. |
destination_stop_id |
ID (obligatorio) | El stop_id de destino del mercado. |
Configuración de socios
Cuando usas la integración de solo detención, requerimos información adicional para la configuración de socios estáticos, como se describe en la sección Configuración de socios.
Vínculos directos de venta de entradas
El formato y los parámetros de un vínculo directo se definen en Vínculos de venta de entradas.
Parámetros de la API de socios
Los parámetros de SegmentKeys para la API de socios (GetBulkTripOptionsRequest) se basan en la especificación de vínculos directos. Usamos SegmentKeys, que solo incluye from_ticketing_stop_time_id, to_ticketing_stop_time_id, service_date, boarding_time y arrival_time, y dejamos ticketing_trip_id vacío. Especificaremos por completo la ruta, incluidos todos los trasbordos, especificando varios SegmentKeys, uno por segmento.