Package google.maps.routing.v2

Dizin

Rotalar

Routes API

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Başlangıç ve varış noktalarının listesini alır ve her başlangıç-varış noktası kombinasyonu için rota bilgilerini içeren bir akış döndürür.

NOT: Bu yöntemde, girişte bir yanıt alan maskesi belirtmeniz gerekir. Yanıt alan maskesini $fields veya fields URL parametresini ya da X-Goog-FieldMask HTTP/gRPC üst bilgisini kullanarak sağlayabilirsiniz (kullanılabilir URL parametreleri ve üst bilgileri bölümüne bakın). Değer, virgülle ayrılmış alan yolu listesidir. Alan yollarının nasıl oluşturulacağı hakkında ayrıntılı bilgi için bu belgeye bakın.

Örneğin, bu yöntemde:

  • Mevcut tüm alanların alan maskesi (manuel inceleme için): X-Goog-FieldMask: *
  • Rota süreleri, mesafeler, öğe durumu, koşul ve öğe dizinlerinin alan maskesi (üretim kurulumu örneği): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

Aksi takdirde tüm iletiler "Tamam" olarak görüneceğinden, alan maskenize status karakterini eklemeniz çok önemlidir. Google, joker karakter (*) yanıt alanı maskesinin kullanılmasını önermez. Bunun nedeni:

  • Yalnızca ihtiyacınız olan alanları seçmek, sunucumuzun hesaplama döngülerini kaydetmesine yardımcı olur. Bu sayede, sonucu size daha düşük gecikmeyle döndürebiliriz.
  • Üretim işinizde yalnızca ihtiyacınız olan alanları seçmek, gecikme süresinin kararlı olmasını sağlar. Gelecekte daha fazla yanıt alanı ekleyebiliriz ve bu yeni alanlar ek hesaplama süresi gerektirebilir. Tüm alanları veya en üst düzeydeki tüm alanları seçerseniz eklediğimiz her yeni alan yanıta otomatik olarak dahil edileceğinden performans düşüşü yaşayabilirsiniz.
  • Yalnızca ihtiyacınız olan alanları seçmek, yanıt boyutunun küçülmesini ve dolayısıyla ağ verimliliğinin artmasını sağlar.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Bir dizi terminal ve ara yol noktası verildiğinde, isteğe bağlı alternatif rotalarla birlikte birincil rotayı döndürür.

NOT: Bu yöntemde, girişte bir yanıt alan maskesi belirtmeniz gerekir. Yanıt alan maskesini $fields veya fields URL parametresini ya da X-Goog-FieldMask HTTP/gRPC üst bilgisini kullanarak sağlayabilirsiniz (kullanılabilir URL parametreleri ve üst bilgileri bölümüne bakın). Değer, virgülle ayrılmış alan yolu listesidir. Alan yollarının nasıl oluşturulacağı hakkında ayrıntılı belgelere bakın.

Örneğin, bu yöntemde:

  • Mevcut tüm alanların alan maskesi (manuel inceleme için): X-Goog-FieldMask: *
  • Rota düzeyinde süre, mesafe ve çoklu çizgi alan maskesi (üretim kurulumu örneği): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google, joker karakter (*) yanıt alanı maskesinin kullanılmasını veya alan maskesinin en üst düzeyde (routes) belirtilmesini önermez. Bunun nedeni:

  • Yalnızca ihtiyacınız olan alanları seçmek, sunucumuzun hesaplama döngülerini kaydetmesine yardımcı olur. Bu sayede, sonucu size daha düşük gecikmeyle döndürebiliriz.
  • Üretim işinizde yalnızca ihtiyacınız olan alanları seçmek, gecikme süresinin kararlı olmasını sağlar. Gelecekte daha fazla yanıt alanı ekleyebiliriz ve bu yeni alanlar ek hesaplama süresi gerektirebilir. Tüm alanları veya en üst düzeydeki tüm alanları seçerseniz eklediğimiz her yeni alan yanıta otomatik olarak dahil edileceğinden performans düşüşü yaşayabilirsiniz.
  • Yalnızca ihtiyacınız olan alanları seçmek, yanıt boyutunun küçülmesini ve dolayısıyla ağ verimliliğinin artmasını sağlar.

ComputeRouteMatrixRequest

ComputeRouteMatrix istek mesajı

Alanlar
origins[]

RouteMatrixOrigin

Zorunlu. Yanıt matrisinin satırlarını belirleyen kaynak dizisi. Kaynakların ve hedeflerin kardinalitesiyle ilgili çeşitli boyut kısıtlamaları vardır:

  • place_id veya address olarak belirtilen kaynak sayısı ile hedef sayısının toplamı 50'den fazla olmamalıdır.
  • Hiçbir durumda kaynak sayısı × hedef sayısı çarpımı 625'ten büyük olmamalıdır.
  • routing_preference TRAFFIC_AWARE_OPTIMAL olarak ayarlanmışsa kaynak sayısı × hedef sayısı çarpımı 100'den büyük olmamalıdır.
  • travel_mode TRANSIT olarak ayarlanmışsa kaynak sayısı × hedef sayısı çarpımı 100'den büyük olmamalıdır.
destinations[]

RouteMatrixDestination

Zorunlu. Yanıt matrisinin sütunlarını belirleyen hedef dizisi.
travel_mode

RouteTravelMode

İsteğe bağlı. Ulaşım şeklini belirtir.
routing_preference

RoutingPreference

İsteğe bağlı. Rotanın nasıl hesaplanacağını belirtir. Sunucu, rotayı hesaplamak için seçilen yönlendirme tercihini kullanmaya çalışır. Yönlendirme tercihi bir hataya veya çok uzun bir gecikmeye neden olursa hata döndürülür. Bu seçeneği yalnızca travel_mode DRIVE veya TWO_WHEELER olduğunda belirtebilirsiniz. Aksi takdirde istek başarısız olur.
departure_time

Timestamp

İsteğe bağlı. Kalkış saati. Bu değeri ayarlamazsanız varsayılan olarak isteği gönderdiğiniz zaman kullanılır. NOT: Yalnızca RouteTravelMode, TRANSIT olarak ayarlandığında geçmişte bir departure_time belirtebilirsiniz.
arrival_time

Timestamp

İsteğe bağlı. Varış saati NOT: Yalnızca RouteTravelMode, TRANSIT olarak ayarlandığında belirlenebilir. departure_time veya arrival_time değerini belirtebilirsiniz ancak ikisini birden belirtemezsiniz.
language_code

string

İsteğe bağlı. BCP-47 dil kodu (ör. "en-US" veya "sr-Latn"). Daha fazla bilgi için Unicode Yerel Kimliği başlıklı makaleyi inceleyin. Desteklenen dillerin listesi için Dil Desteği'ne bakın. Bu değeri sağlamadığınızda, görüntüleme dili ilk kaynağın konumundan çıkarılır.
region_code

string

İsteğe bağlı. Bölge kodu, ccTLD ("üst düzey alan") olarak belirtilen iki karakterlik bir değerdir. Daha fazla bilgi için Ülke kodu üst düzey alanları başlıklı makaleyi inceleyin.
units

Units

İsteğe bağlı. Görüntüleme alanlarının ölçü birimlerini belirtir.
extra_computations[]

ExtraComputation

İsteğe bağlı. İsteği tamamlamak için kullanılabilecek ek hesaplamaların listesi. Not: Bu ek hesaplamalar, yanıtta ek alanlar döndürebilir. Bu ek alanların yanıtta döndürülmek üzere alan maskesinde de belirtilmesi gerekir.
traffic_model

TrafficModel

İsteğe bağlı. Trafikteki süreyi hesaplarken kullanılacak varsayımları belirtir. Bu ayar, RouteMatrixElement içinde döndürülen değeri etkiler. Bu değer, geçmiş ortalamalara dayalı olarak trafikteki tahmini süreyi içerir. TrafficModel yalnızca RoutingPreference değerinin TRAFFIC_AWARE_OPTIMAL, RouteTravelMode değerinin ise DRIVE olarak ayarlandığı istekler için kullanılabilir. Trafik istenirse ve TrafficModel belirtilmezse varsayılan olarak BEST_GUESS kullanılır.
transit_preferences

TransitPreferences

İsteğe bağlı. TRANSIT rotaları için döndürülen rotayı etkileyen tercihleri belirtir. NOT: Yalnızca RouteTravelMode, TRANSIT olarak ayarlandığında transit_preferences belirtebilirsiniz.

ExtraComputation

İsteği tamamlarken gerçekleştirilecek ek hesaplamalar.

Sıralamalar
EXTRA_COMPUTATION_UNSPECIFIED Kullanılmaz. Bu değeri içeren istekler başarısız olur.
TOLLS Matris öğeleri için ücretli yol bilgileri.

ComputeRoutesRequest

ComputeRoutes istek mesajı.

Alanlar
origin

Waypoint

Zorunlu. Başlangıç ara noktası.
destination

Waypoint

Zorunlu. Hedef ara nokta.
intermediates[]

Waypoint

İsteğe bağlı. Rotadaki bir dizi ara nokta (terminal noktaları hariç), durmak veya geçmek için. En fazla 25 ara nokta desteklenir.
travel_mode

