Z tego przewodnika dowiesz się, jak przesłać do Google plik danych dotyczący mikromobilności po jego wygenerowaniu. Opis tworzenia pliku danych znajdziesz w specyfikacjach na karcie Informacje.
Wskazówki dotyczące kanału
W ramach procesu przesyłania wygenerowanego pliku danych dotyczącego mikromobilności do Google pamiętaj o tych zasadach i wytycznych:
Upewnij się, że dane o dostępności rowerów i dynamicznych cenach są aktualne (w odpowiednich przypadkach). Aby to zrobić, musisz przesyłać nową wersję pliku danych do hosta pliku danych GBFS co 30 sekund. Opóźnienie w pobieraniu danych nie może przekraczać 30 sekund.
Aby dostarczyć plik danych do Google, musisz obsługiwać HTTP GET.
Przesyłanie pliku danych za pomocą żądania HTTP GET
Google pobiera plik danych ze skonfigurowanej lokalizacji za pomocą HTTPS GETżądania i obsługuje te metody uwierzytelniania:
- Uwierzytelnianie HTTP na podstawie skrótu: jeśli wdrożysz tę metodę, wyślij e-maila z konfigurowaną nazwą użytkownika i hasłem do zespołu pomocy dla partnerów w zakresie mikromobilności.
- Niestandardowe pola nagłówka HTTP: aby ta funkcja była obsługiwana, w ramach żądania wysyłanego do Google prześlij wymagane pola nagłówka i wartości, których potrzebujesz.
- Parametry GET: jeśli wymagane są dodatkowe parametry GET, dodaj je do adresu hosta, zanim wyślesz go e-mailem do zespołu pomocy ds. mikromobilności.
Aby zoptymalizować rozmiar pliku podczas przesyłania, Google obsługuje kompresję gzip w nagłówku HTTP. W szczególności Google wysyła Accept-Encoding: gzip, deflate w nagłówku żądania HTTP i akceptuje odpowiedź z nagłówkiem HTTPContent-Encoding: gzip.
Po określeniu lokalizacji hosta i szczegółów wyślij e-maila ze szczegółami konfiguracji do zespołu pomocy dla partnerów w zakresie mikromobilności.
Dzielenie pliku danych
Fragmentacja pliku danych polega na podzieleniu go na kilka nieprzecinających się podzbiorów. W zależności od systemów backendowych, typów i rozmiarów floty może być konieczne dzielenie.
Szczegółowe informacje techniczne o tym, kiedy i jak dzielić plik danych, znajdziesz w sekcji Dzielenie pliku danych w części „Informacje”.
Google będzie używać tego samego mechanizmu do pobierania zarówno podzielonych, jak i niepodzielonych plików danych, zgodnie z opisem w sekcji Dostarczanie plików danych za pomocą żądania HTTP GET.
Po określeniu lokalizacji hosta i szczegółów każdego fragmentu wyślij e-maila do zespołu pomocy dla partnerów w zakresie mikromobilności z informacjami o konfiguracji każdego fragmentu oraz obszarami metropolitalnymi, które obejmuje.