このガイドでは、マイクロモビリティ フィードを生成した後に Google に提供する方法について説明します。フィードの作成方法については、[リファレンス] タブの仕様をご覧ください。
フィードのガイドライン
生成されたマイクロモビリティ フィードを Google に送信するプロセスの一環として、次のプロセスとガイドラインに注意してください。
自転車の利用状況と動的料金のデータ（該当する場合）が最新であることを確認します。そのためには、30 秒ごとに新しいフィード バージョンを GBFS フィードホストにアップロードする必要があります。また、データを取得するレイテンシは 30 秒を超えてはなりません。
フィードを Google に配信するには、HTTP GET をサポートする必要があります。
HTTP GET を使用したフィード配信
Google は、構成された場所から HTTPS GET リクエストでフィードを取得し、次の認証方法をサポートしています。
- HTTP ダイジェスト認証: これを実装する場合は、構成したユーザー名とパスワードを Micromobility パートナー サポートにメールで送信してください。
- カスタム HTTP ヘッダー フィールド: これをサポートするには、Google へのリクエストの一部として、必要なヘッダー フィールドと値を送信します。
- GET パラメータ: GET パラメータを追加する必要がある場合は、マイクロモビリティ パートナー サポートにメールで送信する前に、ホスト アドレスに追加します。
転送中のファイルサイズを最適化するため、Google は HTTP ヘッダーで gzip 圧縮をサポートしています。具体的には、Google は HTTP リクエスト ヘッダーで Accept-Encoding: gzip, deflate を送信し、HTTP ヘッダー Content-Encoding: gzip を含むレスポンスを受け入れます。
ホストの場所と詳細を特定したら、構成の詳細を Micromobility パートナー サポートにメールで送信します。
フィード シャーディング
フィードをシャーディングするとは、フィード全体を複数の重複しないサブセットに分割することです。バックエンド システム、フリートの種類、サイズによっては、シャーディングが必要になることがあります。
フィードをシャーディングするタイミングと方法に関する技術的な詳細については、リファレンス セクションのフィードのシャーディングをご覧ください。
Google は、HTTP GET によるフィード配信で説明されているように、同じメカニズムを使用してシャード化されたフィードとシャード化されていないフィードの両方を取得します。
各シャードのホストの場所と詳細を決定したら、各シャードの構成の詳細と、シャードがカバーするメトロエリアを Micromobility パートナー サポートにメールで送信します。