Requisiti generali

Un partner deve fornirci un solo set di feed, che deve essere conforme a GBFS V2.2 per sistemi con o senza aggancio. Il set deve includere un solo file per ogni tipo. Ad esempio, deve contenere un solo station_information.json. A causa del limite di file, per un determinato insieme di feed esistono i seguenti vincoli:

  • Il set di feed è limitato a un singolo set di file GBFS che contengono i campi definiti nella lingua locale della città che copre, se opportuno. Ad esempio, se un feed copre sia il Regno Unito che la Germania, stations[].name deve contenere il nome della stazione in inglese per le stazioni situate nel Regno Unito e in tedesco per le stazioni situate in Germania.
  • Il set di feed deve essere completo per le aree metropolitane che copre. Google consente lo sharding dei feed, se necessario. Ogni shard deve coprire un'area di servizio geografica almeno delle dimensioni di un'area metropolitana o più grande. Per maggiori informazioni sullo sharding, consulta Sharding dei feed.

Definizioni dei tipi di dati strutturati

Per creare correttamente il feed, devi rispettare il set applicabile di definizioni dei tipi di dati strutturati che forniamo. Nelle definizioni GBFS, tutti i file in GBFS V2.2 sono elencati con indicazioni dei sistemi a cui sono applicabili nell'intestazione con le seguenti permutazioni:

  • Sistema agganciato
  • Sistema senza stazione di ricarica
  • Sistema con base e senza base

Ad esempio, se il fornitore utilizza un sistema senza stazione di ricarica, devi fornire solo i file indicati per Dockless system o Dockless and docked systems per descrivere il sistema. Per ulteriori informazioni, consulta la sezione Sistemi di micromobilità supportati.

Ogni sezione delle definizioni GBFS fornisce le definizioni dei tipi di dati strutturati necessarie per creare correttamente un feed completo. Include le definizioni e le istruzioni specifiche per il tipo di fornitore per il feed.