RouteTravelMode

İsteğe bağlı. Ulaşım şeklini belirtir.
routing_preference

RoutingPreference

İsteğe bağlı. Rotanın nasıl hesaplanacağını belirtir. Sunucu, rotayı hesaplamak için seçilen yönlendirme tercihini kullanmaya çalışır. Yönlendirme tercihi bir hataya veya çok uzun bir gecikmeye neden olursa hata döndürülür. Bu seçeneği yalnızca travel_mode DRIVE veya TWO_WHEELER olduğunda belirtebilirsiniz. Aksi takdirde istek başarısız olur.
polyline_quality

PolylineQuality

İsteğe bağlı. Çoklu çizginin kalitesiyle ilgili tercihinizi belirtir.
polyline_encoding

PolylineEncoding

İsteğe bağlı. Çoklu çizgi için tercih edilen kodlamayı belirtir.
departure_time

Timestamp

İsteğe bağlı. Kalkış saati. Bu değeri ayarlamazsanız varsayılan olarak isteği gönderdiğiniz zaman kullanılır. NOT: Yalnızca RouteTravelMode, TRANSIT olarak ayarlandığında geçmişte bir departure_time belirtebilirsiniz. Toplu taşıma yolculukları, geçmişte 7 güne veya gelecekte 100 güne kadar kullanılabilir.
arrival_time

Timestamp

İsteğe bağlı. Varış saati NOT: İsteklerde TRANSIT dışında bir RouteTravelMode belirtildiğinde bu alan yoksayılır. departure_time veya arrival_time değerini belirtebilirsiniz ancak ikisini birden belirtemezsiniz. Toplu taşıma yolculukları, geçmişte 7 güne veya gelecekte 100 güne kadar kullanılabilir.
compute_alternative_routes

bool

İsteğe bağlı. Rotaya ek olarak alternatif rotaların da hesaplanıp hesaplanmayacağını belirtir. Ara yol noktaları olan istekler için alternatif rotalar döndürülmez.
route_modifiers

RouteModifiers

İsteğe bağlı. Rotaların hesaplanma şeklini etkileyen ve karşılanması gereken bir dizi koşul.
language_code

string

İsteğe bağlı. BCP-47 dil kodu (ör. "en-US" veya "sr-Latn"). Daha fazla bilgi için Unicode Yerel Kimliği başlıklı makaleyi inceleyin. Desteklenen dillerin listesi için Dil Desteği'ne bakın. Bu değeri sağlamadığınızda, rota isteğinin konumundan ekran dili çıkarılır.
region_code

string

İsteğe bağlı. Bölge kodu, ccTLD ("üst düzey alan") olarak belirtilen iki karakterlik bir değerdir. Daha fazla bilgi için Ülke kodu üst düzey alanları başlıklı makaleyi inceleyin.
units

Units

İsteğe bağlı. Görüntüleme alanlarının ölçü birimlerini belirtir. Bu alanlar, NavigationInstruction içindeki instruction alanını içerir. Rota, ayak, adım mesafesi ve süre için kullanılan ölçü birimleri bu değerden etkilenmez. Bu değeri sağlamazsanız görüntüleme birimleri, ilk kaynağın konumundan çıkarılır.
optimize_waypoint_order

bool

İsteğe bağlı. Doğru olarak ayarlanırsa hizmet, belirtilen ara yol noktalarını yeniden sıralayarak rotanın toplam maliyetini en aza indirmeye çalışır. Ara yol noktalarından herhangi biri via yol noktasıysa istek başarısız olur. Yeni sıralamayı bulmak için ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index kullanın. ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index, X-Goog-FieldMask üstbilgisinde istenmezse istek başarısız olur. optimize_waypoint_order yanlış olarak ayarlanırsa ComputeRoutesResponse.optimized_intermediate_waypoint_index boş olur.
requested_reference_routes[]

ReferenceRoute

İsteğe bağlı. Varsayılan rotaya ek olarak, istek kapsamında hangi referans rotaların hesaplanacağını belirtir. Referans rota, varsayılan rotadan farklı bir rota hesaplama hedefine sahip olan rotadır. Örneğin, FUEL_EFFICIENT referans rota hesaplaması, yakıt açısından verimli bir rota oluşturacak çeşitli parametreleri dikkate alır. Bu özelliği kullanırken sonuç rotalarda route_labels simgesini bulun.
extra_computations[]

ExtraComputation

İsteğe bağlı. İsteği tamamlamak için kullanılabilecek ek hesaplamaların listesi. Not: Bu ek hesaplamalar, yanıtta ek alanlar döndürebilir. Bu ek alanların yanıtta döndürülmek üzere alan maskesinde de belirtilmesi gerekir.
traffic_model

TrafficModel

İsteğe bağlı. Trafikteki süreyi hesaplarken kullanılacak varsayımları belirtir. Bu ayar, Route ve RouteLeg içindeki süre alanında döndürülen değeri etkiler. Bu alan, geçmiş ortalamalara dayalı olarak trafikteki tahmini süreyi içerir. TrafficModel yalnızca RoutingPreference değerinin TRAFFIC_AWARE_OPTIMAL, RouteTravelMode değerinin ise DRIVE olarak ayarlandığı istekler için kullanılabilir. Trafik istenirse ve TrafficModel belirtilmezse varsayılan olarak BEST_GUESS kullanılır.
transit_preferences

TransitPreferences

İsteğe bağlı. TRANSIT rotaları için döndürülen rotayı etkileyen tercihleri belirtir. NOT: Yalnızca RouteTravelMode, TRANSIT olarak ayarlandığında transit_preferences belirtebilirsiniz.

ExtraComputation

İsteği tamamlarken gerçekleştirilecek ek hesaplamalar.

Sıralamalar
EXTRA_COMPUTATION_UNSPECIFIED Kullanılmaz. Bu değeri içeren istekler başarısız olur.
TOLLS Rotalar için ücret bilgileri.
FUEL_CONSUMPTION Rotaların tahmini yakıt tüketimi.
TRAFFIC_ON_POLYLINE Rotalar için trafik durumuna göre değişen çoklu çizgiler.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions, biçimlendirilmiş bir HTML metin dizesi olarak sunulur. Bu içerik olduğu gibi okunmalıdır. Bu içerik yalnızca görüntüleme amaçlıdır. Programatik olarak ayrıştırmayın.
FLYOVER_INFO_ON_POLYLINE Rotalar için üstten görünüm bilgileri. Bu bilgilerin döndürülmesi için routes.polyline_details.flyover_info fieldmask'inin belirtilmesi gerekir. Bu veriler şu anda yalnızca Hindistan'daki belirli metropoller için doldurulmaktadır. Bu özellik deneyseldir ve SKU/ücret değişebilir.
NARROW_ROAD_INFO_ON_POLYLINE Rotalarla ilgili dar yol bilgileri. Bu bilgilerin döndürülmesi için routes.polyline_details.narrow_road_info fieldmask'inin belirtilmesi gerekir. Bu veriler şu anda yalnızca Hindistan'daki belirli metropoller için doldurulmaktadır. Bu özellik deneyseldir ve SKU/ücret değişebilir.

ReferenceRoute

ComputeRoutesRequest üzerinde desteklenen bir referans rota.

Sıralamalar
REFERENCE_ROUTE_UNSPECIFIED Kullanılmaz. Bu değeri içeren istekler başarısız olur.
FUEL_EFFICIENT Yakıt verimliliği yüksek rota.
SHORTER_DISTANCE

Daha kısa seyahat mesafesine sahip rota. Bu, deneysel bir özelliktir.

Bu özellik, DRIVE isteklerinde sürüş konforu yerine daha kısa mesafeyi önceliklendirir. Örneğin, otoyollar yerine yerel yolları tercih edebilir, toprak yolları kullanabilir, otoparklardan geçebilir vb. Bu özellik, Google Haritalar'ın yasa dışı olduğunu bildiği manevraları döndürmez.

BICYCLE ve TWO_WHEELER isteklerinde bu özellik, requested_reference_routes belirtmediğinizde döndürülenlere benzer rotalar döndürür.

Bu özellik, ara yol noktaları üzerinden veya optimize_waypoint_order ile diğer seyahat modlarıyla uyumlu değildir. Bu tür istekler başarısız olur. Ancak, bu özelliği herhangi bir routing_preference ile kullanabilirsiniz.

ComputeRoutesResponse

ComputeRoutes yanıt mesajı.

Alanlar
routes[]

Route

compute_alternatives_routes belirttiğinizde hesaplanmış rotaların (en fazla üç) dizisini, belirtmediğinizde ise yalnızca bir rotayı içerir. Bu dizide birden fazla giriş olduğunda en çok önerilen rota ilk giriştir. Dizi boşsa rota bulunamamış demektir.
fallback_info

FallbackInfo

Bazı durumlarda, sunucu rota sonuçlarını tüm giriş tercihlerine göre hesaplayamadığında farklı bir hesaplama yöntemi kullanabilir. Yedek mod kullanıldığında bu alan, yedek yanıtla ilgili ayrıntılı bilgileri içerir. Aksi takdirde bu alanın değeri belirlenmez.
geocoding_results

