피드 제공 가이드라인

이 가이드에서는 마이크로모션 피드가 생성된 후 Google에 마이크로피드 피드를 제공하는 방법을 설명합니다. 피드를 만드는 방법에 대한 설명은 참조 탭의 사양을 참조하세요.

피드 가이드라인

생성된 마이크로모빌 피드를 Google에 전송하는 프로세스의 일부로 다음 프로세스 및 가이드라인을 숙지하세요.

  • 해당하는 경우 자전거 재고 및 동적 요금 데이터가 최신 상태인지 확인합니다. 이렇게 하려면 30초마다 새 피드 버전을 GBFS 피드 호스트에 업로드해야 합니다. 또한 데이터 검색 지연 시간이 30초를 초과해서는 안 됩니다.

  • Google에 피드를 전송하려면 HTTP GET을 지원해야 합니다.

HTTP GET으로 피드 전송

Google은 HTTPS GET 요청으로 구성된 위치에서 피드를 가져오고 다음 인증 방법을 지원합니다.

  • HTTP 다이제스트 인증: 이를 구현하는 경우 구성된 사용자 이름과 비밀번호를 마이크로모빌리티 파트너 지원팀에 이메일로 보냅니다.
  • 커스텀 HTTP 헤더 필드: 이 필드가 지원되려면 Google에 대한 요청의 일부로 필요한 헤더 필드와 값을 전송합니다.
  • GET 매개변수: GET 매개변수가 추가로 필요한 경우 이메일을 Micromobility 파트너 지원팀에 보내기 전에 호스트 주소에 추가합니다.

전송 중에 파일 크기를 최적화하기 위해 Google은 HTTP 헤더에서 gzip 압축을 지원합니다. 특히 Google은 HTTP 요청 헤더에 Accept-Encoding: gzip, deflate를 전송하고 HTTP 헤더 Content-Encoding: gzip가 포함된 응답을 허용합니다.

호스트 위치와 세부정보를 확인한 후 구성 세부정보를 마이크로모빌리티 파트너 지원팀에 이메일로 보냅니다.

피드 샤딩

피드를 샤딩하려면 전체 피드를 교차하지 않는 여러 하위 세트로 나누세요. 백엔드 시스템, Fleet 유형, 크기에 따라 샤딩이 필요할 수 있습니다.

피드를 샤딩하는 시기와 방법에 대한 기술적 세부정보는 참조 섹션의 피드 샤딩을 참고하세요.

Google은 HTTP GET을 통한 피드 전송에 설명된 것과 동일한 메커니즘을 사용하여 샤딩된 피드와 샤딩되지 않은 피드를 모두 가져옵니다.

각 샤드의 호스트 위치와 세부정보를 결정한 후 샤드의 구성 세부정보와 샤드를 Micromobility 파트너 지원에 이메일로 전송합니다.