Google Transit GTFS Program Referansı ve Farkları

Bu sayfada, resmi GTFS Planı ile Google Transit'in aşağıdaki alanlarda spesifikasyon uygulamasını uygulaması arasındaki önemli farklılıklar açıklanmaktadır:

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

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

  • Deneysel destek: Bu alanlar, Google Transit uygulamasında deneyseldir. Yeni bir deneysel alan uygulamak istiyorsanız Google Transit ekibiyle iletişime geçin.

  • Google Transit'in desteklediği uzantı: Bu uzantı, resmi GTFS'nin bir parçası değildir. Transit'in desteklediği uzantı, hem herkese açık uzantıları hem de Google Transit'e özel uzantıları içerir. Herhangi bir iş ortağı, bu bilgileri feed'lerinde Transit'e gönderebilir.

Statik taşıma

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

Statik feed'lerde yoksayılan resmi özellikler

Transit tarafından yoksayılan bazı resmi özellikler deneyseldir. Daha fazla bilgi edinmek için gtfs.org adresine gidin.

Tablo 1'de, statik feed'lerde Transit tarafından desteklenmeyen GTFS dosyaları listelenmektedir. 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 Transit tarafından yoksayılan ve GTFS tanımlı tüm alanlar listelenmiştir.

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
stops.txt bikes_allowed Enum

Statik feed'lerde farklı yorumlamalar

Transit, GTFS tarafından tanımlanmış belirli alanları kabul etse de bunları GTFS'den farklı bir şekilde yorumlar.

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

Tablo 3. Farklı şekilde uygulanmış statik feed alanları
Dosya Adı GTFS'de tanımlanan alan Alan türü Google Transit için zorunlu mu? Google Transit uygulama ayrıntıları
fare_attributes.txt transfers Enum Gerekli

Google Transit uzantısı.

Herkese açık GTFS, değerleri 0-2 aralığıyla sınırlandırır. Google Transit, 0 ile 5 arasındaki değerleri kabul eder.

Ücretle birlikte izin verilen maksimum aktarım sayısını ayarlamak için bu alanı kullanın. Bu, koltuk içi transfer olarak da bilinen blok aktarmaları içermez. Bir ücret için aktarım sayısını sınırlamak 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 Transit bunu kabul eder ve bilinmeyen olarak değerlendirir.
stop_times.txt arrival_time Saat Koşula bağlı olarak gerekli Saatler, 00 - 99 arasındaki değerlerle sınırlandırılmıştır. Bu, üç günlük geziler için yeterli olandan fazladır.
transfers.txt transfer_type Enum Gerekli

4 ve 5 değerleri desteklenmez ve yoksayı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 başlıklı makaleye bakın.

Statik feed'lerde deneysel destek

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

Statik feed'lerde Google Transit tarafından desteklenen uzantılar

Tablo 4'te Google Transit 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 için zorunlu mu? Google Transit uygulama ayrıntıları
fare_attributes.txt ic_price Kayan İsteğe bağlı

Bu Google Transit uzantısını yalnızca Japonya'daki iş ortakları kullanabilir.

ic_price alanı, akıllı kartla bu ücret için ödenecek indirimli tutarı temsil eder. Bu ücret için indirim sağlanmamışsa veya akıllı kart desteklenmiyorsa ic_price alanının değeri -1 olmalıdır.

fare_rules.txt contains_route_id Kimlik İsteğe bağlı

Google Transit uzantısı.

Bu ücret yalnızca fare_id, origin_id ve destination_id sütunlarının bu kombinasyonu için tüm satırlarda route_id değeriyle tanımlanan belirli bir rota grubunu ziyaret eden seyahatlerde geçerlidir.

contains_route_id sütunu eksikse veya bu ücret için tüm değerleri null ise ücret bu parametrede kısıtlanmamıştır. contains_route_id alanı bir ücret için verilmişse route_id alanı boş olmalıdır.

routes.txt checkin_duration Tamsayı İsteğe bağlı

