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

Bu sayfada, resmi GTFS programı ile Google Transit'in spesifikasyonu aşağıdaki alanlarda uygulama şekli 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.

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'in 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şullu olarak zorunlu Çalışma saatleri 00 ile 99 arasındadır. Bu süre, üç günlük seyahatler 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'in 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 para tutarını 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 ücret için 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 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 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ı, yolculara göre seyahatin 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 aktarıcı içe aktarıcı 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 göre normalleştirilir.

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

Google toplu taşıma uzantısı.

signposted_as alanı, platformun tabelasında yazan metni bire bir 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 almak 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 evrensel bağlantı 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 seyahatleri 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 Transit, varsa 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 Transit, 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ı, seyahatin yolculara göre 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ında bulunan vehicle_category_id değerini geçersiz kılar.