Panduan ini menjelaskan cara memberikan feed Mikro-mobilitas Anda ke Google setelah dibuat. Untuk mengetahui deskripsi tentang cara membuat feed, lihat spesifikasinya di tab Reference.
Panduan feed
Sebagai bagian dari proses untuk mengirim feed Micromobilitas yang dihasilkan ke Google, perhatikan proses dan panduan berikut:
Pastikan ketersediaan sepeda dan data tarif dinamis, jika berlaku, 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.
Pengiriman 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, kirim email ke nama pengguna dan sandi yang dikonfigurasi ke dukungan partner Micromobility.
- Kolom header HTTP kustom: Agar didukung, sebagai bagian dari permintaan Anda ke Google, kirimkan kolom dan nilai header wajib yang diperlukan.
- Parameter GET: Jika diperlukan parameter GET tambahan, 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 mengirimkan Accept-Encoding: gzip, deflate di
header permintaan HTTP dan menerima respons dengan header HTTP
Content-Encoding: gzip.
Setelah Anda menentukan lokasi host dan detailnya, kirim detail konfigurasi melalui email ke dukungan partner Micromobility.
Sharding feed
Melakukan sharding feed adalah membagi keseluruhan feed menjadi beberapa subset yang tidak berpotongan. Bergantung pada sistem backend Anda, jenis armada, dan ukuran, sharding mungkin diperlukan.
Untuk mengetahui detail teknis mengenai waktu dan cara melakukan sharding feed, lihat sharding feed di bagian Referensi.
Google akan menggunakan mekanisme yang sama untuk mengambil feed yang di-sharding dan tidak di-sharding seperti yang dijelaskan dalam Pengiriman feed dengan HTTP GET.
Setelah Anda menentukan lokasi host dan detail untuk setiap shard, kirimkan detail konfigurasi setiap shard melalui email ke area metro yang dicakup ke shard ke dukungan partner Micromobility.