Google Transit uzantısı.

checkin_duration alanı, bir yolcunun check-in ve uçağa binmek için planlanan kalkıştan kaç saniye erken gelmesinin önerildiğini belirtir.

Yolcu, kalkışa aktarmayla bağlanırsa tanımlanmış herhangi bir aktarım süresi 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. Bu süre, bir yolcunun gelip araca binebildiği en son anı yansıtmayabilir.

routes.txt route_type Enum Gerekli

Google Transit uzantısı.

Google Transit'in 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 bölümüne bakın.

stop_times.txt stop_direction_name Metin İsteğe bağlı

Google Transit uzantısı.

stop_direction_name alanı, bir seyahatin yolculara yönünü tanımlar. Yol tarifi, bu duraktan yapılan kalkışın direction_name değeri olarak saklanır.

stop_direction_name alanı boşsa bunun yerine toplu taşıma destekli trip_direction_name alanı kullanılır. trip_direction_name ve stop_direction_name alanlarının her ikisi de boşsa toplu taşıma içe aktarıcısı bunları 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 normalleştirilir.

stops.txt signposted_as Metin İsteğe bağlı

Google Transit uzantısı.

signposted_as alanı, platformun tabelasına yazılan tam metni içerir. Örnekler: "Towards Central" ve "Doğu Yakası ve Brooklyn".

GTFS platform_code alanı ve Toplu taşıma tarafından desteklenen 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 rakam ya da harf içerir.
  • Dil. platform_code alanında dil bulunmaz ancak signposted_as değerlerinin çevirileri olabilir.
  • Kararlılık. platform_code alanı, signposted_as alanından çok daha az değişir.
stops.txt vehicle_type Tamsayı İsteğe bağlı

Google Transit uzantısı.

vehicle_type alanı, duraklarda kullanılan araçların türünü belirtir. Bu alanda hiyerarşik araç türü (HVT) rota türleri kabul edilir. HVT değerleri, Avrupa Ulaşım Protokolü Uzmanları Grubu (TPEG) standardından türetilir.

agency.txt ticketing_deep_link_id Kimlik İsteğe bağlı

Google Transit bilet işlemleri uzantısı.

agency.txt dosyasındaki ticketing_deep_link_id alanı, bu acentenin seyahatlerini biletlemek için kullanılan derin bağlantıyı temsil eder.

routes.txt ticketing_deep_link_id Kimlik İsteğe bağlı

Google Transit bilet işlemleri uzantısı.

routes.txt dosyasındaki ticketing_deep_link_id alanı, bu rotadaki gezilerin biletini almak için kullanılan derin bağlantıyı temsil eder.

stop_times.txt ticketing_stop_time_id Kimlik İsteğe bağlı

Google Transit bilet işlemleri uzantısı.

stop_times.txt dosyasında mevcutsa ticketing_stop_time_id alanı, derin bağlantılarla bilet satışı için bitiş zamanını temsil eden tanımlayıcıyı geçersiz kılar.

stop_times.txt ticketing_type Enum İsteğe bağlı

Google Transit bilet işlemleri uzantısı.

ticketing_type alanı, bu durdurma zamanı için geçerli bilet türünü belirtir.

Google Transit aşağıdaki değerleri kabul eder:

  • Empty. Varsayılan - gezi tarafından tanımlandığı şekilde.
  • 0. Yalnızca ajans veya rota için bilet işlemleri derin bağlantısı etkinleştirilmişse kullanılabilir.
  • 1. Kullanılamaz.
ticketing_deep_links.txt android_intent_uri URI İsteğe bağlı

Google Transit bilet işlemleri uzantısı.

android_intent_uri alanı, Android'de derin bağlantılar için kullanılan amaç URI'sını temsil eder.

ticketing_deep_links.txt ios_universal_link_url URL İsteğe bağlı

Google Transit bilet işlemleri uzantısı.

