Ce guide explique comment fournir votre flux de micromobilité à Google une fois qu'il a été généré. Pour savoir comment créer votre flux, consultez les spécifications de l'onglet Référence.
Consignes relatives aux flux
Pour envoyer votre flux de micromobilité généré à Google, tenez compte des consignes et de la procédure suivantes :
Assurez-vous que les données sur la disponibilité des vélos et les tarifs dynamiques, le cas échéant, sont à jour. Pour ce faire, vous devez importer une nouvelle version du flux vers l'hôte du flux GBFS toutes les 30 secondes. De plus, la latence pour récupérer les données ne doit pas dépasser 30 secondes.
Pour envoyer votre flux à Google, vous devez être compatible avec HTTP GET.
Distribution de flux avec HTTP GET
Google récupère le flux à l'emplacement configuré avec une requête HTTPS GET et accepte les méthodes d'authentification suivantes :
- Authentification HTTP Digest : si vous implémentez cette méthode, envoyez le nom d'utilisateur et le mot de passe configurés à l'adresse Micromobility partner support (Assistance pour les partenaires de micromobilité).
- Champs d'en-tête HTTP personnalisés : pour que cette fonctionnalité soit prise en charge, envoyez à Google les champs d'en-tête et les valeurs requis dans votre demande.
- Paramètres GET : si des paramètres GET supplémentaires sont requis, ajoutez-les à l'adresse de l'hôte avant de l'envoyer par e-mail à l'assistance pour les partenaires de micromobilité.
Pour optimiser la taille des fichiers lors du transfert, Google accepte la compression gzip dans l'en-tête HTTP. Plus précisément, Google envoie Accept-Encoding: gzip, deflate dans l'en-tête de requête HTTP et accepte la réponse avec l'en-tête HTTPContent-Encoding: gzip.
Une fois que vous avez déterminé l'emplacement et les détails de l'hôte, envoyez les informations de configuration par e-mail à l'assistance pour les partenaires de micromobilité.
Segmentation des flux
Partitionner un flux consiste à le diviser en plusieurs sous-ensembles non sécants. Selon vos systèmes de backend, les types et la taille de votre parc, le partitionnement peut être nécessaire.
Pour en savoir plus sur le moment et la manière de fragmenter votre flux, consultez Fragmentation des flux dans la section "Référence".
Google utilisera le même mécanisme pour récupérer les flux fragmentés et non fragmentés, comme décrit dans Distribution des flux avec HTTP GET.
Une fois que vous avez déterminé l'emplacement et les détails de l'hôte pour chaque partition, envoyez les détails de configuration de chaque partition ainsi que les zones métropolitaines couvertes par la partition à l'assistance pour les partenaires de micromobilité.