GeocodingResults

Adres olarak belirtilen ara noktalar için coğrafi kodlama yanıt bilgilerini içerir.

FallbackInfo

Yedek sonucun nasıl ve neden kullanıldığıyla ilgili bilgiler. Bu alan ayarlanırsa sunucunun, geri dönüş olarak tercih ettiğiniz moddan farklı bir yönlendirme modu kullandığı anlamına gelir.

Alanlar
routing_mode

FallbackRoutingMode

Yanıt için kullanılan yönlendirme modu. Yedek rota tetiklendiyse mod, orijinal istemci isteğinde ayarlanan yönlendirme tercihinden farklı olabilir.
reason

FallbackReason

Orijinal yanıt yerine yedek yanıtın kullanılmasının nedeni. Bu alan yalnızca yedek mod tetiklendiğinde ve yedek yanıt döndürüldüğünde doldurulur.

FallbackReason

Yedek yanıtı kullanma nedenleri.

Sıralamalar
FALLBACK_REASON_UNSPECIFIED Yedek neden belirtilmedi.
SERVER_ERROR Tercih ettiğiniz yönlendirme moduyla rotalar hesaplanırken bir sunucu hatası oluştu ancak alternatif bir modla hesaplanan bir sonuç döndürebildik.
LATENCY_EXCEEDED Tercih ettiğiniz rota moduyla hesaplama zamanında tamamlanamadı ancak alternatif bir modla hesaplanan sonuç döndürüldü.

FallbackRoutingMode

Yedek yanıt döndürülürken kullanılan gerçek yönlendirme modu.

Sıralamalar
FALLBACK_ROUTING_MODE_UNSPECIFIED Kullanılmaz.
FALLBACK_TRAFFIC_UNAWARE Yanıtı hesaplamak için TRAFFIC_UNAWARE RoutingPreference kullanıldığını gösterir.
FALLBACK_TRAFFIC_AWARE Yanıtı hesaplamak için TRAFFIC_AWARE RoutingPreference kullanıldığını gösterir.

GeocodedWaypoint

Ara nokta olarak kullanılan konumlarla ilgili ayrıntılar. Yalnızca adres yol noktaları için doldurulur. Adresin hangi coğrafi kodla kodlandığını belirlemek için coğrafi kodlama sonuçlarıyla ilgili ayrıntıları içerir.

Alanlar
geocoder_status

Status

Coğrafi kodlama işleminden kaynaklanan durum kodunu gösterir.
type[]

string

Sonucun türleri; sıfır veya daha fazla tür etiketi biçiminde. Desteklenen türler: Adres türleri ve adres bileşeni türleri.
partial_match

bool

Kodlayıcının, istenen adresin bir kısmını eşleştirebilmesine rağmen orijinal istek için tam eşleşme döndürmediğini gösterir. Yazım hataları ve/veya eksik adres olup olmadığını görmek için orijinal isteği inceleyebilirsiniz.
place_id

string

Bu sonuç için yer kimliği.
intermediate_waypoint_request_index

int32

İstekteki ilgili ara yol noktasının dizini. Yalnızca ilgili ara nokta bir ara nokta ise doldurulur.

GeocodingResults

Başlangıç noktası, hedef ve ara yol noktaları için GeocodedWaypoints içerir. Yalnızca adres yol noktaları için doldurulur.

Alanlar
origin

GeocodedWaypoint

Başlangıç noktası için coğrafi kodlanmış ara nokta.
destination

GeocodedWaypoint

Hedef coğrafi kodlu ara nokta.
intermediates[]

GeocodedWaypoint

Her biri, istekte belirtildikleri sıraya göre ara coğrafi olarak kodlanmış yol noktalarının sıfır tabanlı konumuna karşılık gelen bir dizin alanı içeren ara coğrafi olarak kodlanmış yol noktalarının listesi.

LocalizedTime

Zamanın yerelleştirilmiş açıklaması.

Alanlar
time

LocalizedText

Belirli bir saat diliminde dize olarak belirtilen saat.
time_zone

string

Saat dilimini içerir. Değer, IANA Saat Dilimi Veritabanı'nda tanımlanan saat diliminin adıdır (ör. "America/New_York").

Konum

Bir konumu (coğrafi nokta ve isteğe bağlı başlık) kapsar.

Alanlar
lat_lng

LatLng

Ara noktanın coğrafi koordinatları.
heading

Int32Value

Trafiğin akış yönüyle ilişkili pusula yönü. Bu değer, teslim alma ve bırakma için yolun hangi tarafının kullanılacağını belirtir. Yön değerleri 0 ile 360 arasında olabilir. 0 değeri tam kuzey yönünü, 90 değeri tam doğu yönünü belirtir. Bu alanı yalnızca DRIVE ve TWO_WHEELER RouteTravelMode için kullanabilirsiniz.

Maneuver

Mevcut adım için gerçekleştirilecek gezinme işlemini belirten bir değer grubu (örneğin, sola dön, birleş veya düz git).

Sıralamalar
MANEUVER_UNSPECIFIED Kullanılmaz.
TURN_SLIGHT_LEFT Hafifçe sola dönün.
TURN_SHARP_LEFT Keskin bir şekilde sola dönün.
UTURN_LEFT Sola U dönüşü yapın.
TURN_LEFT Sola dönün.
TURN_SLIGHT_RIGHT Hafifçe sağa dönün.
TURN_SHARP_RIGHT Keskin bir şekilde sağa dönün.
UTURN_RIGHT Sağa U dönüşü yapın.
TURN_RIGHT Sağa dönün.
STRAIGHT Düz gidin.
RAMP_LEFT Soldaki rampayı kullanın.
RAMP_RIGHT Doğru rampayı kullanın.
MERGE Trafiğe karışın.
FORK_LEFT Soldaki çatala girin.
FORK_RIGHT Sağdaki yolu seç.
FERRY Feribota binin.
FERRY_TRAIN Feribota giden trene binin.
ROUNDABOUT_LEFT Döner kavşaktan sola dönün.
ROUNDABOUT_RIGHT Döner kavşaktan sağa dönün.
DEPART İlk manevra.
NAME_CHANGE Sokak adı değişikliğini belirtmek için kullanılır.

RouteLegStep için gezinme talimatlarını kapsar.

Alanlar
maneuver

Maneuver

Mevcut adımın gezinme talimatlarını (ör. sola dön, birleş veya düz git) kapsar. Bu alan, hangi simgenin görüntüleneceğini belirler.
instructions

string

Bu adımda gezinmeyle ilgili talimatlar.

Çoklu çizgi

Kodlanmış bir çoklu çizgiyi kapsar.

Alanlar
Birleştirme alanı polyline_type. Çoklu çizgi türünü kapsar. Varsayılan olarak encoded_polyline değerine ayarlanır. polyline_type yalnızca aşağıdakilerden biri olabilir:
encoded_polyline

string

Çoklu çizgi kodlama algoritması kullanılarak çoklu çizginin dize kodlaması
geo_json_linestring

Struct

GeoJSON LineString biçimini kullanarak bir çoklu çizgi belirtir.

PolylineDetails

Belirli bir dizine veya çoklu çizginin bitişik segmentine karşılık gelen ayrıntılar. P_0, P_1, ... , P_N noktaları olan bir çoklu çizgi verildiğinde (sıfır tabanlı indeks), PolylineDetails bir aralığı ve ilişkili meta verileri tanımlar.

Alanlar
flyover_info[]

FlyoverInfo

Çoklu çizgi boyunca fareyle üzerine gelindiğinde gösterilen ayrıntılar.
narrow_road_info[]

NarrowRoadInfo

Çoklu çizgi boyunca dar yol ayrıntıları.

FlyoverInfo

Çoklu çizgi boyunca üstten geçişlerle ilgili bilgileri kapsar.

Alanlar
flyover_presence

RoadFeatureState

Yalnızca çıkış. Belirli bir çoklu çizgi parçası için üstten görünüm olup olmadığını gösterir.
polyline_point_index

PolylinePointIndex

Çoklu çizgi boyunca kuşbakışı ile ilgili bilgilerin konumu.

NarrowRoadInfo

Çoklu çizgi boyunca dar yollarla ilgili bilgileri kapsar.

Alanlar
narrow_road_presence

RoadFeatureState

Yalnızca çıkış. Çoklu çizginin belirli bir bölümünde dar bir yol olup olmadığını gösterir.
polyline_point_index

PolylinePointIndex

Çoklu çizgi boyunca dar yolla ilgili bilgilerin konumu.

PolylinePointIndex

Bir çoklu çizgi ayrıntısının başlangıç ve bitiş dizinlerini kapsar. Verilerin tek bir noktaya karşılık geldiği durumlarda start_index ve end_index eşit olur.

Alanlar
start_index

int32

Bu ayrıntının çoklu çizgi içindeki başlangıç dizini.
end_index

int32

Bu ayrıntının çoklu çizgi içindeki bitiş indeksi.

RoadFeatureState

Bir çoklu çizgi parçası boyunca yol özelliklerinin durumlarını kapsar.

