Google Toplu Taşıma GTFS Planı Referansı ve Farklılıklar

Not: Resmi kurallı Genel Toplu Taşıma Feed Spesifikasyonu'nu (GTFS) görmek için gtfs.org adresine gidin. Bu sayfa, 21 Aralık 2022 itibarıyla resmi spesifikasyona uygundur. Bu tarihten sonraki güncellemeler desteklenmez.

Bu sayfada, resmi GTFS programı ile Google Transit'in spesifikasyonu aşağıdaki alanlarda uygulanması arasındaki temel farklılıklar açıklanmaktadır:

• Yoksayılan resmi spesifikasyonlar: Bu alanlar resmi GTFS'nin bir parçasıdır. Google Transit bu verileri hatasız bir şekilde alır ancak proaktif olarak kullanmaz.

• Farklı yorum: Bu alanlar, resmi GTFS'nin Google Transit tarafından bu bölümlerin GTFS tanımından farklı şekilde yorumlandığı bölümlerini içerir.

• Deneysel destek: Bu alanlar, Google Transit'in uygulamasında deneyseldir. Yeni bir deneysel alan uygulamak istiyorsanız Google Toplu Taşıma Ekibi ile iletişime geçin.

• Google Transit tarafından desteklenen uzantı: Bu uzantı, resmi GTFS'nin bir parçası değildir. Toplu taşıma tarafından desteklenen uzantı hem herkese açık uzantıları hem de Google Toplu Taşıma'ya özel uzantıları içerir. Tüm iş ortakları, bu bilgileri feed'lerinde toplu taşımaya gönderebilir.

Statik toplu taşıma

Aşağıdaki bölümlerde, resmi GTFS ile Google Transit'in statik feed uygulaması arasındaki temel farklılıklar açıklanmaktadır.

Not: Resmi GTFS sitesinde (gtfs.org), statik toplu taşıma spesifikasyonları "GTFS Programı" olarak adlandırılır. Google Transit geliştirici sitesinde, "anlık" ile ayırt etmek için "statik" toplu taşıma terimini kullanırız.

Statik feed'lerde resmi spesifikasyonlar yoksayılır.

Toplu Taşıma tarafından yoksayılan bazı resmi spesifikasyonlar deneyseldir. Daha fazla bilgi edinmek için gtfs.org adresine gidin.

Tablo 1'de, statik feed'lerde toplu taşıma tarafından desteklenmeyen GTFS dosyaları listelenmiştir. Ayrıca, bu dosyalarda tanımlanan alanların hiçbiri Transit tarafından desteklenmez.

Tablo 1. Statik feed'lerde desteklenmeyen GTFS dosyaları

areas.txt

fare_leg_rules.txt

fare_products.txt

fare_transfer_rules.txt

levels.txt

stop_areas.txt

Tablo 2'de, statik feed'lerde toplu taşıma tarafından yoksayılan, GTFS tarafından tanımlanan tüm alanlar listelenmektedir.

Tablo 2. Statik feed'lerde yoksayılan GTFS alanları

Dosya adı	GTFS'de tanımlanan yoksayılan alan	Alan türü
fare_attributes.txt	payment_method	Enum
feed_info.txt	default_lang	Dil kodu
feed_info.txt	feed_publisher_name	Metin
pathways.txt	max_slope	Kayan
routes.txt	continuous_drop_off	Enum
routes.txt	continuous_pickup	Enum
routes.txt	network_id	Kimlik
routes.txt	route_desc	Metin
routes.txt	route_sort_order	Negatif olmayan tam sayı
stops.txt	level_id	Kimlik
stops.txt	stop_desc	Metin
stops.txt	stop_url	URL
stops.txt	tts_stop_name	Metin
trips.txt	bikes_allowed	Enum

Statik feed'lerde farklı yorumlama

Toplu Taşıma, GTFS tarafından tanımlanan belirli alanları kabul etse de bunları GTFS'den farklı şekilde yorumlar.

Tablo 3'te, Transit'in statik feed'lerde GTFS'de açıklananlardan farklı şekilde uyguladığı alanlar gösterilmektedir.

Tablo 3. Farklı şekilde uygulanan statik feed alanları

