Fragmentar um feed significa dividir todo o feed em vários subconjuntos não conflitantes. Dependendo dos seus sistemas de back-end, tipos e tamanhos de frota, o fragmentação pode ser necessária.
Quando fragmentar
Se o tamanho do feed for muito grande (mais de 50 MB), isso poderá causar problemas de desempenho quando o parceiro tentar seguir os requisitos de atualização de dados.
O sistema de back-end do parceiro tem dificuldades técnicas para combinar informações da frota em sistemas de diferentes países.
Para evitar que o sharding comprometa o desempenho do sistema, recomendamos o seguinte para cada sistema de micromobilidade:
Sem dock: recomendamos manter o número de fragmentos no mínimo e fazer com que cada fragmento seja o maior possível. Cada fragmento precisa abranger uma área de serviço geográfica pelo menos do tamanho de uma área metropolitana ou maior.
Ancorado: o sharding é permitido, e os parceiros são incentivados a fazer o sharding do feed por áreas metropolitanas.
Regras gerais
Cada fragmento precisa conter um conjunto completo de arquivos GBFS que podem descrever totalmente o sistema e ser usados de forma independente.
Todas as informações relevantes precisam estar em um único fragmento, e não é permitido fazer referências cruzadas com outros fragmentos. Por exemplo, um veículo sem dock no Shard A não pode fazer referência a um plano de preços do sistema do Shard B. Em vez disso, o plano de preços precisa ser definido no Shard A.
Todos os fragmentos precisam ser não conflitantes. Se um veículo sem dock ou uma estação com dock for apresentado em dois fragmentos diferentes, ele será tratado como duas entidades separadas, e as informações duplicadas serão apresentadas aos usuários.
As geocercas definidas em um fragmento não podem se sobrepor às definidas em um fragmento separado.
As geocercas não podem usar uma organização no sentido anti-horário que faça referência a áreas fora do polígono.