Sıralamalar
ROAD_FEATURE_STATE_UNSPECIFIED Yol özelliğinin durumu hesaplanmadı (varsayılan değer).
EXISTS Yol özelliği mevcut.
DOES_NOT_EXIST Yol özelliği mevcut değil.

PolylineEncoding

Döndürülecek tercih edilen çoklu çizgi türünü belirtir.

Sıralamalar
POLYLINE_ENCODING_UNSPECIFIED Çoklu çizgi türü tercihi belirtilmedi. Varsayılan olarak ENCODED_POLYLINE değerine ayarlanır.
ENCODED_POLYLINE Çoklu çizgi kodlama algoritması kullanılarak kodlanmış bir çoklu çizgi belirtir.
GEO_JSON_LINESTRING GeoJSON LineString biçimini kullanarak bir çoklu çizgi belirtir.

PolylineQuality

Çoklu çizginin kalitesini belirten bir değerler grubu.

Sıralamalar
POLYLINE_QUALITY_UNSPECIFIED Çoklu çizgi kalitesi tercihi belirtilmedi. Varsayılan olarak OVERVIEW değerine ayarlanır.
HIGH_QUALITY Yanıt boyutunun artması pahasına, OVERVIEW değerinden daha fazla nokta kullanılarak oluşturulan yüksek kaliteli bir çoklu çizgi belirtir. Daha fazla hassasiyete ihtiyacınız olduğunda bu değeri kullanın.
OVERVIEW Az sayıda nokta kullanılarak oluşturulan bir genel bakış çoklu çizgisini belirtir. Rotanın genel görünümünü gösterirken bu değeri kullanın. Bu seçeneği kullanmak, HIGH_QUALITY seçeneğini kullanmaya kıyasla daha düşük istek gecikmesine sahiptir.

Rota

Başlangıç, bitiş ve ara yol noktalarını birleştiren bir dizi bağlı yol segmentinden oluşan bir rota içerir.

Alanlar
route_labels[]

RouteLabel

Rotanın diğerleriyle karşılaştırılacak belirli özelliklerini tanımlamak için yararlı olan Route etiketleri.
legs[]

RouteLeg

Rotayı oluşturan ayaklar (ara noktalar arasındaki yol segmentleri) koleksiyonu. Her aşama, iki via Waypoints arasındaki yolculuğa karşılık gelir. Örneğin, ara yol noktası olmayan bir rotanın yalnızca bir ayağı vardır. via olmayan bir ara nokta içeren bir rota iki etaptan oluşur. Bir via ara yol noktası içeren rotanın bir ayağı vardır. Ayakların sırası, origin'dan intermediates'ye ve destination'ye kadar olan ara noktaların sırasıyla eşleşir.
distance_meters

int32

Rotanın metre cinsinden seyahat mesafesi.
duration

Duration

Rotada gezinmek için gereken süre. routing_preference değerini TRAFFIC_UNAWARE olarak ayarlarsanız bu değer static_duration ile aynı olur. routing_preference değerini TRAFFIC_AWARE veya TRAFFIC_AWARE_OPTIMAL olarak ayarlarsanız bu değer, trafik koşulları dikkate alınarak hesaplanır.
static_duration

Duration

Trafik koşulları dikkate alınmadan rotada seyahat süresi.
polyline

Polyline

Genel rota çoklu çizgisi. Bu çoklu çizgi, tüm legs öğelerinin birleştirilmiş çoklu çizgisidir.
description

string

Rotanın açıklaması.
warnings[]

string

Rota gösterilirken gösterilecek uyarı dizisi.
viewport

Viewport

Çoklu çizginin görüntü alanı sınırlayıcı kutusu.
travel_advisory

RouteTravelAdvisory

Rota hakkında ek bilgiler.
optimized_intermediate_waypoint_index[]

int32

optimize_waypoint_order değerini true olarak ayarlarsanız bu alan, ara yol noktalarının optimize edilmiş sıralamasını içerir. Aksi takdirde bu alan boş olur. Örneğin, Başlangıç: Los Angeles; Ara duraklar: Dallas, Bangor, Phoenix; Hedef: New York girişini yaparsanız ve optimize edilmiş ara durak sırası Phoenix, Dallas, Bangor ise bu alan [2, 0, 1] değerlerini içerir. Dizin, girişte sağlanan ilk ara yol noktası için 0 ile başlar.
localized_values

RouteLocalizedValues

Route özelliklerinin metin gösterimleri.
route_token

string

Rotayı izleme sırasında rotayı yeniden oluşturmak için Navigation SDK'ya iletilebilen ve yeniden yönlendirme durumunda rota oluşturulurkenki orijinal amacı karşılayan opak bir jeton. Bu jetonu opak bir blob olarak değerlendirin. Hizmet tam olarak aynı rotayı döndürse bile değeri değişebileceğinden, istekler arasında değerini karşılaştırmayın.

NOT: Route.route_token yalnızca ComputeRoutesRequest.routing_preference değerini TRAFFIC_AWARE veya TRAFFIC_AWARE_OPTIMAL olarak ayarlayan istekler için kullanılabilir. Route.route_token, Via ara noktaları olan isteklerde desteklenmez.
polyline_details

PolylineDetails

Çoklu çizgi üzerindeki ayrıntılarla ilgili bilgileri içerir.

RouteLocalizedValues

Belirli özelliklerin metin gösterimleri.

Alanlar
distance

LocalizedText

Metin biçiminde gösterilen seyahat mesafesi.
duration

LocalizedText

Süre, metin biçiminde gösterilir ve sorgunun bulunduğu bölgeye göre yerelleştirilir. Trafik koşullarını dikkate alır. Not: Trafik bilgisi istemediyseniz bu değer, static_duration ile aynı değerdir.
static_duration

LocalizedText

Trafik koşulları dikkate alınmadan hesaplanan ve metin biçiminde gösterilen süre.
transit_fare

LocalizedText

Toplu taşıma ücreti metin biçiminde gösterilir.

RouteLabel

Rotanın diğerleriyle karşılaştırılacak belirli özelliklerini tanımlamak için yararlı olan Route etiketleri.

Sıralamalar
ROUTE_LABEL_UNSPECIFIED Varsayılan: Kullanılmaz.
DEFAULT_ROUTE Rota hesaplaması için döndürülen varsayılan "en iyi" rota.
DEFAULT_ROUTE_ALTERNATE Varsayılan "en iyi" rotaya alternatif. compute_alternative_routes belirtildiğinde bu tür rotalar döndürülür.
FUEL_EFFICIENT Yakıt verimliliği yüksek rota. Bu değerle etiketlenen rotaların, yakıt tüketimi gibi çevre dostu parametreler için optimize edildiği belirlenir.
SHORTER_DISTANCE Daha kısa seyahat mesafesi rotası. Bu, deneysel bir özelliktir.

RouteLeg

via olmayan yol noktaları arasında bir segment içerir.

Alanlar
distance_meters

int32

Rota ayağının metre cinsinden seyahat mesafesi.
duration

Duration

Ayağın tamamlanması için gereken süre. route_preference, TRAFFIC_UNAWARE olarak ayarlanmışsa bu değer static_duration ile aynıdır. route_preference değeri TRAFFIC_AWARE veya TRAFFIC_AWARE_OPTIMAL ise bu değer, trafik koşulları dikkate alınarak hesaplanır.
static_duration

Duration

Trafik koşulları dikkate alınmadan hesaplanan, segment boyunca seyahat süresi.
polyline

Polyline

Bu ayağın genel çoklu çizgisi, her step'nın çoklu çizgisini içerir.
start_location

Location

Bu ayağın başlangıç konumu. Bu konum, sağlanan origin konumundan farklı olabilir. Örneğin, sağlanan origin bir yolun yakınında değilse bu, yol üzerindeki bir noktadır.
end_location

Location

Bu ayağın bitiş konumu. Bu konum, sağlanan destination konumundan farklı olabilir. Örneğin, sağlanan destination bir yolun yakınında değilse bu, yol üzerindeki bir noktadır.
steps[]

RouteLegStep

Bu ayaktaki segmentleri gösteren bir adımlar dizisi. Her adım bir gezinme talimatını temsil eder.
travel_advisory

RouteLegTravelAdvisory

Kullanıcının bilgilendirilmesi gereken ek bilgileri (ör. bir rota ayağında olası trafik bölgesi kısıtlamaları) içerir.
localized_values

RouteLegLocalizedValues

RouteLeg özelliklerinin metin gösterimleri.
steps_overview

StepsOverview

Bu RouteLeg adımlarıyla ilgili genel bilgiler. Bu alan yalnızca TOPLU TAŞIMA rotaları için doldurulur.

RouteLegLocalizedValues

Belirli özelliklerin metin gösterimleri.

Alanlar
distance

LocalizedText

Metin biçiminde gösterilen seyahat mesafesi.
duration

LocalizedText

Süre, metin biçiminde gösterilir ve sorgunun bulunduğu bölgeye göre yerelleştirilir. Trafik koşullarını dikkate alır. Not: Trafik bilgisi istemediyseniz bu değer, static_duration ile aynı değerdir.
static_duration

LocalizedText

Trafik koşulları dikkate alınmadan hesaplanan ve metin biçiminde gösterilen süre.

