W tym przewodniku opisujemy, jak przesłać do Google plik danych mikromobilności po jego wygenerowaniu. Więcej informacji o tworzeniu pliku danych znajdziesz w opisie na karcie Informacje.
Wskazówki dotyczące kanału
W ramach procesu wysyłania do Google wygenerowanego pliku danych mikromobilność pamiętaj o tych procesach i wytycznych:
Sprawdź, czy dostępność rowerów i dane o cenach dynamicznych są aktualne. Aby to zrobić, co 30 sekund musisz przesłać nową wersję pliku danych do hosta plików GBFS. Czas oczekiwania na pobranie danych nie może przekraczać 30 sekund.
Aby przesłać plik danych do Google, musisz obsługiwać protokół HTTP GET.
Dostarczanie pliku danych za pomocą HTTP GET
Google pobiera plik danych ze skonfigurowanej lokalizacji za pomocą żądania HTTPS GET
i obsługuje te metody uwierzytelniania:
- Uwierzytelnianie uwierzytelniania HTTP: jeśli zastosujesz tę funkcję, wyślij e-maila do skonfigurowanej nazwy użytkownika i hasła do zespołu pomocy mikromobilności.
- Niestandardowe pola nagłówka HTTP: aby było to obsługiwane, w ramach żądania wysyłanego do Google wyślij wymagane pola i wartości.
- Parametry GET: jeśli wymagane są dodatkowe parametry GET, dodaj je do adresu hosta, zanim wyślesz go do zespołu pomocy mikromobilności.
Aby zoptymalizować rozmiar pliku podczas transferu, Google obsługuje kompresję gzip w nagłówku HTTP. Google w szczególności wysyła Accept-Encoding: gzip, deflate
w nagłówku żądania HTTP
i akceptuje odpowiedź z nagłówkiem HTTP
Content-Encoding: gzip
.
Gdy ustalisz lokalizację i szczegóły hosta, wyślij e-maila ze szczegółami konfiguracji do zespołu pomocy mikromobilności.
Fragmentacja w pliku danych
Aby fragmentować plik danych, musisz podzielić cały kanał na wiele nieprzecinających się podzbiorów. W zależności od systemów backendu, typów flot i rozmiarów może być konieczna fragmentacja.
Szczegółowe informacje na temat czasu i fragmentacji pliku danych znajdziesz w sekcji Fragmentacja pliku danych w sekcji Pliki referencyjne.
Google będzie korzystać z tego samego mechanizmu do pobierania zarówno fragmentowanych, jak i niefragmentowanych plików danych, zgodnie z opisem w sekcji Dostawa plików za pomocą HTTP GET.
Po ustaleniu lokalizacji hosta i deklaracji w poszczególnych fragmentach wyślij e-maila ze szczegółami konfiguracji każdego fragmentu i obszarami miejskimi, które obejmują ten fragment, do zespołu pomocy mikromobilności.