피드 샤딩

피드를 샤딩한다는 것은 전체 피드를 교차하지 않는 여러 하위 집합으로 나누는 것입니다. 백엔드 시스템, 차량 유형, 크기에 따라 샤딩이 필요할 수 있습니다.

샤딩 시기

  • 피드의 크기가 너무 크면 (50MB 초과) 파트너가 데이터 업데이트 요구사항을 따르려고 할 때 성능 문제가 발생할 수 있습니다.

  • 파트너의 백엔드 시스템에 여러 국가의 시스템에서 차량 정보를 결합하는 데 기술적 어려움이 있습니다.

  • 샤딩으로 인해 시스템 성능이 저하되지 않도록 각 마이크로 모빌리티 시스템에 다음을 권장합니다.

    • 도크 없음: 샤드 수를 최소로 유지하고 각 샤드를 논리적으로 가능한 한 크게 만드는 것이 좋습니다. 각 샤드는 최소한 도시권역 크기 이상의 지리적 서비스 영역을 포함해야 합니다.

    • 도킹됨: 샤딩이 허용되며 파트너는 권역별로 피드를 샤딩하는 것이 좋습니다.

일반 규칙

  • 각 샤드에는 시스템을 완전히 설명하고 독립적으로 사용할 수 있는 완전한 GBFS 파일 세트가 포함되어야 합니다.

  • 모든 관련 정보는 단일 샤드에 포함되어야 하며 다른 샤드와의 교차 참조는 허용되지 않습니다. 예를 들어 샤드 A의 도크리스 차량은 샤드 B의 시스템 요금제를 참조할 수 없습니다. 대신 요금제는 샤드 A 내에서 정의해야 합니다.

  • 모든 샤드는 교차하지 않아야 합니다. 도크 없는 차량 또는 도크형 스테이션이 서로 다른 두 샤드에 표시되는 경우 두 개의 별도 항목으로 취급되며 중복 정보가 사용자에게 표시됩니다.

  • 한 샤드에 정의된 지오펜스는 별도의 샤드에 정의된 지오펜스와 중복되면 안 됩니다.

  • 지오펜스는 다각형 외부 영역을 참조하는 시계 반대 방향 배열을 사용하면 안 됩니다.