En esta guía, se describe cómo proporcionar tu feed de micromovilidad a Google después de que se genere. Para obtener una descripción sobre cómo crear tu feed, consulta las especificaciones en la pestaña Referencia.
Lineamientos sobre el feed
Como parte del proceso para enviar tu feed de micromovilidad generado a Google, ten en cuenta el siguiente proceso y los lineamientos:
Asegúrate de que los datos de disponibilidad de bicicletas y de tarifas dinámicas, cuando corresponda, estén actualizados. Para ello, debes subir una versión nueva del feed al host del feed de GBFS cada 30 segundos. Además, la latencia para recuperar los datos no debe superar los 30 segundos.
Para entregar tu feed a Google, debes admitir HTTP GET.
Entrega de feeds con HTTP GET
Google recupera el feed de la ubicación configurada con una solicitud HTTPS GET y admite los siguientes métodos de autenticación:
- Autenticación de resumen HTTP: Si implementas esta opción, envía por correo electrónico el nombre de usuario y la contraseña configurados al equipo de asistencia al socio de micromovilidad.
- Campos de encabezado HTTP personalizados: Para que se admita esta opción, como parte de tu solicitud a Google, envía los campos y valores de encabezado obligatorios que necesites.
- Parámetros GET: Si se requieren parámetros GET adicionales, agrégalos a la dirección del host antes de enviarla por correo electrónico al equipo de asistencia al socio de micromovilidad.
Para optimizar el tamaño del archivo durante la transferencia, Google admite la compresión gzip en el encabezado HTTP. Específicamente, Google envía Accept-Encoding: gzip, deflate en el encabezado de solicitud HTTP y acepta la respuesta con el encabezado HTTP Content-Encoding: gzip.
Después de determinar la ubicación y los detalles del host, envía los detalles de configuración por correo electrónico al equipo de asistencia para socios de micromovilidad.
Fragmentación del feed
Fragmentar un feed significa dividirlo en varios subconjuntos que no se intersectan. Según tus sistemas de backend, los tipos y tamaños de flota, el sharding podría ser necesario.
Para obtener detalles técnicos sobre cuándo y cómo fragmentar tu feed, consulta Fragmentación de feeds en la sección de referencia.
Google usará el mismo mecanismo para recuperar los feeds fragmentados y no fragmentados, como se describe en Entrega de feeds con HTTP GET.
Después de determinar la ubicación del host y los detalles de cada fragmento, envía por correo electrónico los detalles de configuración de cada fragmento junto con las áreas metropolitanas que abarca el fragmento a Micromobility partner support.