StepsOverview

Bir RouteLegStep listesi hakkında genel bilgiler sağlar.

Alanlar
multi_modal_segments[]

MultiModalSegment

RouteLeg.steps'nın farklı çok formatlı segmentleri hakkında özetlenmiş bilgiler. RouteLeg, adımlarda çok formatlı segmentler içermiyorsa bu alan doldurulmaz.

MultiModalSegment

RouteLeg.steps'nın farklı çok formatlı segmentleri hakkında özetlenmiş bilgiler sağlar. Çok formatlı segment, aynı RouteTravelMode değerine sahip bir veya daha fazla bitişik RouteLegStep olarak tanımlanır. RouteLeg, adımlarda çok formatlı segmentler içermiyorsa bu alan doldurulmaz.

Alanlar
navigation_instruction

NavigationInstruction

Çok formatlı segment için NavigationInstruction.
travel_mode

RouteTravelMode

Çok formatlı segmentin ulaşım şekli.
step_start_index

int32

Çok formatlı bir segmentin başlangıcı olan ilgili RouteLegStep dizini.
step_end_index

int32

Çok formatlı bir segmentin sonunu oluşturan ilgili RouteLegStep dizini.

RouteLegStep

RouteLeg segmenti içerir. Bir adım, tek bir navigasyon talimatına karşılık gelir. Rota ayakları adımlardan oluşur.

Alanlar
distance_meters

int32

Bu adımın metre cinsinden seyahat mesafesi. Bazı durumlarda bu alanın değeri olmayabilir.
static_duration

Duration

Trafik koşulları dikkate alınmadan bu adımda seyahat etme süresi. Bazı durumlarda bu alanın değeri olmayabilir.
polyline

Polyline

Bu adımla ilişkili çoklu çizgi.
start_location

Location

Bu adımın başlangıç konumu.
end_location

Location

Bu adımın bitiş konumu.
navigation_instruction

NavigationInstruction

Navigasyon talimatları.
travel_advisory

RouteLegStepTravelAdvisory

Bir ayak adımında, kullanıcının bilgilendirilmesi gereken ek bilgileri (ör. olası trafik bölgesi kısıtlamaları) içerir.
localized_values

RouteLegStepLocalizedValues

RouteLegStep özelliklerinin metin gösterimleri.
transit_details

RouteLegStepTransitDetails

Seyahat modu TRANSIT ise bu adımla ilgili ayrıntılar.
travel_mode

RouteTravelMode

Bu adım için kullanılan ulaşım şekli.

RouteLegStepLocalizedValues

Belirli özelliklerin metin gösterimleri.

Alanlar
distance

LocalizedText

Metin biçiminde gösterilen seyahat mesafesi.
static_duration

LocalizedText

Trafik koşulları dikkate alınmadan hesaplanan ve metin biçiminde gösterilen süre.

RouteLegStepTransitDetails

RouteLegStep ile ilgili TRANSIT rotaları hakkında ek bilgiler.

Alanlar
stop_details

TransitStopDetails

Adımın varış ve kalkış durakları hakkında bilgiler.
localized_values

TransitDetailsLocalizedValues

RouteLegStepTransitDetails özelliklerinin metin gösterimleri.
headsign

string

Araçta veya kalkış durağında belirtildiği şekilde, bu hat üzerinde seyahat edilecek yönü belirtir. Yön genellikle son istasyondur.
headway

Duration

Beklenen süreyi, bu saatte aynı duraktan kalkışlar arasındaki süre olarak belirtir. Örneğin, 600 saniyelik bir aralık değeriyle otobüsünüzü kaçırmanız durumunda on dakika beklemeniz gerekir.
transit_line

TransitLine

Bu adımda kullanılan toplu taşıma hattı hakkında bilgiler.
stop_count

int32

Kalkış durağından varış durağına kadar olan durak sayısı. Bu sayıya varış durağı dahil edilir ancak kalkış durağı dahil edilmez. Örneğin, rotanız A durağından başlıyor, B ve C duraklarından geçiyor ve D durağına varıyorsa

stop_count

3 değerini döndürür.
trip_short_text

string

Yolculara toplu taşıma yolculuğunu tanımlamak için programlarda ve tabelalarda görünen metin. Metin, hizmet verilen bir gün içindeki bir geziyi benzersiz şekilde tanımlamalıdır. Örneğin, "538", hafta içi günlerde saat 15:10'da San Jose, Kaliforniya'dan Sacramento, Kaliforniya'ya hareket eden Amtrak treninin trip_short_text.

TransitDetailsLocalizedValues

RouteTransitDetails için değerlerin yerelleştirilmiş açıklamaları.

Alanlar
arrival_time

LocalizedTime

Biçimlendirilmiş metin gösteriminde, ilgili saat dilimiyle birlikte zaman.
departure_time

LocalizedTime

Biçimlendirilmiş metin gösteriminde, ilgili saat dilimiyle birlikte zaman.

TransitStopDetails

RouteLegStep için toplu taşıma duraklarıyla ilgili ayrıntılar.

Alanlar
arrival_stop

TransitStop

Adımın varış durağıyla ilgili bilgiler.
arrival_time

Timestamp

Adımın tahmini varış zamanı.
departure_stop

TransitStop

Adımın kalkış durağı hakkında bilgi.
departure_time

Timestamp

Adımın tahmini kalkış zamanı.

RouteLegStepTravelAdvisory

Kullanıcıya bildirilmesi gereken ek bilgileri (ör. bir ayak adımında olası trafik bölgesi kısıtlamaları) içerir.

Alanlar
speed_reading_intervals[]

SpeedReadingInterval

NOT: Bu alan şu anda doldurulmamıştır.

RouteLegTravelAdvisory

Kullanıcının bir rota adımında bilgilendirilmesi gereken ek bilgileri (ör. olası trafik bölgesi kısıtlamaları) içerir.

Alanlar
toll_info

TollInfo

Belirli bir RouteLeg üzerindeki geçiş ücretleriyle ilgili bilgileri içerir. Bu alan yalnızca RouteLeg üzerinde ücretli geçişlerin olduğunu düşünüyorsak ve TOLLS, isteğin ComputeRoutesRequest.extra_computations bölümünde yer alıyorsa doldurulur. Bu alan ayarlanmış ancak estimated_price alt alanı doldurulmamışsa yolun ücretli olduğunu tahmin ederiz ancak tahmini fiyatı bilmeyiz. toll_info yoksa RouteLeg üzerinde geçiş ücreti yoktur.
speed_reading_intervals[]

SpeedReadingInterval

Trafik yoğunluğunu gösteren hızlı okuma aralıkları. Bu alan yalnızca istekte TRAFFIC_AWARE veya TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference değeri olduğunda ve TRAFFIC_ON_POLYLINE, ComputeRoutesRequest.extra_computations içinde yer aldığında istekler için doldurulur. Aralıklar, RouteLeg çoklu çizgisinin tamamını çakışmadan kapsar. Belirtilen bir aralığın başlangıç noktası, önceki aralığın bitiş noktasıyla aynıdır.

Örnek:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

RouteMatrixDestination

ComputeRouteMatrixRequest için tek bir hedef

Alanlar
waypoint

Waypoint

Zorunlu. Hedef ara nokta

RouteMatrixElement

ComputeRouteMatrix API'de bir başlangıç/varış noktası çifti için hesaplanan rota bilgilerini içerir. Bu proto, istemciye aktarılabilir.

Alanlar
status

Status

Bu öğenin hata durumu kodu.
condition

RouteMatrixElementCondition

Rotanın bulunup bulunmadığını gösterir. Durumdan bağımsızdır.
distance_meters

int32

Rotanın metre cinsinden seyahat mesafesi.
duration

Duration

Rotada gezinmek için gereken süre. routing_preference değerini TRAFFIC_UNAWARE olarak ayarlarsanız bu değer static_duration ile aynı olur. routing_preference değerini TRAFFIC_AWARE veya TRAFFIC_AWARE_OPTIMAL olarak ayarlarsanız bu değer, trafik koşulları dikkate alınarak hesaplanır.
static_duration

Duration

Trafik koşulları dikkate alınmadan rotada seyahat etme süresi.
travel_advisory

RouteTravelAdvisory

Rota hakkında ek bilgiler. Örneğin: kısıtlama bilgileri ve ücretli yol bilgileri
fallback_info

FallbackInfo

Sunucunun, belirli bir başlangıç/varış noktası çifti için rotayı verilen tercihlerle hesaplayamadığı bazı durumlarda farklı bir hesaplama modu kullanmaya geri dönebilir. Yedek mod kullanıldığında bu alan, yedek yanıtla ilgili ayrıntılı bilgileri içerir. Aksi takdirde bu alanın değeri belirlenmez.
localized_values

LocalizedValues

RouteMatrixElement özelliklerinin metin gösterimleri.
origin_index

int32

İstekteki kaynağın sıfır tabanlı dizini.
destination_index

int32

İstekteki hedefin sıfır tabanlı dizini.

LocalizedValues

Belirli özelliklerin metin gösterimleri.

Alanlar
distance

LocalizedText

