이 가이드에서는 생성된 후 Google에 마이크로 모빌리티 피드를 제공하는 방법을 설명합니다. 피드를 만드는 방법에 관한 설명은 참조 탭의 사양을 참고하세요.
피드 가이드라인
생성된 마이크로 모빌리티 피드를 Google에 전송하는 프로세스의 일환으로 다음 프로세스와 가이드라인을 숙지하세요.
자전거 이용 가능 여부와 동적 요금 데이터가 최신 상태인지 확인합니다(해당하는 경우). 이렇게 하려면 30초마다 GBFS 피드 호스트에 새 피드 버전을 업로드해야 합니다. 또한 데이터를 가져오는 지연 시간이 30초를 초과해서는 안 됩니다.
피드를 Google에 제공하려면 HTTP GET을 지원해야 합니다.
HTTP GET을 사용한 피드 전송
Google은 구성된 위치에서 HTTPS GET 요청으로 피드를 가져오며 다음 인증 방법을 지원합니다.
- HTTP 다이제스트 인증: 이를 구현하는 경우 구성된 사용자 이름과 비밀번호를 Micromobility 파트너 지원팀에 이메일로 보내세요.
- 맞춤 HTTP 헤더 필드: 이 기능을 지원하려면 Google에 보내는 요청의 일부로 필요한 헤더 필드와 값을 전송하세요.
- GET 매개변수: 추가 GET 매개변수가 필요한 경우 Micromobility partner support에 이메일을 보내기 전에 호스트 주소에 추가하세요.
전송 중 파일 크기를 최적화하기 위해 Google은 HTTP 헤더에서 gzip 압축을 지원합니다. 특히 Google은 HTTP 요청 헤더에 Accept-Encoding: gzip, deflate를 전송하고 HTTP 헤더 Content-Encoding: gzip로 응답을 수락합니다.
호스트 위치와 세부정보를 확인한 후 구성 세부정보를 Micromobility 파트너 지원팀에 이메일로 보냅니다.
피드 샤딩
피드를 샤딩한다는 것은 전체 피드를 교차하지 않는 여러 하위 집합으로 나누는 것입니다. 백엔드 시스템, 차량 유형, 크기에 따라 샤딩이 필요할 수 있습니다.
피드를 샤딩하는 시기와 방법에 관한 기술적 세부정보는 참조 섹션의 피드 샤딩을 참고하세요.
Google은 HTTP GET을 사용한 피드 전송에 설명된 대로 샤딩된 피드와 샤딩되지 않은 피드를 모두 가져오는 데 동일한 메커니즘을 사용합니다.
각 샤드의 호스트 위치와 세부정보를 확인한 후 샤드가 포함하는 권역과 함께 각 샤드의 구성 세부정보를 Micromobility partner support에 이메일로 전송합니다.