Ogólna specyfikacja pliku danych o transporcie publicznym (GTFS) to istniejący format harmonogramów transportu publicznego i powiązanych informacji geograficznych. Integracja oparta na GTFS korzysta z GTFS i rozszerzeń Google dotyczących biletów transportu publicznego, aby wykonać krok 1 integracji transportu publicznego, czyli otrzymać plik danych statycznych.
Interfejs Partner Server API korzysta z identyfikatorów takich jak ticketing_trip_id dostarczanych przez GTFS. Dlatego zanim będzie można użyć interfejsu API, musi istnieć prawidłowy plik danych GTFS.
Aby podać prawidłowy plik danych GTFS, wykonaj podane niżej czynności.
Tworzenie statycznego pliku danych GTFS
Aby umożliwić użytkownikom wyszukiwanie i wyszukiwanie tras oraz harmonogramów podróży międzymiastowych za pomocą integracji opartej na GTFS, partnerzy potrzebują pliku danych GTFS. Dane w pliku danych GTFS będą zawierać statyczne informacje o harmonogramach, trasach i zgłoszeniach. Informacje te są następnie wykorzystywane przez Google do łączenia się z interfejsem API partnera.
1. Tworzenie konta transportu publicznego
Jeśli nie zostało to jeszcze zrobione, przejdź do sekcji Pierwsze kroki z Transportem publicznym Google i użyj formularza, aby poprosić o utworzenie konta. Po zakończeniu weryfikacji zostanie utworzone konto i udostępniony zostanie panel GTFS. Więcej informacji o tym, jak uzyskać dostęp do panelu i go skonfigurować, znajdziesz w artykule Uzyskiwanie dostępu do panelu partnera Transportu publicznego.
2. Tworzenie pliku danych GTFS z rozszerzeniami
Utwórz plik danych GTFS zawierający wymagane sekcje rozszerzeń biletów transportu publicznego Google (więcej informacji znajdziesz w sekcji dotyczącej rozszerzeń GTFS). Aby zadbać o jak najlepsze wrażenia użytkowników, zapoznaj się z wymaganiami dotyczącymi jakości i sprawdzonymi metodami GTFS oraz przestrzegaj ich.
3. nazewnictwo kanału,
Zalecana konwencja nazewnictwa plików danych to: agency-region-country_code, np. gbus-ca-us, lub agency-country_code, jeśli region nie jest wymagany, np. gbus-br. W przypadku testowych plików danych zalecana konwencja nazewnictwa plików danych to: test-agency-country_code, np. test-gbus-ca-us lub test-gbus-br.
4. Przesyłanie i aktualizowanie pliku danych
Aby przesyłać i aktualizować dane GTFS, postępuj zgodnie z instrukcjami dotyczącymi publikowania danych GTFS w pliku danych. Za każdym razem, gdy przesyłasz dane, zostaną poddane automatycznej weryfikacji (zajmie to do 30 minut) i zostanie wygenerowany raport weryfikacji. Zanim przejdziesz do następnego kroku, popraw wszystkie błędy.
5. Poproś o środowisko podglądu
Gdy dane GTFS przejdą weryfikację, postępuj zgodnie z instrukcjami testowania danych z pliku danych za pomocą prywatnej wersji testowej, aby włączyć środowisko podglądu. Po włączeniu przesłane dane będą widoczne w Mapach Google dla dozwolonych użytkowników. W tym momencie dane GTFS mogą być też używane do testowania z wykorzystaniem serwera API.
6. Wysyłam prośbę o sprawdzenie kontroli jakości wprowadzenia na rynek
Po rozwiązaniu wszelkich problemów z ostrzeżeniami i problemami z jakością danych w środowisku testowym przed publicznym udostępnieniem wymagana jest końcowa kontrola jakości Google. Problemy znalezione w trakcie procesu kontroli jakości będą widoczne w panelu. Po rozwiązaniu wszystkich nierozwiązanych problemów GTFS będzie gotowa do uruchomienia.
7. Uruchamianie kanału
Instrukcje, jak udostępnić kanał publicznie, znajdziesz w sekcji Wprowadzanie kanału.