Metin biçiminde gösterilen seyahat mesafesi.
duration

LocalizedText

Trafik koşulları dikkate alınarak metin biçiminde gösterilen süre. Not: Trafik bilgisi istenmediyse bu değer, static_duration ile aynı değerdir.
static_duration

LocalizedText

Trafik koşulları dikkate alınmadan metin biçiminde gösterilen süre.
transit_fare

LocalizedText

Toplu taşıma ücreti metin biçiminde gösterilir.

RouteMatrixElementCondition

Döndürülen rotanın durumu.

Sıralamalar
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED Yalnızca öğenin status değeri "OK" olmadığında kullanılır.
ROUTE_EXISTS Bir rota bulundu ve öğe için ilgili bilgiler dolduruldu.
ROUTE_NOT_FOUND Rota bulunamadı. distance_meters veya duration gibi rota bilgilerini içeren alanlar öğede doldurulmaz.

RouteMatrixOrigin

ComputeRouteMatrixRequest için tek bir kaynak

Alanlar
waypoint

Waypoint

Zorunlu. Başlangıç ara noktası
route_modifiers

RouteModifiers

İsteğe bağlı. Bunu başlangıç noktası olarak alan her rota için değiştiriciler

RouteModifiers

Rotalar hesaplanırken karşılanması gereken bir dizi isteğe bağlı koşulu kapsar.

Alanlar
avoid_tolls

bool

Doğru olarak ayarlandığında, makul durumlarda ücretli yollardan kaçınılır ve ücretli yol içermeyen rotalar tercih edilir. Yalnızca DRIVE ve TWO_WHEELER RouteTravelMode için geçerlidir.
avoid_highways

bool

Doğru olarak ayarlandığında, makul olan durumlarda otoyollar kullanılmaz ve otoyol içermeyen rotalar tercih edilir. Yalnızca DRIVE ve TWO_WHEELER RouteTravelMode için geçerlidir.
avoid_ferries

bool

Doğru olarak ayarlandığında, makul durumlarda feribotları kullanmaktan kaçınır ve feribot içermeyen rotaları tercih eder. Yalnızca DRIVE ve TWO_WHEELER RouteTravelMode için geçerlidir.
avoid_indoor

bool

Doğru olarak ayarlandığında, makul olan durumlarda iç mekanlarda gezinmeyi önler ve iç mekan navigasyonu içermeyen rotaları tercih eder. Yalnızca WALK RouteTravelMode için geçerlidir.
vehicle_info

VehicleInfo

Araç bilgilerini belirtir.
toll_passes[]

TollPass

Ücretli geçiş kartları hakkında bilgileri kapsar. Geçiş kartları sağlanırsa API, kart fiyatını döndürmeye çalışır. Geçiş ücreti kartları sağlanmazsa API, geçiş ücreti kartını bilinmiyor olarak kabul eder ve nakit fiyatını döndürmeye çalışır. Yalnızca DRIVE ve TWO_WHEELER RouteTravelMode için geçerlidir.

RouteTravelAdvisory

Kullanıcının bilgilendirilmesi gereken ek bilgileri (ör. olası trafik bölgesi kısıtlamaları) içerir.

Alanlar
toll_info

TollInfo

Rotadaki ücretli yollarla ilgili bilgileri içerir. Bu alan yalnızca rotada ücretli geçişlerin olması ve isteğin ComputeRoutesRequest.extra_computations bölümünde TOLLS bulunması durumunda doldurulur. Bu alan ayarlanmış ancak estimatedPrice alt alanı doldurulmamışsa rotada ücretli geçişler vardır ancak tahmini fiyat bilinmemektedir. toll_info ayarlanmamışsa rotada ücretli yol olması beklenmez.
speed_reading_intervals[]

SpeedReadingInterval

Trafik yoğunluğunu gösteren hızlı okuma aralıkları. Bu alan yalnızca istekte TRAFFIC_AWARE veya TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference değeri olduğunda ve TRAFFIC_ON_POLYLINE, ComputeRoutesRequest.extra_computations içinde yer aldığında istekler için doldurulur. Aralıklar, rotanın tüm çoklu çizgisini çakışmadan kapsar. Belirtilen bir aralığın başlangıç noktası, önceki aralığın bitiş noktasıyla aynıdır.

Örnek:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).
fuel_consumption_microliters

int64

Mikrolitre cinsinden tahmini yakıt tüketimi. Bu alan yalnızca isteğin ComputeRoutesRequest.extra_computations bölümünde FUEL_CONSUMPTION yer aldığında doldurulur.
route_restrictions_partially_ignored

bool

Döndürülen rotada, istenen seyahat modu veya rota değiştiriciler için uygun olmayan kısıtlamalar olabilir.
transit_fare

Money

Varsa bu rotadaki toplam ücret veya bilet maliyetlerini içerir. Bu özellik yalnızca TRANSIT istekleri ve yalnızca tüm toplu taşıma adımları için ücret bilgilerinin mevcut olduğu rotalar için döndürülür.

RouteTravelMode

Ulaşım şeklini belirtmek için kullanılan bir değerler kümesi. NOT: WALK, BICYCLE ve TWO_WHEELER rotaları beta sürümündedir ve bazen net kaldırımlar, yaya yolları veya bisiklet yolları içermeyebilir. Uygulamanızda gösterdiğiniz tüm yürüme, bisiklet ve iki tekerlekli araç rotaları için bu uyarıyı kullanıcıya göstermeniz gerekir.

Sıralamalar
TRAVEL_MODE_UNSPECIFIED Ulaşım şekli belirtilmedi. Varsayılan olarak DRIVE değerine ayarlanır.
DRIVE Binek otomobille seyahat edin.
BICYCLE Bisikletle seyahat etme
WALK Yürüyerek seyahat edin.
TWO_WHEELER İki tekerlekli, motorlu araç. Örneğin, motosiklet. Bunun, insan gücüyle çalışan modları kapsayan BICYCLE ulaşım modundan farklı olduğunu unutmayın.
TRANSIT Mümkün olduğunda toplu taşıma rotalarını kullanın.

RoutingPreference

Rotayı hesaplarken dikkate alınacak faktörleri belirten bir değerler grubu.

Sıralamalar
ROUTING_PREFERENCE_UNSPECIFIED Yönlendirme tercihi belirtilmedi. Varsayılan olarak TRAFFIC_UNAWARE değerine ayarlanır.
TRAFFIC_UNAWARE Canlı trafik koşullarını dikkate almadan rotalar hesaplar. Trafik koşullarının önemli olmadığı veya geçerli olmadığı durumlarda uygundur. Bu değer kullanıldığında en düşük gecikme süresi elde edilir. Not: RouteTravelMode DRIVE ve TWO_WHEELER için seçilen rota ve süre, mevcut yol koşullarına değil, yol ağına ve zamandan bağımsız ortalama trafik koşullarına göre belirlenir. Bu nedenle, rotalarda geçici olarak kapalı olan yollar yer alabilir. Belirli bir isteğin sonuçları, yol ağındaki değişiklikler, güncellenen ortalama trafik koşulları ve hizmetin dağıtılmış yapısı nedeniyle zaman içinde değişebilir. Sonuçlar, neredeyse eşdeğer rotalar arasında da herhangi bir zamanda veya sıklıkta değişiklik gösterebilir.
TRAFFIC_AWARE Canlı trafik koşullarını dikkate alarak rotaları hesaplar. TRAFFIC_AWARE_OPTIMAL'nın aksine, bazı optimizasyonlar gecikmeyi önemli ölçüde azaltmak için uygulanır.
TRAFFIC_AWARE_OPTIMAL Çoğu performans optimizasyonunu uygulamadan, canlı trafik koşullarını dikkate alarak rotaları hesaplar. Bu değeri kullanmak en yüksek gecikmeye neden olur.

SpeedReadingInterval

Çoklu çizgi veya yolun bitişik bir segmentindeki trafik yoğunluğu göstergesi. P_0, P_1, ... , P_N noktalarını içeren bir yol verildiğinde (sıfır tabanlı dizin), SpeedReadingInterval bir aralığı tanımlar ve trafiğini aşağıdaki kategorileri kullanarak açıklar.

Alanlar
start_polyline_point_index

int32

Bu aralığın çoklu çizgi içindeki başlangıç dizini.
end_polyline_point_index

int32

Çoklu çizgi üzerindeki bu aralığın bitiş dizini.
Birleştirme alanı speed_type. Bu aralıktaki hız türü. speed_type yalnızca aşağıdakilerden biri olabilir:
speed

Speed

Bu aralıktaki trafik hızı.

Hız

Çoklu çizgi hızının trafik verilerine göre sınıflandırılması.

Sıralamalar
SPEED_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
NORMAL Normal hız, trafikte gecikme yok.
SLOW Yavaşlama algılandı, orta düzeyde trafik.
TRAFFIC_JAM Trafikte gecikmeler.

TollInfo

Route veya RouteLeg cihazında ücretli yol bilgilerini kapsar.

Alanlar
estimated_price[]

Money

