Questa guida descrive come fornire il feed di micromobilità a Google dopo la generazione. Per una descrizione su come creare il feed, consulta le specifiche nella scheda Riferimento.
Linee guida per i feed
Nell'ambito della procedura per inviare a Google il feed di micromobilità generato, tieni presente la seguente procedura e le seguenti linee guida:
Assicurati che i dati sulla disponibilità delle biciclette e sulle tariffe dinamiche, se applicabile, siano aggiornati. A questo scopo, devi caricare una nuova versione del feed sull'host del feed GBFS ogni 30 secondi. Inoltre, la latenza per recuperare i dati non deve superare i 30 secondi.
Per inviare il feed a Google, devi supportare HTTP GET.
Invio del 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 autenticazione, invia via email il nome utente e la password configurati all'assistenza partner per la micromobilità.
- Campi di intestazione HTTP personalizzati:per supportare questa funzionalità, invia i campi di intestazione e i valori richiesti a Google nell'ambito della tua richiesta.
- Parametri GET:se sono necessari parametri GET aggiuntivi, aggiungili all'indirizzo host prima di inviarlo via email all'assistenza per i partner di micromobilità.
Per ottimizzare le dimensioni dei file durante il trasferimento, Google supporta la compressione gzip nell'intestazione HTTP. Nello specifico, 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 e i dettagli dell'host, invia un'email con i dettagli di configurazione all'assistenza per i partner di micromobilità.
Suddivisione del feed
Suddividere un feed significa suddividerlo in più sottoinsiemi non intersecanti. A seconda dei sistemi di backend, dei tipi di flotta e delle dimensioni, lo sharding potrebbe essere necessario.
Per informazioni tecniche su quando e come suddividere il feed, consulta Suddivisione dei feed nella sezione Riferimento.
Google utilizzerà lo stesso meccanismo per recuperare i feed suddivisi e non suddivisi come descritto in Invio dei feed con HTTP GET.
Dopo aver determinato la posizione e i dettagli dell'host per ogni shard, invia via email i dettagli di configurazione di ogni shard insieme alle aree metropolitane che copre all'assistenza partner per la micromobilità.