Dosya adı	GTFS'de tanımlanan alan	Alan türü	Google Transit tarafından zorunlu mu?	Google Transit uygulama ayrıntıları
fare_attributes.txt	transfers	Enum	Zorunlu	Google toplu taşıma uzantısı. Herkese açık GTFS, değerleri 0 ile 2 aralığına sınırlar. Google Toplu Taşıma, 0 ile 5 arasındaki değerleri kabul eder. Ücretle birlikte izin verilen maksimum aktarma sayısını belirlemek için bu alanı kullanın. Koltuk içi aktarımlar olarak da bilinen blok aktarımlar bu kapsamda değildir. Bir ücret için aktarma sayısıyla ilgili sınır belirlemek istemiyorsanız transfers alanını boş bırakın.
pathways.txt	pathway_mode	Enum	İsteğe bağlı	pathway_mode alanı belirtildiğinde boş bırakılırsa Google Toplu Taşıma bu alanı kabul eder ve bilinmeyen olarak değerlendirir.
stop_times.txt	arrival_time	Saat	Koşula bağlı olarak gerekli	Çalışma saatleri 00 ile 99 arasında değerlerle sınırlıdır. Bu, üç günlük geziler için fazlasıyla yeterlidir.
transfers.txt	transfer_type	Enum	Zorunlu	4 ve 5 değerleri desteklenmez ve yok sayılır. Google Transit; 0, 1, 2 ve 3 değerlerini destekler.
trips.txt	block_id	Kimlik	İsteğe bağlı	Daha fazla bilgi için Aktarımı engelleme örneği bölümüne bakın.

Statik feed'lerde deneysel destek

Bu kategoriye yeni deneysel alanlar entegre etmek için desteğe ihtiyacınız varsa Google Transit ile iletişime geçin.

Statik feed'lerde Google toplu taşıma tarafından desteklenen uzantılar

Tablo 4'te Google toplu taşıma uzantıları hakkında bilgi verilmektedir. Bu alanlar resmi GTFS'nin bir parçası değildir.

Tablo 4. Desteklenen statik feed uzantıları