İlgili Route veya RouteLeg için ödenmesi gereken toplam ücret tutarı. Bu listede, geçiş istasyonları tarafından alınması beklenen her para birimi için bir tutar yer alır. Genellikle bu listede, tek bir para biriminde ücretli yollar için yalnızca bir öğe bulunur. Uluslararası seyahatlerde, farklı para birimlerindeki geçiş ücretlerini yansıtmak için bu listede birden fazla öğe yer alabilir.

TollPass

Dünya genelinde desteklediğimiz ücretli geçiş kartlarının listesi.

Sıralamalar
TOLL_PASS_UNSPECIFIED Kullanılmaz. Bu değer kullanılırsa istek başarısız olur.
AU_ETOLL_TAG Sidney otoyol geçiş kartı. Ek ayrıntıları https://www.myetoll.com.au adresinde bulabilirsiniz.
AU_EWAY_TAG Sidney otoyol geçiş kartı. Ek ayrıntıları https://www.tollpay.com.au adresinde bulabilirsiniz.
AU_LINKT Avustralya genelinde geçerli otoyol geçiş kartı. Ek ayrıntıları https://www.linkt.com.au/ adresinde bulabilirsiniz.
AR_TELEPASE Arjantin otoyol geçiş kartı. Ek ayrıntıları https://telepase.com.ar adresinde bulabilirsiniz.
BR_AUTO_EXPRESO Brezilya otoyol geçiş kartı. Ek ayrıntılar için https://www.autoexpreso.com adresini ziyaret edin.
BR_CONECTCAR Brezilya otoyol geçiş kartı. Ek ayrıntıları https://conectcar.com adresinde bulabilirsiniz.
BR_MOVE_MAIS Brezilya otoyol geçiş kartı. Ek ayrıntıları https://movemais.com adresinde bulabilirsiniz.
BR_PASSA_RAPIDO Brezilya otoyol geçiş kartı. Ek ayrıntılar için https://pasorapido.gob.do/ adresini ziyaret edin.
BR_SEM_PARAR Brezilya otoyol geçiş kartı. Ek ayrıntıları https://www.semparar.com.br adresinde bulabilirsiniz.
BR_TAGGY Brezilya otoyol geçiş kartı. Ek ayrıntıları https://taggy.com.br adresinde bulabilirsiniz.
BR_VELOE Brezilya otoyol geçiş kartı. Ek ayrıntıları https://veloe.com.br/site/onde-usar adresinde bulabilirsiniz.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Kanada'dan ABD'ye sınır geçişi.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Kanada'dan ABD'ye sınır geçişi.
CA_US_BLUE_WATER_EDGE_PASS Ontario, Kanada'dan Michigan, ABD sınır geçişi.
CA_US_CONNEXION Ontario, Kanada'dan Michigan, ABD sınır geçişi.
CA_US_NEXUS_CARD Kanada'dan ABD'ye sınır geçişi.
ID_E_TOLL Endonezya Gişelerde ödeme yapmak için kullanılan, birden fazla banka tarafından sağlanan e-kart. Bankalar aracılığıyla gönderilen tüm e-kartlar aynı şekilde ücretlendirildiğinden yalnızca bir enum değeri gerekir. Ör. - Bank Mandiri https://www.bankmandiri.co.id/e-money - BCA https://www.bca.co.id/flazz - BNI https://www.bni.co.id/id-id/ebanking/tapcash
IN_FASTAG Hindistan.
IN_LOCAL_HP_PLATE_EXEMPT Hindistan, HP eyalet plakası muafiyeti.
JP_ETC Japonya ETC. Ücret toplamak için kullanılan elektronik kablosuz sistem. https://www.go-etc.jp/
JP_ETC2 Japonya ETC2.0. Daha fazla indirim ve araçlardaki cihazlar ile yoldaki antenler arasında çift yönlü iletişim sağlayan yeni ETC sürümü. https://www.go-etc.jp/etc2/index.html
MX_IAVE Meksika'da kullanılan ücretli yol geçiş kartı. https://iave.capufe.gob.mx/#/
MX_PASE Meksika https://www.pase.com.mx
MX_QUICKPASS Meksika https://operadoravial.com/quick-pass/
MX_SISTEMA_TELEPEAJE_CHIHUAHUA http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
MX_TAG_IAVE Meksika
MX_TAG_TELEVIA Meksika'daki otoyol geçiş kartı şirketi. Mexico City'de faaliyet gösteren birçok işletmeden biri. Ek ayrıntıları https://www.televia.com.mx adresinde bulabilirsiniz.
MX_TELEVIA Meksika'daki otoyol geçiş kartı şirketi. Mexico City'de faaliyet gösteren birçok şirketten biri. https://www.televia.com.mx
MX_VIAPASS Meksika otoyol geçiş kartı. Ek ayrıntılar için https://www.viapass.com.mx/viapass/web_home.aspx adresini ziyaret edin.
US_AL_FREEDOM_PASS AL, ABD.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS AK, ABD.
US_CA_FASTRAK CA, ABD.
US_CA_FASTRAK_CAV_STICKER Sürücünün DMV tarafından verilen Temiz Hava Aracı (CAV) çıkartmasına ek olarak herhangi bir FasTrak geçiş kartı olup olmadığını gösterir. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO, ABD.
US_CO_GO_PASS CO, ABD.
US_DE_EZPASSDE DE, ABD.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS FL, ABD.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD FL, ABD.
US_FL_EPASS FL, ABD.
US_FL_GIBA_TOLL_PASS FL, ABD.
US_FL_LEEWAY FL, ABD.
US_FL_SUNPASS FL, ABD.
US_FL_SUNPASS_PRO FL, ABD.
US_IL_EZPASSIL IL, ABD.
US_IL_IPASS IL, ABD.
US_IN_EZPASSIN IN, ABD.
US_KS_BESTPASS_HORIZON KS, ABD.
US_KS_KTAG KS, ABD.
US_KS_NATIONALPASS KS, ABD.
US_KS_PREPASS_ELITEPASS KS, ABD.
US_LA_GEAUXPASS LA, ABD.
US_LA_TOLL_TAG LA, ABD.
US_MA_EZPASSMA MA, ABD.
US_MD_EZPASSMD MD, ABD.
US_ME_EZPASSME ME, ABD.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, ABD.
US_MI_BCPASS MI, ABD.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, ABD.
US_MI_IQ_PROX_CARD

MI, ABD. Bu kart türü artık mevcut olmadığından kullanımdan kaldırıldı.
US_MI_IQ_TAG MI, ABD.
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, ABD.
US_MI_NEXPRESS_TOLL MI, ABD.
US_MN_EZPASSMN MN, ABD.
US_NC_EZPASSNC NC, ABD.
US_NC_PEACH_PASS NC, ABD.
US_NC_QUICK_PASS NC, ABD.
US_NH_EZPASSNH NH, ABD.
US_NJ_DOWNBEACH_EXPRESS_PASS NJ, ABD.
US_NJ_EZPASSNJ NJ, ABD.
US_NY_EXPRESSPASS NY, ABD.
US_NY_EZPASSNY NY, ABD.
US_OH_EZPASSOH OH, ABD.
US_PA_EZPASSPA PA, ABD.
US_RI_EZPASSRI RI, ABD.
US_SC_PALPASS SC, ABD.
US_TX_AVI_TAG TX, ABD.
US_TX_BANCPASS TX, ABD.
US_TX_DEL_RIO_PASS TX, ABD.
US_TX_EFAST_PASS TX, ABD.
US_TX_EAGLE_PASS_EXPRESS_CARD TX, ABD.
US_TX_EPTOLL TX, ABD.
US_TX_EZ_CROSS TX, ABD.
US_TX_EZTAG TX, ABD.
US_TX_FUEGO_TAG TX, ABD.
US_TX_LAREDO_TRADE_TAG TX, ABD.
US_TX_PLUSPASS TX, ABD.
US_TX_TOLLTAG TX, ABD.
US_TX_TXTAG TX, ABD.
US_TX_XPRESS_CARD TX, ABD.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD UT, ABD.
US_VA_EZPASSVA VA, ABD.
US_WA_BREEZEBY WA, ABD.
US_WA_GOOD_TO_GO WA, ABD.
US_WV_EZPASSWV WV, ABD.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, ABD.
US_WV_MOV_PASS WV, ABD
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, ABD.

TrafficModel

Bu alan, trafik koşullarında seyahat süresini hesaplarken kullanılacak aşağıdaki varsayımlardan birini belirtir. Seçilen numaralandırmaya bağlı olarak TrafficModel yanıtının duration alanı değişir. Değer, geçmiş ortalamalara göre trafikteki varış noktasına ulaşma süresini içerir. TrafficModel yalnızca RoutingPreference değerinin TRAFFIC_AWARE_OPTIMAL, RouteTravelMode değerinin ise DRIVE olarak ayarlandığı istekler için kullanılabilir.