ios_universal_link_url alanı, iOS'te derin bağlantılar için kullanılan evrensel bağlantı URL'sini temsil eder.

ticketing_deep_links.txt ticketing_deep_link_id Kimlik Gerekli

Google Transit 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 Transit bilet işlemleri uzantısı.

web_url alanı, web'de derin bağlantılar için kullanılan URL'yi temsil eder.

ticketing_identifiers.txt agency_id Kimlik Gerekli

Google Transit bilet işlemleri uzantısı.

Varsayılan ticketing_stop_id alanının tanımlandığı durağın ajansını belirtmek için agency_id alanı, GTFS agency.txt dosyasındaki kimliği içerir.

ticketing_identifiers.txt stop_id Kimlik Gerekli

Google Transit bilet işlemleri uzantısı.

Varsayılan ticketing_stop_id alanının tanımlandığı durağı belirtmek için stop_id alanı, GTFS stops.txt dosyasındaki kimliği içerir.

ticketing_identifiers.txt ticketing_stop_id Kimlik Gerekli

Google Transit bilet işlemleri uzantısı.

ticketing_stop_id alanı, durağa uygulanan bilet işlemi kimliğini içerir. İsteğe bağlı olarak, kimlik bir ajans tarafından nitelendirilebilir.

trips.txt exceptional Enum İsteğe bağlı

Bu alan olağanüstü gezileri gösterir. Bu cihazlar, normal programın dışında çalışır veya özel etkinlikler ya da planlı aksamalar (ör. parkur düzeni vb.) nedeniyle normal rotadan ayrılır.

Google, aşağıdaki değer seçeneklerini kabul eder:

  • 0. Normal hizmetler
  • 1. Hizmet istisnası. Örneğin, özel etkinlikler nedeniyle eklenen hizmetler veya planlanan kesintiler nedeniyle normal rotadan sapılan hizmetler.
trips.txt ticketing_trip_id Kimlik İsteğe bağlı

Google Transit bilet işlemleri uzantısı.

ticketing_trip_id alanı mevcutsa bu alanın değeri, derin bağlantılarla bilet işlemleri 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 Transit 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 bilet işlemleri derin bağlantısı etkinleştirilmişse kullanılabilir.
  • 1. Kullanılamaz.
translations.txt lang Dil Kodu İsteğe bağlı

Google Transit uzantısı.

lang alanı, resmi GTFS'nin bir parçası değildir ancak Google Transit mevcut olduğunda bu değeri kullanır.

Bir kelime öbeğinin ç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 Transit uzantısı.

trans_id alanı, resmi GTFS'nin bir parçası değildir ancak Google Transit mevcut olduğunda bu değeri kullanır.

Çevirinin sağlandığı ifadenin kimlik jetonunu belirtmek için trans_id alanını kullanın. translations.txt tablosunun her satırı, lang dilinde trans_id ifadesinin translation diline çevrildiği anlamına gelir.

trips.txt original_trip_id Kimlik İsteğe bağlı

Google Transit uzantısı.

trips.txt dosyasında mevcutsa original_trip_id değeri, diğer sistemler tarafından kullanılmak üzere trip_id değerini geçersiz kılar. Gerçek zamanlı eşleştirmeye örnek olarak verilebilir.

trips.txt trip_direction_name Metin İsteğe bağlı

Google Transit uzantısı.

trip_direction_name alanı, bir seyahatin yolculara yönünü tanımlar. Bu alandaki değer, her seyahatin direction_name değeri olarak saklanır.

Seyahat boyunca stop_times tablosundaki stop_direction_name değeri 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 normalleştirilir.

trips.txt vehicle_category_id Kimlik İsteğe bağlı

Google Transit uzantısı.

trips.txt dosyasındaki vehicle_category_id alanı, bu yolculuk için tahsis edilen aracı tanımlar. Bu alan trips.txt dosyasında olduğunda, alanın değeri routes.txt dosyasındaki vehicle_category_id değerini geçersiz kılar.