Trasa transportu publicznego zawiera wskazówki dojazdu z wykorzystaniem dostępnych w danym regionie środków transportu publicznego. Opcje transportu mogą obejmować m.in. autobusy, metro i pociągi. Trasa transportu publicznego zwykle zawiera też instrukcje dotyczące dojścia do stacji transportu publicznego, z niej i między nimi. Trasa transportu publicznego zwykle wymaga użycia więcej niż 1 środka transportu, dlatego sposób wysyłania żądania trasy i niektóre części odpowiedzi są inne.
Czym różnią się trasy tranzytowe od innych tras
Trasy transportu publicznego, o które możesz poprosić, ustawiając travelModeTRANSIT, różnią się od tras z użyciem innych opcji środków transportu.
Nie możesz żądać tych samych obiektów i opcji, a odpowiedź zwraca inne pola w porównaniu z innymi ścieżkami.
W interfejsie Routes API kroki zawsze odpowiadają jednej instrukcji nawigacyjnej w przypadku wszystkich rodzajów transportu. Każda instrukcja nawigacji to krok. Odpowiedź dotycząca trasy transportu publicznego jest bardzo podobna do odpowiedzi dotyczących tras z użyciem innych środków transportu, ale występują tu pewne istotne różnice:
| Prośba o różnice | Różnice w odpowiedziach |
|---|---|
| Nie możesz określić pośrednich punktów trasy. | Zawiera szczegóły dotyczące transportu publicznego. |
| Nie można uzyskać tras przyjaznych dla środowiska | Zawiera metadane każdego trybu podróży, które zawierają podsumowanie kroków dla tego trybu podróży w polu stepsOverview (aby poprosić o te metadane, użyj maski pola stepsOverview). |
| Nie można określić, jak i czy uwzględniać dane o ruchu | |
| Nie można określić funkcji trasy, których należy unikać | |
Można określić tylko wartość transitPreferences. Więcej informacji znajdziesz w sekcji TransitPreference. |
Aby wyznaczyć trasę transportem publicznym
- Ustaw miejsce początkowe i miejsce docelowe.
- Ustaw wartość
travelModenaTRANSIT. - Dodaj odpowiednie maski pól, aby uzyskać potrzebną odpowiedź. Zobacz Żądanie potrzebnych pól trasy transportu publicznego.
- W razie potrzeby ustaw parametry opcjonalne. Zobacz Ustawianie parametrów trasy transportu publicznego
Poproś o pola trasy transportu publicznego, których potrzebujesz
Poproś o pola trasy transportu publicznego, których potrzebujesz, używając masek pól. W tabeli poniżej znajdziesz kilka sugerowanych odpowiedzi dotyczących trasy transportu publicznego oraz maskę pola, której należy użyć, aby o nie poprosić.
| Aby poprosić o te informacje: | Użyj tej maski pola |
|---|---|
| wszystkie szczegóły trasy, | * |
| Szczegóły transportu publicznego na poszczególnych etapach trasy. | legs |
| szacunkowa opłata za każdy etap trasy i zlokalizowana szacunkowa opłata; | travelAdvisory |
| Zlokalizowany tekst dotyczący czasu trwania i odległości | localizedValues |
Ustawianie parametrów trasy transportu publicznego
Oto parametry związane z trasami transportu publicznego:
| Aby to zrobić: | Używanie tego parametru | Uwagi |
|---|---|---|
| Wybierz środek transportu | travelMode: "TRANSIT" |
Wymagane. Więcej informacji |
| Ustawianie godziny przyjazdu lub odjazdu | arrivalTime: new Date(yyyy-mm-ddThh:mm:ssZ)
LUB departureTime: new Date(yyyy-mm-ddThh:mm:ssZ) |
Opcjonalnie: Możesz określić godzinę przyjazdu lub wyjazdu. Jeśli nie podasz żadnego z tych czasów, wartość departureTime będzie domyślnie ustawiona na bieżący czas wykonania (now). Czas przyjazdu i odjazdu możesz ustawić tylko w tym przedziale czasu, przy czym bieżący czas wykonania (now) jest czasem odniesienia:
Date.
Uwaga: rozkłady jazdy transportu publicznego często się zmieniają, dostępne przejazdy mogą się zmieniać z czasem, a w przypadku prognoz z dużym wyprzedzeniem nie ma gwarancji uzyskania spójnych wyników. |
| Uwzględnij trasy alternatywne | computeAlternativeRoutes: true |
Opcjonalnie: Ustaw wartość „true”, aby computeRoutes obliczała maksymalnie 3 dodatkowe trasy, jeśli są dostępne.
Więcej informacji |
| Określanie preferencji dotyczących rodzaju transportu | transitPreference: {allowedTransitModes: ["BUS", "SUBWAY", "TRAIN", "LIGHT_RAIL", "RAIL"]}
Uwaga: jeśli określisz preferowany środek transportu, zwrócone trasy mogą nadal korzystać z innych środków transportu, a nawet tylko z nich, w zależności od skuteczności trasy i dostępności preferowanego środka transportu. |
Opcjonalnie: Określ preferowane środki transportu publicznego. Więcej informacji |
| Określanie preferencji dotyczących trasy transportu publicznego | transitPreference: {routingPreference: "LESS_WALKING|FEWER_TRANSFERS"} |
Opcjonalnie: Określ preferencje dotyczące routingu transportu publicznego. Więcej informacji |
Przykładowe żądanie
Poniższy przykład pokazuje, jak wysłać żądanie dotyczące trasy transportu publicznego:
const request = { origin: 'Hunters Point San Francisco, CA 94124', destination: '201 Marine Dr, San Francisco, CA 94129', travelMode: 'TRANSIT', departureTime: new Date(), transitPreference: { allowedTransitModes: ['BUS', 'SUBWAY', 'TRAIN', 'LIGHT_RAIL', 'RAIL'], routingPreference: 'FEWER_TRANSFERS', // Alternatively, 'LESS_WALKING'. }, fields: ['path', 'legs', 'travelAdvisory', 'localizedValues'], };