Questa guida descrive come fornire il feed di micromobilità a Google dopo la generazione. Per una descrizione di come creare il feed, consulta le specifiche nella scheda Riferimento.
Linee guida per i feed
Durante il processo di invio del feed Micromobility generato a Google, tieni presente la seguente procedura e le seguenti linee guida:
Assicurati che i dati sulla disponibilità e i prezzi dinamici delle biciclette, ove applicabili, siano aggiornati. Per farlo, devi caricare una nuova versione del feed nell'host del feed GBFS ogni 30 secondi. Inoltre, la latenza per il recupero dei dati non deve superare i 30 secondi.
Per inviare il feed a Google, devi supportare HTTP GET.
Pubblicazione dei feed con HTTP GET
Google recupera il feed dalla posizione configurata con una richiesta HTTPS GET e supporta i seguenti metodi di autenticazione:
- Autenticazione digest HTTP: se implementi questa opzione, invia un'email al nome utente e alla password configurati all'assistenza per i partner Micromobility.
- Campi di intestazione HTTP personalizzati: affinché questo sia supportato, nell'ambito della richiesta a Google, invia i campi di intestazione e i valori necessari.
- Parametri GET: se sono necessari parametri aggiuntivi GET, aggiungili all'indirizzo host prima di inviarli via email all'assistenza per i partner Micromobility.
Per ottimizzare le dimensioni del file durante il trasferimento, Google supporta la compressione gzip nell'intestazione HTTP. In particolare, Google invia Accept-Encoding: gzip, deflate nell'intestazione della richiesta HTTP e accetta la risposta con l'intestazione HTTP Content-Encoding: gzip.
Dopo aver determinato la posizione host e i dettagli, invia i dettagli della configurazione via email all'assistenza dei partner per la micromobilità.
Partizionamento orizzontale del feed
Per impostare un feed devi suddividere l'intero feed in più sottoinsiemi che non si intersecano. A seconda dei sistemi di backend, dei tipi di flotta e delle dimensioni, potrebbe essere necessario l'analisi.
Per i dettagli tecnici su quando e come eseguire lo sharding del feed, consulta la sezione Suddivisione del feed nella sezione Riferimento.
Google utilizzerà lo stesso meccanismo per recuperare sia i feed con sharding sia quelli senza restrizioni, come descritto in Distribuzione dei feed con HTTP GET.
Dopo aver determinato la posizione dell'host e i dettagli di ogni shard, invia un'email ai dettagli di configurazione di ogni shard insieme alle aree metropolitane coperte dallo shard per l'assistenza dei partner per la micromobilità.