Dosya adı	Alan	Alan türü	Google Transit tarafından zorunlu mu?	Google Transit uygulama ayrıntıları
fare_attributes.txt	ic_price	Kayan	İsteğe bağlı	Bu Google Transit uzantısı yalnızca Japonya'daki iş ortakları tarafından kullanılabilir. ic_price alanı, bu ücret için akıllı kartla ödenecek indirimli tutarı temsil eder. Bu ücret için indirim sağlanmıyorsa veya akıllı kart desteklenmiyorsa ic_price alanının değerinin -1 olması gerekir.
fare_rules.txt	contains_route_id	Kimlik	İsteğe bağlı	Google toplu taşıma uzantısı. Bu ücret yalnızca fare_id, origin_id ve destination_id sütunlarının bu kombinasyonundaki tüm satırlarda route_id değeriyle tanımlanan tam bir rota grubunu ziyaret eden seyahatler için geçerlidir. contains_route_id sütunu yoksa veya bu ücrete ait tüm değerleri boşsa ücret bu parametrede kısıtlanmamıştır. Fare için contains_route_id alanı sağlanırsa route_id alanı boş olmalıdır.
routes.txt	checkin_duration	Tamsayı	İsteğe bağlı	Google toplu taşıma uzantısı. checkin_duration alanı, yolcuların check-in yapmak ve uçağa binmek için planlanan kalkıştan kaç saniye önce gelmesi gerektiğini belirtir. Yolcu, aktarma yaparak kalkış noktasına bağlanıyorsa tanımlanan tüm aktarma süreleri checkin_duration değerini geçersiz kılar. checkin_duration değeri yalnızca genellikle toplu taşıma operatörü tarafından sağlanan bir öneridir. Bir yolcunun varıp araca binebileceği son ana dair kesin bilgi vermeyebilir.
routes.txt	route_type	Enum	Zorunlu	Google toplu taşıma uzantısı. Google Toplu Taşıma'nın GTFS tarafından kabul edilen route_type değer seçeneklerini nasıl genişlettiğini öğrenmek için Genişletilmiş GTFS rota türleri başlıklı makaleyi inceleyin.
stop_times.txt	stop_direction_name	Metin	İsteğe bağlı	Google toplu taşıma uzantısı. stop_direction_name alanı, seyahatin yolculara göre yönünü tanımlar. Yön, bu duraktan kalkış için direction_name değer olarak saklanır. stop_direction_name alanı boşsa bunun yerine toplu taşıma tarafından desteklenen trip_direction_name alanı kullanılır. Hem trip_direction_name hem de stop_direction_name alanları boşsa aktarma içe aktarıcısı bu alanları boş bırakır. Bu durumda iş ortakları bunun yerine stop_headsign veya trip_headsign değerini kullanabilir. stop_direction_name alanının değerleri büyük/küçük harfe duyarlı değildir.
stops.txt	signposted_as	Metin	İsteğe bağlı	Google toplu taşıma uzantısı. signposted_as alanı, platformun tabelasında yazan metni olduğu gibi içerir. Örneğin, "Merkeze doğru" ve "Doğu Yakası ve Brooklyn". GTFS platform_code alanı ve Toplu Taşıma Desteği signposted_as alanı aynı anda ayarlanabilir. platform_code ve signposted_as alanları arasındaki farklar şunlardır: Uzunluk. platform_code alanı genellikle 2 veya C gibi bir sayı ya da harf içerir. Dil. platform_code alanının dili yoktur ancak signposted_as değerlerinin çevirisi olabilir. Kararlılık. platform_code alanı, signposted_as alanından çok daha seyrek değişir.
stops.txt	vehicle_type	Tamsayı	İsteğe bağlı	Google toplu taşıma uzantısı. vehicle_type alanı, bir durakta kullanılan taşıt türlerini belirtir. Bu alan, hiyerarşik araç türü (HVT) rota türlerini kabul eder. HVT değerleri, Avrupa Taşımacılık Protokolü Uzmanları Grubu (TPEG) standardından türetilmiştir.
agency.txt	ticketing_deep_link_id	Kimlik	İsteğe bağlı	Google toplu taşıma bilet işlemleri uzantısı. agency.txt dosyasında ticketing_deep_link_id alanı, bu acentenin seyahatlerine bilet satmak için kullanılan derin bağlantıyı temsil eder.
routes.txt	ticketing_deep_link_id	Kimlik	İsteğe bağlı	Google toplu taşıma bilet işlemleri uzantısı. routes.txt dosyasında ticketing_deep_link_id alanı, bu rotanın seyahatlerine bilet satmak için kullanılan derin bağlantıyı temsil eder.
stop_times.txt	ticketing_stop_time_id	Kimlik	İsteğe bağlı	Google toplu taşıma bilet işlemleri uzantısı. stop_times.txt dosyasında varsa ticketing_stop_time_id alanı, derin bağlantılarla bilet işlemlerinin durdurulma zamanını temsil eden tanımlayıcının yerini alır.
stop_times.txt	ticketing_type	Enum	İsteğe bağlı	Google toplu taşıma bilet işlemleri uzantısı. ticketing_type alanı, bu durak zamanı için geçerli olan bilet türünü belirtir. Google Transit aşağıdaki değerleri kabul eder: Empty. Varsayılan: Gezi tarafından tanımlanır. 0. Yalnızca acentenin veya rotanın etkinleştirilmiş bir bilet işlemleri derin bağlantısı varsa kullanılabilir. 1. Kullanılamıyor.
ticketing_deep_links.txt	android_intent_uri	URI	İsteğe bağlı	Google toplu taşıma bilet işlemleri uzantısı. android_intent_uri alanı, Android'de derin bağlantı oluşturmak için kullanılan istek URI'sini temsil eder.
ticketing_deep_links.txt	ios_universal_link_url	URL	İsteğe bağlı	Google toplu taşıma bilet işlemleri uzantısı. ios_universal_link_url alanı, iOS'te derin bağlantı oluşturmak için kullanılan geçiş bağlantısı URL'sini temsil eder.
ticketing_deep_links.txt	ticketing_deep_link_id	Kimlik	Zorunlu	Google toplu taşıma bilet işlemleri uzantısı. ticketing_deep_link_id alanı, derin bağlantının tanımlayıcısını temsil eder.
ticketing_deep_links.txt	web_url	URL	İsteğe bağlı	Google toplu taşıma bilet işlemleri uzantısı. web_url alanı, web'de derin bağlantı oluşturmak için kullanılan URL'yi temsil eder.
ticketing_identifiers.txt	agency_id	Kimlik	Zorunlu	Google toplu taşıma bilet işlemleri uzantısı. Varsayılan ticketing_stop_id alanının tanımlandığı durak için acenteyi belirtmek amacıyla agency_id alanında GTFS agency.txt dosyasından alınan kimlik bulunur.
ticketing_identifiers.txt	stop_id	Kimlik	Zorunlu	Google toplu taşıma bilet işlemleri uzantısı. Varsayılan ticketing_stop_id alanının tanımlandığı durağı belirtmek için stop_id alanında GTFS stops.txt dosyasından alınan kimlik bulunur.
ticketing_identifiers.txt	ticketing_stop_id	Kimlik	Zorunlu	Google toplu taşıma bilet işlemleri uzantısı. ticketing_stop_id alanı, durağa uygulanan biletleme kimliğini içerir. İsteğe bağlı olarak, kimlik bir ajans tarafından onaylanabilir.
trips.txt	exceptional	Enum	İsteğe bağlı	Bu alan, istisnai gezileri belirtir. Normal programın dışında çalışır veya özel etkinlikler ya da planlı kesintiler (ör. ray çalışması) nedeniyle normal rotadan saparlar. Google aşağıdaki değer seçeneklerini kabul eder: 0. Normal hizmetler 1. Hizmet istisnası. Örneğin, özel etkinlikler nedeniyle eklenen veya planlı kesintiler nedeniyle normal rotadan ayrılan hizmetler.
trips.txt	ticketing_trip_id	Kimlik	İsteğe bağlı	Google toplu taşıma bilet işlemleri uzantısı. ticketing_trip_id alanı varsa değeri, derin bağlantılarla biletleme için geziyi tanımlamak amacıyla trip_id alanını geçersiz kılar.
trips.txt	ticketing_type	Enum	İsteğe bağlı	Google toplu taşıma bilet işlemleri uzantısı. ticketing_type alanı, bu seyahat için geçerli olan bilet türünü belirtir. Google Transit aşağıdaki değerleri kabul eder: 0. Varsayılan. Yalnızca ajansın veya rotanın etkin bir bilet işlemleri derin bağlantısı varsa kullanılabilir. 1. Kullanılamıyor.
translations.txt	lang	Dil Kodu	İsteğe bağlı	Google toplu taşıma uzantısı. lang alanı resmi GTFS'nin bir parçası değildir ancak Google toplu taşıma, mevcut olduğunda bu değeri kullanır. Bir ifadenin çevirisini belirtmek için lang alanını kullanın. Değeri boş veya und (tanımlanmamış bir dil) olmamalıdır.
translations.txt	trans_id	Kimlik	İsteğe bağlı	Google toplu taşıma uzantısı. trans_id alanı resmi GTFS'nin bir parçası değildir ancak Google Toplu Taşıma, mevcut olduğunda bu değeri kullanır. Çevirisinin sağlandığı ifadenin kimlik jetonunu belirtmek için trans_id alanını kullanın. translations.txt tablosundaki her satır, lang dilinde trans_id ifadesinin translation olarak çevrildiği anlamına gelir.
trips.txt	original_trip_id	Kimlik	İsteğe bağlı	Google toplu taşıma uzantısı. trips.txt dosyasında varsa original_trip_id değeri, diğer sistemler tarafından kullanılacak trip_id değerini geçersiz kılar. Gerçek zamanlı eşleme buna örnek gösterilebilir.
trips.txt	trip_direction_name	Metin	İsteğe bağlı	Google toplu taşıma uzantısı. trip_direction_name alanı, yolcular için seyahatin yönünü tanımlar. Bu alandaki değer, her gezi için direction_name değeri olarak depolanır. stop_times tablosundaki stop_direction_name değeri seyahat sırasında değişirse trip_direction_name değerini geçersiz kılabilir. trip_direction_name alanındaki değerler büyük/küçük harfe duyarsız şekilde normalleştirilir.
trips.txt	vehicle_category_id	Kimlik	İsteğe bağlı	Google toplu taşıma uzantısı. trips.txt dosyasında vehicle_category_id alanı, bu seyahate ayrılan aracı tanımlar. Bu alan trips.txt dosyasında olduğunda, değeri routes.txt dosyasındavehicle_category_id
vehicle_categories.txt	vehicle_category_id	Kimlik	Zorunlu	Google toplu taşıma uzantısı. Bir araç kategorisini tanımlar.
vehicle_categories.txt	vehicle_amenity_id	Kimlik	İsteğe bağlı	Google toplu taşıma uzantısı. Araç kategorisindeki tüm yolcuların yararlanabileceği bir dizi imkanı tanımlar. Alternatif olarak, aynı araç kategorisinde farklı donanım gruplarının bulunduğu durumlar için vehicle_category_amenities.txt bölümüne bakın.
vehicle_amenities.txt	vehicle_amenity_id	Kimlik	Zorunlu	Google toplu taşıma uzantısı. Bir dizi imkanı tanımlar.
vehicle_amenities.txt	ac_availability	Enum	İsteğe bağlı	Google toplu taşıma uzantısı. Klimanın olup olmadığını belirtir. Google aşağıdaki değerleri kabul eder: 0. Varsayılan. Bilinmiyor. 1. Dilediğiniz zaman, dilediğiniz yerden kullanılabilir. 2. Kullanılamaz.
vehicle_amenities.txt	toilet_availability	Enum	İsteğe bağlı	Google toplu taşıma uzantısı. Araç içinde tuvalet olup olmadığını belirtir. Google aşağıdaki değerleri kabul eder: 0. Varsayılan. Bilinmiyor. 1. Dilediğiniz zaman, dilediğiniz yerden kullanılabilir. 2. Kullanılamaz.
vehicle_amenities.txt	gender_accessibility	Enum	İsteğe bağlı	Google toplu taşıma uzantısı. Cinsiyet kısıtlamalarının geçerli olup olmadığını tanımlar. Google aşağıdaki değerleri kabul eder: 0. Varsayılan. Bilinmiyor. 1. Cinsiyet kısıtlaması yoktur. 2. Yalnızca kadınlara açıktır. 3. Yalnızca erkeklerle sınırlıdır.
vehicle_amenities.txt	seat_type	Enum	İsteğe bağlı	Google toplu taşıma uzantısı. Koltuk türünü tanımlar. Google aşağıdaki değerleri kabul eder: 0. Varsayılan. Koltuk (katlanabilir değildir, yatabilir). 1. Sabit yatak (koltuk olarak geri yatırılamaz). 2. Yatabilen koltuk.
vehicle_amenities.txt	service_class	Enum	İsteğe bağlı	Google toplu taşıma uzantısı. Koltuğun sınıfını tanımlar. Google aşağıdaki değerleri kabul eder: 0. Varsayılan. Bilinmiyor. 1. First class. 2. İkinci sınıf. 3. Üçüncü sınıf. 4. İşletme. 5. Premium Ekonomi. 6. Ekonomi.
vehicle_amenities.txt	service_class_code	Dize	İsteğe bağlı	Google toplu taşıma uzantısı. Kısa biçim sınıf kodunu tanımlar (ör. Klimalı Birinci Sınıf için 1A). Bu alan, sınıf alanının daha spesifik bir sürümüdür. Sınıf enum'unda bulunmayan sınıfların belirtilebileceği yerdir.
vehicle_amenities.txt	seat_plug	Enum	İsteğe bağlı	Google toplu taşıma uzantısı. Koltukta elektrik veya USB fişi (herhangi bir türde) olup olmadığını belirtir. Google aşağıdaki değerleri kabul eder: 0. Varsayılan. Bilinmiyor. 1. Tüm koltuklarda kullanılabilir. 2. Kullanılamaz.
vehicle_amenities.txt	row_layout_summary	Dize	İsteğe bağlı	Google toplu taşıma uzantısı. Aracın bir satırındaki koltuk veya yatak sayısını tanımlar. Bazı örnekler: "2" (sırayla 2 koltuk, ancak bunların ayrılmış veya yan yana olup olmadığı bilinmiyor), "1+1" (sırayla 2 ayrı koltuk), "2+2" (ortada ayırıcı bulunan sırayla 4 koltuk).
vehicle_amenities.txt	row_leg_space	Enum	İsteğe bağlı	Google toplu taşıma uzantısı. Koltuklarda ek bacak mesafesi olup olmadığını belirtir. Google aşağıdaki değerleri kabul eder: 0. Varsayılan. Bilinmiyor / Geçerli değil. 1. Standart bacak mesafesi. 2. Ek bacak mesafesi.
vehicle_category_amenities.txt	vehicle_category_id	Kimlik	Zorunlu	Google toplu taşıma uzantısı. Araç kategorisini tanımlar. Aynı araç kategorisinde, bu alanın değeri birden fazla satırda tekrarlanarak birçok donanım grubu bulunabilir. Bu, genellikle bir araç kategorisinde çeşitli hizmet sınıfları olduğunda kullanışlıdır.
vehicle_category_amenities.txt	vehicle_amenity_id	Kimlik	Zorunlu	Google toplu taşıma uzantısı. Araç kategorisindeki tüm yolcuların yararlanabileceği bir dizi imkanı tanımlar.

Not: GTFS Gerçek Zamanlı ve Google Toplu Taşıma uygulaması arasındaki farklar hakkında daha fazla bilgi edinmek için bu makaleyi inceleyin.