Panduan ini menjelaskan cara memberikan feed Mikromobilitas Anda ke Google setelah feed tersebut dibuat. Untuk mengetahui deskripsi tentang cara membuat feed, lihat spesifikasi di tab Referensi.
Panduan feed
Sebagai bagian dari proses pengiriman feed Mikromobilitas yang dihasilkan ke Google, perhatikan proses dan panduan berikut:
Pastikan data ketersediaan sepeda dan tarif dinamis, jika ada, sudah yang terbaru. Untuk melakukannya, Anda harus mengupload versi feed baru ke host feed GBFS setiap 30 detik. Selain itu, latensi untuk mengambil data tidak boleh lebih dari 30 detik.
Untuk mengirimkan feed ke Google, Anda harus mendukung HTTP GET.
Penayangan feed dengan HTTP GET
Google mengambil feed dari lokasi yang dikonfigurasi dengan permintaan HTTPS GET
dan mendukung metode autentikasi berikut:
- Autentikasi Digest HTTP: Jika Anda menerapkan ini, kirimkan email yang berisi nama pengguna dan sandi yang dikonfigurasi ke Dukungan partner micromobility.
- Kolom header HTTP kustom: Agar ini didukung, sebagai bagian dari permintaan Anda ke Google, kirimkan kolom header dan nilai yang diperlukan.
- Parameter GET: Jika parameter GET tambahan diperlukan, tambahkan ke alamat host sebelum Anda mengirimkannya melalui email ke dukungan partner Micromobility.
Untuk mengoptimalkan ukuran file selama transfer, Google mendukung kompresi gzip di header HTTP. Secara khusus, Google mengirim Accept-Encoding: gzip, deflate di header permintaan HTTP dan menerima respons dengan header HTTP Content-Encoding: gzip.
Setelah menentukan lokasi dan detail host, kirimkan detail konfigurasi melalui email ke Dukungan partner mobilitas mikro.
Penyusunan feed
Membagi feed adalah memecah seluruh feed menjadi beberapa subset yang tidak beririsan. Bergantung pada sistem backend, jenis, dan ukuran armada Anda, sharding mungkin diperlukan.
Untuk mengetahui detail teknis tentang kapan dan cara memecah feed, lihat Pemecahan feed di bagian Referensi.
Google akan menggunakan mekanisme yang sama untuk mengambil feed yang di-shard dan yang tidak di-shard seperti yang dijelaskan dalam Pengiriman feed dengan HTTP GET.
Setelah Anda menentukan lokasi dan detail host untuk setiap shard, kirim email berisi detail konfigurasi setiap shard beserta area metropolitan yang dicakup shard tersebut ke Dukungan partner mobilitas mikro.