Ogólna specyfikacja pliku danych transportu publicznego (GTFS) to istniejący format harmonogramów transportu publicznego i powiązanych informacji geograficznych. Integracja oparta na GTFS korzysta z GTFS i rozszerzeń Google Transit Ticketing, aby wykonać krok 1 integracji z usługą Transport podróży – dostarczyć plik danych statycznych.
Interfejs Partner Server API będzie używać identyfikatorów, takich jak ticketing_trip_id, które są dostarczane przez GTFS, więc przed użyciem interfejsu API musi istnieć prawidłowy plik danych GTFS.
Aby przesłać prawidłowy plik danych GTFS, wykonaj te czynności:
Tworzenie statycznego pliku danych GTFS
Aby umożliwić użytkownikom wyszukiwanie i znajdowanie tras oraz rozkładów jazdy w przypadku podróży międzymiastowych za pomocą integracji opartej na GTFS, partnerzy muszą udostępnić plik danych GTFS. Dane GTFS będą zawierać statyczne informacje o rozkładach jazdy, trasach i biletach, które Google wykorzystuje do łączenia się z interfejsem API partnera.
1. Tworzenie konta Transit
Jeśli nie zostało to jeszcze zrobione, zapoznaj się z artykułem Wprowadzenie do Transportu publicznego Google i użyj formularza, aby poprosić o utworzenie konta. Po zakończeniu weryfikacji utworzymy konto i udostępnimy Ci panel GTFS. Więcej informacji o tym, jak uzyskać dostęp do panelu i go skonfigurować, znajdziesz w artykule Otwieranie panelu partnera Transportu publicznego.
2. Tworzenie pliku danych GTFS z rozszerzeniami
Utwórz plik danych GTFS, który zawiera wymagane sekcje rozszerzeń sprzedaży biletów Transportu publicznego Google (więcej informacji znajdziesz w sekcji dotyczącej rozszerzeń GTFS). Aby zapewnić użytkownikom jak najlepsze wrażenia, zapoznaj się z wymaganiami dotyczącymi jakości GTFS i sprawdzonymi metodami i postępuj zgodnie z nimi.
3. Nadawanie nazwy plikowi danych
Zalecana konwencja nazewnictwa pliku danych to:agency-region-country_code, np. gbus-ca-us lubagency-country_code, jeśli region nie jest wymagany, np.gbus-br. W przypadku testowych plików danych zalecana konwencja nazewnictwa to:test-agency-country_code, np. test-gbus-ca-us lub test-gbus-br.
4. Przesyłanie i aktualizowanie pliku danych
Aby przesłać i zaktualizować dane GTFS, postępuj zgodnie z instrukcjami w tym przewodniku. Za każdym razem, gdy dane zostaną przesłane, zostaną poddane automatycznej weryfikacji (trwa to do 30 minut) i wygenerowany zostanie raport weryfikacji. Przed przejściem do następnego kroku popraw błędy.
5. Prośba o środowisko podglądu
Gdy dane GTFS przejdą weryfikację, postępuj zgodnie z instrukcjami w artykule Sprawdzanie informacji w pliku danych za pomocą podglądu prywatnego, aby włączyć środowisko podglądu. Po włączeniu przesłane dane pliku danych będą widoczne w Mapach Google dla dozwolonych użytkowników. Na tym etapie dane GTFS można też wykorzystać do testowania na serwerze API.
6. Prośba o sprawdzenie jakości przed wprowadzeniem na rynek
Po rozwiązaniu wszystkich problematycznych ostrzeżeń i problemów z jakością danych w środowisku podglądu przed publicznym udostępnieniem wymagane jest ostateczne sprawdzenie jakości przez Google. Problemy wykryte w procesie kontroli jakości będą widoczne w panelu. Gdy wszystkie nierozwiązane problemy zostaną wyeliminowane, plik GTFS będzie gotowy do uruchomienia.
7. Uruchamianie karty
Instrukcje dotyczące udostępniania pliku danych znajdziesz w artykule Uruchamianie pliku danych.