Sıralamalar
TRAFFIC_MODEL_UNSPECIFIED Kullanılmamış. Belirtilirse varsayılan olarak BEST_GUESS olur.
BEST_GUESS Döndürülen duration değerinin, hem geçmiş trafik koşulları hem de canlı trafik hakkında bilinenler göz önüne alındığında seyahat süresinin en iyi tahmini olması gerektiğini gösterir. Anlık trafik, departure_time şu ana ne kadar yakınsa o kadar önemli hale gelir.
PESSIMISTIC Dönüş süresinin çoğu günde gerçek seyahat süresinden daha uzun olması gerektiğini belirtir. Ancak trafik koşullarının özellikle kötü olduğu bazı günlerde bu değer aşılabilir.
OPTIMISTIC Döndürülen sürenin, çoğu günde gerçek seyahat süresinden daha kısa olması gerektiğini belirtir. Ancak özellikle iyi trafik koşullarının olduğu bazı günlerde bu değerden daha hızlı olabilir.

TransitAgency

Bir toplu taşıma hattını işleten toplu taşıma operatörü.

Alanlar
name

string

Bu toplu taşıma kuruluşunun adı.
phone_number

string

Toplu taşıma kuruluşunun yerel ayara özgü biçimlendirilmiş telefon numarası.
uri

string

Transit operatörünün URI'si.

TransitLine

Bu adımda kullanılan toplu taşıma hattı hakkında bilgi içerir.

Alanlar
agencies[]

TransitAgency

Bu toplu taşıma hattını işleten toplu taşıma kuruluşu (veya kuruluşları).
name

string

Bu toplu taşıma hattının tam adı (ör. "8 Avenue Local").
uri

string

Toplu taşıma operatörü tarafından sağlanan bu toplu taşıma hattının URI'si.
color

string

Bu hat için tabelalarda yaygın olarak kullanılan renk. Onaltılık olarak gösterilir.
icon_uri

string

Bu satırla ilişkili simgenin URI'si.
name_short

string

Bu toplu taşıma hattının kısa adı. Bu ad genellikle "M7" veya "355" gibi bir hat numarası olur.
text_color

string

Bu hat için tabelalardaki metinlerde yaygın olarak kullanılan renk. Onaltılık olarak gösterilir.
vehicle

TransitVehicle

Bu toplu taşıma hattında kullanılan araç türü.

TransitPreferences

Döndürülen rotayı etkileyen TRANSIT tabanlı rotalarla ilgili tercihler.

Alanlar
allowed_travel_modes[]

TransitTravelMode

TRANSIT rotası alırken kullanılabilecek bir dizi ulaşım şekli. Varsayılan olarak desteklenen tüm ulaşım şekilleri gösterilir.
routing_preference

TransitRoutingPreference

Belirtildiğinde döndürülen TRANSIT rotasını etkileyen bir yönlendirme tercihi.

TransitRoutingPreference

Toplu taşıma rotaları için yönlendirme tercihlerini belirtir.

Sıralamalar
TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED Tercih belirtilmedi.
LESS_WALKING Hesaplanan rotada sınırlı miktarda yürüyüş tercih edilmesi gerektiğini belirtir.
FEWER_TRANSFERS Hesaplanan rotada sınırlı sayıda aktarma tercih edilmesi gerektiğini gösterir.

TransitTravelMode

Ulaşım şeklini belirtmek için kullanılan bir değerler kümesi.

Sıralamalar
TRANSIT_TRAVEL_MODE_UNSPECIFIED Toplu taşıma ulaşım modu belirtilmedi.
BUS Otobüsle seyahat edin.
SUBWAY Metroyla seyahat etme
TRAIN Trenle seyahat edin.
LIGHT_RAIL Hafif raylı sistem veya tramvayla seyahat edin.
RAIL Trenle seyahat edin. Bu, SUBWAY, TRAIN ve LIGHT_RAIL kombinasyonuna eşdeğerdir.

TransitStop

Bir toplu taşıma durağı hakkında bilgi.

Alanlar
name

string

Toplu taşıma durağının adı.
location

Location

Durağın enlem/boylam koordinatlarıyla ifade edilen konumu.

TransitVehicle

Toplu taşıma rotalarında kullanılan araçla ilgili bilgiler.

Alanlar
name

LocalizedText

Bu aracın adı (büyük harflerle yazılır).
type

TransitVehicleType

Kullanılan aracın türü.
icon_uri

string

Bu araç türüyle ilişkili bir simgenin URI'si.
local_icon_uri

string

Yerel ulaşım işaretlerine göre bu araç türüyle ilişkili simgenin URI'si.

TransitVehicleType

Toplu taşıma rotaları için araç türü.

Sıralamalar
TRANSIT_VEHICLE_TYPE_UNSPECIFIED Kullanılmamış.
BUS Otobüs
CABLE_CAR Genellikle yerde, kablo üzerinde çalışan bir araç. Teleferikler GONDOLA_LIFT türünde olabilir.
COMMUTER_TRAIN Banliyö treni.
FERRY Feribot
FUNICULAR Bir kabloyla dik bir yokuşta çekilen araç. Füniküler genellikle iki vagondan oluşur. Her vagon, diğerinin karşı ağırlığı olarak işlev görür.
GONDOLA_LIFT Teleferik
HEAVY_RAIL Ağır demiryolu.
HIGH_SPEED_TRAIN Hızlı tren.
INTERCITY_BUS Şehirlerarası otobüs
LONG_DISTANCE_TRAIN Şehirlerarası tren
METRO_RAIL Hafif raylı sistem.
MONORAIL Monoray.
OTHER Diğer tüm araçlar.
RAIL Demiryolu
SHARE_TAXI Paylaşımlı taksi, rotası üzerindeki herhangi bir yerde yolcu bırakma ve alma özelliğine sahip bir otobüs türüdür.
SUBWAY Yeraltı hafif raylı sistemi.
TRAM Yer üstü hafif raylı sistem.
TROLLEYBUS Troleybüs.

Birimler

Gösterimde kullanılan ölçü birimini belirten bir değerler grubu.

Sıralamalar
UNITS_UNSPECIFIED Ölçü birimleri belirtilmemiş. Varsayılan olarak, istekten çıkarılan ölçü birimi kullanılır.
METRIC Metrik ölçü birimleri.
IMPERIAL İngiliz ölçü birimleri.

VehicleEmissionType

Aracın emisyon türünü açıklayan bir değer grubu. Yalnızca DRIVE RouteTravelMode için geçerlidir.

Sıralamalar
VEHICLE_EMISSION_TYPE_UNSPECIFIED Emisyon türü belirtilmedi. Varsayılan olarak GASOLINE değerine ayarlanır.
GASOLINE Benzinle çalışan araçlar
ELECTRIC Elektrikle çalışan araç.
HYBRID Hibrit yakıtlı (ör. benzin + elektrik) araç.
DIESEL Dizel yakıtlı araç

VehicleInfo

Araç emisyon türü gibi araç bilgilerini içerir.

Alanlar
emission_type

VehicleEmissionType

Aracın emisyon türünü açıklar. Yalnızca DRIVE RouteTravelMode için geçerlidir.

Ara nokta

Bir ara noktayı kapsar. Ara noktalar, rotanın başlangıcını ve sonunu işaretler ve rota üzerindeki ara durakları içerir.

Alanlar
via

bool

Bu ara noktayı durak noktası yerine ara hedef olarak işaretler. Yanıt, istekteki her bir "via" olmayan ara nokta için legs dizisine bir giriş ekleyerek gezinin o ayağındaki mola yerleriyle ilgili ayrıntıları sağlar. Rotanın bu ara noktadan durmadan geçmesini istediğinizde bu değeri true olarak ayarlayın. Ara noktalar, legs dizisine giriş eklenmesine neden olmaz ancak yolculuğu ara noktadan geçirir. Bu değeri yalnızca ara noktalarda ayarlayabilirsiniz. Bu alanı terminal yol noktalarında ayarlarsanız istek başarısız olur. ComputeRoutesRequest.optimize_waypoint_order doğru olarak ayarlanırsa bu alan doğru olarak ayarlanamaz. Aksi takdirde istek başarısız olur.
vehicle_stopover

bool

Bu değer, yol noktasının araçların durması için olduğunu belirtir. Amaç, yolcuyu almak veya bırakmaktır. Bu değeri ayarladığınızda, hesaplanan rotaya alma ve bırakmaya uygun olmayan yollardaki via dışındaki yol noktaları dahil edilmez. Bu seçenek yalnızca DRIVE ve TWO_WHEELER seyahat modlarında ve location_type Location olduğunda çalışır.
side_of_road

bool

Bu yol noktasının konumunun, aracın yolun belirli bir tarafında durmasını tercih etmek için kullanıldığını gösterir. Bu değeri ayarladığınızda rota, konumdan geçerek aracın yolun merkezinden konuma doğru olan tarafında durmasını sağlar. Bu seçenek yalnızca DRIVE ve TWO_WHEELER RouteTravelMode için geçerlidir.
Birleştirme alanı location_type. Bir konumu temsil etmenin farklı yolları. location_type yalnızca aşağıdakilerden biri olabilir:
location

Location

İsteğe bağlı bir başlık da dahil olmak üzere coğrafi koordinatlar kullanılarak belirtilen bir nokta.
place_id

string

Ara nokta ile ilişkili ÖY yer kimliği.
address

string

Kullanıcı tarafından okunabilir adres veya artı kodu. Ayrıntılar için https://plus.codes adresini ziyaret edin.