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 bir kalkış ve hedef kombinasyonu için rota bilgilerini içeren bir akış döndürür.

NOT: Bu yöntem, girişte bir yanıt alanı maskesi belirtmenizi gerektirir. Yanıt alanı maskesini $fields veya fields URL parametresini ya da X-Goog-FieldMask HTTP/gRPC başlığını kullanarak sağlayabilirsiniz (kullanılabilir URL parametreleri ve başlıklarına bakın). Değer, alan yollarının virgülle ayrılmış bir listesidir. Alan yollarının nasıl oluşturulacağı ile ilgili bu ayrıntılı belgeleri inceleyin.

Ö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, durum ve öğe dizinlerinin alan maskesi (örnek üretim kurulumu): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

Alan maskenize status eklemeniz gerekir. Aksi takdirde, tüm iletiler sorunsuz görünür. Google, joker karakter (*) yanıt alanı maskesinin kullanılmasını önermez, çünkü:

  • Yalnızca ihtiyacınız olan alanları seçmeniz, sunucumuzun hesaplama döngülerini kaydetmesine yardımcı olarak sonucu size daha düşük bir gecikmeyle sunmamıza olanak tanır.
  • Üretim işinizde yalnızca ihtiyacınız olan alanların seçilmesi, gecikme performansının istikrarlı olmasını sağlar. Gelecekte daha fazla yanıt alanı ekleyebiliriz ve bu yeni alanlar ekstra hesaplama süresi gerektirebilir. Tüm alanları seçerseniz veya en üst düzeydeki tüm alanları seçerseniz, eklediğimiz yeni alanlar yanıta otomatik olarak dahil edileceğinden performansta düşüş yaşayabilirsiniz.
  • Yalnızca ihtiyacınız olan alanların seçilmesi, daha küçük bir yanıt boyutuyla ve dolayısıyla daha yüksek ağ işleme hızıyla sonuçlanır.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Bir dizi terminal ve ara ara noktayla birlikte birincil rotayı isteğe bağlı alternatif rotalarla birlikte döndürür.

NOT: Bu yöntem, girişte bir yanıt alanı maskesi belirtmenizi gerektirir. Yanıt alanı maskesini $fields veya fields URL parametresini ya da X-Goog-FieldMask HTTP/gRPC başlığını kullanarak sağlayabilirsiniz (kullanılabilir URL parametreleri ve başlıklarına bakın). Değer, alan yollarının virgülle ayrılmış bir listesidir. Alan yollarının nasıl oluşturulacağı ile ilgili ayrıntılı belgeleri inceleyin.

Ö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 çizginin alan maskesi (örnek üretim kurulumu): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

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

  • Yalnızca ihtiyacınız olan alanları seçmeniz, sunucumuzun hesaplama döngülerini kaydetmesine yardımcı olarak sonucu size daha düşük bir gecikmeyle sunmamıza olanak tanır.
  • Üretim işinizde yalnızca ihtiyacınız olan alanların seçilmesi, gecikme performansının istikrarlı olmasını sağlar. Gelecekte daha fazla yanıt alanı ekleyebiliriz ve bu yeni alanlar ekstra hesaplama süresi gerektirebilir. Tüm alanları seçerseniz veya en üst düzeydeki tüm alanları seçerseniz, eklediğimiz yeni alanlar yanıta otomatik olarak dahil edileceğinden performansta düşüş yaşayabilirsiniz.
  • Yalnızca ihtiyacınız olan alanların seçilmesi, daha küçük bir yanıt boyutuyla ve dolayısıyla daha yüksek ağ işleme hızıyla sonuçlanır.

ComputeRouteMatrixRequest

ComputeRouteMatrix istek mesajı

Alanlar
origins[]

RouteMatrixOrigin

Zorunlu. Yanıt matrisinin satırlarını belirleyen kaynaklar dizisi. Başlangıç noktalarının ve hedeflerin kardinalitesi için çeşitli boyut kısıtlamaları geçerlidir:

  • place_id veya address olarak belirtilen başlangıç noktalarının sayısı + varış noktalarının toplamı 50'den büyük olmamalıdır.
  • Kaynak sayısı çarpımı × varış noktası sayısı hiçbir durumda 625'ten büyük olmamalıdır.
  • redirect_preference TRAFFIC_AWARE_OPTIMAL değerine ayarlanırsa başlangıç noktası sayısı × hedef sayısı çarpımı 100'den büyük olmamalıdır.
  • Ulaşım_modu TRANSIT olarak ayarlanmışsa kalkış noktası sayısı × varış noktası sayısının ç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, yolu hesaplamak için seçili yönlendirme tercihini kullanmayı dener. Yönlendirme tercihi hataya veya ekstra uzun gecikmeye yol açarsa 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 bu değer varsayılan olarak, istekte bulunduğunuz zamana ayarlanır. NOT: Yalnızca RouteTravelMode, TRANSIT olarak ayarlandığında departure_time öğesini belirtebilirsiniz.
arrival_time

Timestamp

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

string

İsteğe bağlı. "en-US" veya "sr-Latn" gibi BCP-47 dil kodu. Daha fazla bilgi için Unicode Yerel Ayar Tanımlayıcısı bölümüne bakın. Desteklenen dillerin listesi için Dil Desteği sayfasına göz atın. Bu değeri sağlamadığınızda görüntüleme dili, ilk kaynağın konumuna göre belirlenir.
region_code

string

İsteğe bağlı. ccTLD ("üst düzey alan") iki karakterli değer olarak belirtilen bölge kodu. 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ülenen alanlar için ölçü birimlerini belirtir.
extra_computations[]

ExtraComputation

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

TrafficModel

İsteğe bağlı. Trafikteki süreyi hesaplarken kullanılacak varsayımları belirtir. Bu ayar, RouteMatrixElement alanındaki süre alanında döndürülen değeri etkiler. Bu alan, geçmiş ortalamalara göre trafikte tahmini süreyi içerir. RoutingPreference - TRAFFIC_AWARE_OPTIMAL ve RouteTravelMode - DRIVE. Trafik isteniyorsa ve TrafficModel belirtilmezse varsayılan olarak BEST_GUESS olur.
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

İstek tamamlanırken gerçekleştirilecek ekstra hesaplamalar.

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

ComputeRoutesRequest

ComputeRoutes istek mesajı.

Alanlar
origin

Waypoint

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

Waypoint

Zorunlu. Hedef ara nokta.
intermediates[]

Waypoint

İsteğe bağlı. Rota boyunca, durak noktaları dışında durmak veya geçmek için kullanılan ara noktalar grubu (uç noktalar hariç). 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, yolu hesaplamak için seçili yönlendirme tercihini kullanmayı dener. Yönlendirme tercihi hataya veya ekstra uzun gecikmeye yol açarsa 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 kalitesi için 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 bu değer varsayılan olarak, istekte bulunduğunuz zamana ayarlanır. NOT: Yalnızca RouteTravelMode, TRANSIT olarak ayarlandığında departure_time öğesini belirtebilirsiniz. Toplu taşıma seyahatleri, geçmiş en fazla 7 gün veya gelecekteki 100 gün için mevcuttur.
arrival_time

Timestamp

İsteğe bağlı. Varış saati. NOT: Yalnızca RouteTravelMode, TRANSIT olarak ayarlandığında yapılabilir. departure_time veya arrival_time değerlerinden birini belirtebilirsiniz, ancak ikisini birden belirtemezsiniz. Toplu taşıma seyahatleri, geçmiş en fazla 7 gün veya gelecekteki 100 gün için mevcuttur.
compute_alternative_routes

bool

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

RouteModifiers

İsteğe bağlı. Rotaların hesaplanma şeklini etkileyecek koşulları karşılamak için bir dizi koşul.
language_code

string

İsteğe bağlı. "en-US" veya "sr-Latn" gibi BCP-47 dil kodu. Daha fazla bilgi için Unicode Yerel Ayar Tanımlayıcısı bölümüne bakın. Desteklenen dillerin listesi için Dil Desteği sayfasına göz atın. Bu değeri sağlamadığınızda görüntüleme dili, rota isteğinin konumundan tahmin edilir.
region_code

string

İsteğe bağlı. ccTLD ("üst düzey alan") iki karakterli değer olarak belirtilen bölge kodu. 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ülenen alanlar için ölçü birimlerini belirtir. Bu alanlar, NavigationInstruction içindeki instruction alanını içerir. Rota, bacak, 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 konumuna göre belirlenir.
optimize_waypoint_order

bool

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

ReferenceRoute

İsteğe bağlı. Varsayılan rotaya ek olarak isteğin parçası olarak hangi referans rotaların hesaplanacağını belirtir. Referans rota, varsayılan rotadan farklı bir rota hesaplama hedefine sahip rotadır. Örneğin, FUEL_EFFICIENT referans rota hesaplamasında, yakıt verimliliği yüksek bir rota oluşturacak çeşitli parametreler dikkate alınır.
extra_computations[]

ExtraComputation

İsteğe bağlı. İsteği tamamlamak için kullanılabilecek ekstra hesaplamaların listesi. Not: Bu ekstra hesaplamalar yanıtta fazladan alanlar döndürebilir. Bu ek alanların, yanıtta döndürülmesi için 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 alanlarındaki süre alanında döndürülen değeri etkiler. Bu değer, geçmiş ortalamalara göre trafikte tahmini süreyi içerir. TrafficModel, yalnızca RoutingPreference öğesinin TRAFFIC_AWARE_OPTIMAL ve RouteTravelMode öğesinin DRIVE olarak ayarlandığı istekler için kullanılabilir. Trafik isteniyorsa ve TrafficModel belirtilmezse varsayılan olarak BEST_GUESS olur.
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

İstek tamamlanırken gerçekleştirilecek ekstra hesaplamalar.

Sıralamalar
EXTRA_COMPUTATION_UNSPECIFIED Kullanılmıyor. Bu değeri içeren istekler başarısız olur.
TOLLS Rotalar için ücret bilgisi.
FUEL_CONSUMPTION Rotalar için tahmini yakıt tüketimi.
TRAFFIC_ON_POLYLINE Rotalar için trafiğe duyarlı çoklu çizgiler.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions, biçimlendirilmiş bir HTML metin dizesi olarak sunulur. Bu içeriğin olduğu gibi okunması amaçlanmıştır. Bu içerik yalnızca görüntüleme amaçlıdır. Bunu programlı bir şekilde ayrıştırmayın.

ReferenceRoute

ComputeRoutesRequest'te desteklenen bir referans rota.

Sıralamalar
REFERENCE_ROUTE_UNSPECIFIED Kullanılmıyor. Bu değeri içeren istekler başarısız olur.
FUEL_EFFICIENT Yakıt verimliliği yüksek rota. Bu değerle etiketlenen rotaların, yakıt tüketimi gibi parametreler için optimize edildiği belirlenir.

ComputeRoutesResponse

Yanıt mesajını ComputeRoutes koyar.

Alanlar
routes[]

Route

compute_alternatives_routes belirttiğinizde bir hesaplanan rota dizisi (en fazla üç) içerir, belirtmediğinizde ise yalnızca bir rota içerir. Bu dizi birden çok giriş içerdiğinde, ilki en çok önerilen yoldur. Dizi boşsa, hiç rota bulunamadı demektir.
fallback_info

FallbackInfo

Sunucunun tüm giriş tercihleriyle rota sonuçlarını hesaplayamadığı bazı durumlarda, farklı bir hesaplama yöntemi kullanmaya geçebilir. Yedek modu kullanıldığında bu alan, yedek yanıtı hakkında ayrıntılı bilgiler içerir. Aksi takdirde bu alan ayarlanmaz.
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 bu, sunucunun yedek 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 tetiklendiyse mod, orijinal istemci isteğinde ayarlanan yönlendirme tercihinden farklı olabilir.
reason

FallbackReason

Orijinal yanıt yerine yedek yanıtın kullanılma nedeni. Bu alan yalnızca yedek modu tetiklenip yedek yanıt döndürüldüğünde doldurulur.

FallbackReason

Yedek yanıtı kullanma nedenleri.

Sıralamalar
FALLBACK_REASON_UNSPECIFIED Yedek nedeni belirtilmedi.
SERVER_ERROR Tercih ettiğiniz yönlendirme moduyla rotalar hesaplanırken bir sunucu hatası oluştu, ancak alternatif mod tarafından hesaplanan bir sonuç döndürebildik.
LATENCY_EXCEEDED Tercih ettiğiniz rota moduyla hesaplamayı zamanında tamamlayamadık, ancak alternatif bir mod tarafından hesaplanan bir sonucu döndürebildik.

FallbackRoutingMode

Döndürülen yedek yanıt için kullanılan gerçek yönlendirme modu.

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

GeocodedWaypoint

Ara nokta olarak kullanılan konumlarla ilgili ayrıntılar. Yalnızca adres ara noktaları için doldurulur. Adresin coğrafi kodlamasını belirlemek amacıyla 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

Sıfır veya daha fazla tür etiketi biçimindeki sonucun türleri. Desteklenen türler: Adres türleri ve adres bileşeni türleri.
partial_match

bool

Coğrafi kodlayıcının, istenen adresin bir kısmını eşleştirebildiği halde, orijinal istek için tam eşleşme döndürmediğini belirtir. Orijinal isteğinizde yazım yanlışı ve/veya eksik adres olup olmadığını inceleyebilirsiniz.
place_id

string

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

int32

İstekteki ilgili ara ara noktanın dizini. Yalnızca ilgili ara nokta bir ara ara noktaysa doldurulur.

GeocodingResults

Kalkış, hedef ve ara ara noktalar için GeocodedWaypoints içerir. Yalnızca adres ara noktaları için doldurulur.

Alanlar
origin

GeocodedWaypoint

Kaynak coğrafi kodlamalı ara nokta.
destination

GeocodedWaypoint

Coğrafi olarak kodlanan hedef ara nokta.
intermediates[]

GeocodedWaypoint

Her biri, istekte belirtildiği sırada ara noktanın sıfır tabanlı konumuna karşılık gelen bir dizin alanı içeren ara coğrafi kodlu ara noktaların listesi.

LocalizedTime

Yerelleştirilmiş zaman 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 dilimi adıdır, ör. "America/New_York".

Konum

Bir konumu (coğrafi bir nokta ve isteğe bağlı bir başlık) içerir.

Alanlar
lat_lng

LatLng

Ara noktanın coğrafi koordinatları.
heading

Int32Value

Trafiğin akış yönüyle ilişkili pusula istikameti. Bu değer, teslim alma ve bırakma için yolun kenarını belirtir. Başlık değerleri 0 ile 360 arasında olabilir; burada 0 değeri Kuzey yönünü, 90 değeri ise yaklaşan Doğu yönünü ve bu şekilde devam eder. Bu alanı yalnızca DRIVE ve TWO_WHEELER RouteTravelMode için kullanabilirsiniz.

Manevra

Geçerli adım için gerçekleştirilecek gezinme işlemini (örneğin, sola dön, birleştir veya düz) belirten değerler grubu.

Sıralamalar
MANEUVER_UNSPECIFIED Kullanılmıyor.
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 Tam sağa dönün.
UTURN_RIGHT Sağa bir u dönüşü yapın.
TURN_RIGHT Sağa dönün.
STRAIGHT Dümdüz gidin.
RAMP_LEFT Soldaki rampayı kullanın.
RAMP_RIGHT Sağdaki rampayı kullanın.
MERGE Trafikle birleştirin.
FORK_LEFT Soldaki çatalı kullanın.
FORK_RIGHT Doğru çatalı kullanın.
FERRY Feribota binin.
FERRY_TRAIN Feribota doğru 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 göstermek için kullanılır.

RouteLegStep ile ilgili navigasyon talimatlarını içerir.

Alanlar
maneuver

Maneuver

Geçerli adımla ilgili gezinme talimatlarını (ör. sola dönme, birleştirme veya düz) içerir. Bu alan, hangi simgenin gösterileceğini belirler.
instructions

string

Bu adımda gezinme talimatları.

Çoklu çizgi

Kodlanmış bir çoklu çizgi içerir.

Alanlar
Birleştirme alanı polyline_type. Çoklu çizginin türünü içerir. Varsayılan olarak coding_polyline değerine ayarlanır. polyline_type şunlardan yalnızca 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 çizgiyi belirtir.

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 çizgiyi belirtir

PolylineQuality

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

Sıralamalar
POLYLINE_QUALITY_UNSPECIFIED Çoklu çizgi kalite tercihi belirtilmedi. Varsayılan olarak OVERVIEW değerine ayarlanır.
HIGH_QUALITY Artırılmış yanıt boyutu pahasına, OVERVIEW değerinden daha fazla nokta kullanılarak oluşturulan yüksek kaliteli çoklu çizgiyi belirtir. Daha fazla kesinliğe ihtiyacınız olduğunda bu değeri kullanın.
OVERVIEW Az sayıda nokta kullanılarak oluşturulan genel bakış çoklu çizgisini belirtir. Rotanın genel görünümünü gösterirken bu değeri kullanın. Bu seçeneğin kullanılması, HIGH_QUALITY seçeneğine kıyasla daha düşük bir istek gecikmesine neden olur.

Rota

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

Alanlar
route_labels[]

RouteLabel

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

RouteLeg

Rotayı oluşturan bacak koleksiyonu (ara noktaları arasındaki yol segmentleri). Her bacak, via olmayan iki Waypoints arasındaki seyahate karşılık gelir. Örneğin, ara noktaları olmayan bir rotanın yalnızca tek ayağı olur. via dışında bir ara nokta içeren bir rotanın iki ayağı vardır. via ara noktasında bir ara nokta içeren rotanın tek bacağı vardır. Bacakların sırası, origin - intermediates - destination arasındaki ara noktaların sıralamasıyla aynıdır.
distance_meters

int32

Rotanın metre cinsinden seyahat mesafesi.
duration

Duration

Rotada gezinmek için gereken süre. routing_preference öğesini TRAFFIC_UNAWARE olarak ayarlarsanız bu değer static_duration ile aynı olur. routing_preference öğesini 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 rota boyunca yapılan seyahat süresi.
polyline

Polyline

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

string

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

string

Rota görüntülenirken gösterilecek bir uyarı dizisi.
viewport

Viewport

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

RouteTravelAdvisory

Rota hakkında ek bilgi.
optimized_intermediate_waypoint_index[]

int32

optimize_waypoint_order öğesini true olarak ayarlarsanız bu alan, ara ara noktaların optimize edilmiş sıralamasını içerir. Aksi takdirde bu alan boş bırakılır. Örneğin, Başlangıç noktası: LA; Ara ara noktalar: Dallas, Bangor, Phoenix; Hedef: New York; optimize edilmiş ara ara nokta sırası Phoenix, Dallas, Bangor ise, bu alan [2, 0, 1] değerlerini içerir. Dizin, girişte sağlanan ilk ara ara nokta için 0 ile başlar.
localized_values

RouteLocalizedValues

Route özelliklerinin metin temsilleri.
route_token

string

Navigasyon SDK'sına geçirilebilen web güvenli, base64 kodlu rota jetonu, Navigasyon SDK'sının navigasyon sırasında rotayı yeniden oluşturmasına olanak tanır ve yeniden rota çizme durumunda ComputeRoutes'u çağırarak rotayı oluşturduğunuzdaki asıl amacı dikkate alır. Müşteriler bu jetonu opak blob olarak işlemelidir. Okuma veya dönüştürme amaçlı değildir. NOT: Route.route_token, yalnızca ComputeRoutesRequest.routing_preference öğesinin TRAFFIC_AWARE veya TRAFFIC_AWARE_OPTIMAL olarak ayarlandığı isteklerde kullanılabilir. Route.route_token, üzerinden ara noktaları olan istekler için desteklenmez.

RouteLocalizedValues

Belirli mülklerin metin temsilleri.

Alanlar
distance

LocalizedText

Metin biçiminde gösterilen seyahat mesafesi.
duration

LocalizedText

Trafik koşullarının dikkate alındığı ve metin biçiminde gösterilen süre. Not: Trafik bilgisi istemediyseniz bu değer static_duration ile aynı olur.
static_duration

LocalizedText

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

LocalizedText

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

RouteLabel

Rotanın belirli özelliklerini belirleyerek diğerleriyle karşılaştırmak için yararlı olan Route etiketleri.

Sıralamalar
ROUTE_LABEL_UNSPECIFIED Varsayılan (kullanılmıyor).
DEFAULT_ROUTE Rota hesaplaması için varsayılan "en iyi" rota döndürüldü.
DEFAULT_ROUTE_ALTERNATE Varsayılan "en iyi" rotanın bir alternatifidir. compute_alternative_routes belirtildiğinde bunun gibi rotalar döndürülür.
FUEL_EFFICIENT Yakıt verimliliği yüksek rota. Bu değerle etiketlenen rotalar, yakıt tüketimi gibi Eko parametreler için optimize edilmiş olarak belirlenir.

RouteLeg

via olmayan ara noktalar arasında bir segment içeriyor.

Alanlar
distance_meters

int32

Rota aşamasının metre cinsinden seyahat mesafesi.
duration

Duration

Bacakta gezinmek için gereken süre. route_preference, TRAFFIC_UNAWARE olarak ayarlanırsa bu değer static_duration ile aynı olur. 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, ayak boyunca seyahat süresi.
polyline

Polyline

Bu bacağın, her step çoklu çizgisini içeren genel çoklu çizgisi.
start_location

Location

Bu bacağı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 bacağın son 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 bacak içindeki segmentleri belirten bir adım dizisi. Her adım bir gezinme talimatını temsil eder.
travel_advisory

RouteLegTravelAdvisory

Rota ayağı üzerinde kullanıcının bilgilendirilmesi gereken ek bilgileri (ör. olası trafik bölgesi kısıtlamaları) içerir.
localized_values

RouteLegLocalizedValues

RouteLeg özelliklerinin metin temsilleri.
steps_overview

StepsOverview

Bu RouteLeg, adımlarla ilgili genel bakış bilgileri. Bu alan yalnızca TRANSIT rotaları için doldurulur.

RouteLegLocalizedValues

Belirli mülklerin metin temsilleri.

Alanlar
distance

LocalizedText

Metin biçiminde gösterilen seyahat mesafesi.
duration

LocalizedText

Metin biçiminde gösterilen ve trafik koşullarının dikkate alındığı süre. Not: Trafik bilgisi istemediyseniz bu değer static_duration ile aynı değer olacaktır.
static_duration

LocalizedText

Trafik koşullarının dikkate alınmadığı ve metin biçiminde gösterilen süre.

StepsOverview

RouteLegStep listeleri hakkında genel bakış bilgileri sağlar.

Alanlar
multi_modal_segments[]

MultiModalSegment

RouteLeg.steps'nin farklı çok modlu segmentleri hakkında özet bilgiler. RouteLeg adımlarda çok modlu segment içermiyorsa bu alan doldurulmaz.

MultiModalSegment

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

Alanlar
navigation_instruction

NavigationInstruction

Çok modlu segment için NavigationTalimatlar.
travel_mode

RouteTravelMode

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

int32

Çok modlu bir segmentin başlangıcı olan karşılık gelen RouteLegStep dizini.
step_end_index

int32

Çok modlu bir segmentin sonu olan karşılık gelen RouteLegStep dizini.

RouteLegStep

Bir RouteLeg segmenti içerir. Bir adım, tek bir gezinme 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 alanda değer bulunmayabilir.
static_duration

Duration

Trafik koşulları dikkate alınmadan bu adımdaki seyahat süresi. Bazı durumlarda bu alanda değer bulunmayabilir.
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 temsilleri.
transit_details

RouteLegStepTransitDetails

Ulaşım şekli TRANSIT ise bu adımla ilgili ayrıntılar.
travel_mode

RouteTravelMode

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

RouteLegStepLocalizedValues

Belirli mülklerin metin temsilleri.

Alanlar
distance

LocalizedText

Metin biçiminde gösterilen seyahat mesafesi.
static_duration

LocalizedText

Trafik koşullarının dikkate alınmadığı ve metin biçiminde gösterilen süre.

RouteLegStepTransitDetails

RouteLegStep için TRANSIT rotalarıyla ilgili ek bilgiler.

Alanlar
stop_details

TransitStopDetails

Adım için varış ve kalkış durakları hakkında bilgi.
localized_values

TransitDetailsLocalizedValues

RouteLegStepTransitDetails özelliklerinin metin temsilleri.
headsign

string

Araçta veya kalkış durağında belirtildiği şekilde bu hatta seyahat edilecek yönü belirtir. Gideceğiniz yol genellikle terminal istasyonudur.
headway

Duration

Beklenen süreyi, aynı duraktan yapılan kalkışlar arasındaki süre olarak belirtir. Örneğin, 600 mesafe saniye değeri varsa, otobüsü kaçırırsanız on dakika beklemeniz gerekir.
transit_line

TransitLine

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

int32

Kalkıştan varış durağına kadar aktarma sayısı. Bu sayıya varış durağı dahil, ancak kalkış durağı dahil değildir. Örneğin, rotanız A Durağı'ndan ayrılıyor, B ve C duraklarından geçiyorsa ve D durağına geliyorsa, stop_count değeri 3 sonucunu döndürür.
trip_short_text

string

Yolculara yapılacak toplu taşıma seyahatini tanımlamak için tarifelerde ve tabelalarda görünen metin. Metin, bir hizmet günü içindeki bir geziyi benzersiz bir şekilde tanımlamalıdır. Örneğin, "538" San Jose, Kaliforniya'dan hafta içi 15:10'da Sacramento, Kaliforniya'ya giden Amtrak treninin trip_short_text hattıdır.

TransitDetailsLocalizedValues

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

Alanlar
arrival_time

LocalizedTime

Biçimlendirilmiş metin biçiminde saat ve karşılık gelen saat dilimi.
departure_time

LocalizedTime

Biçimlendirilmiş metin biçiminde saat ve karşılık gelen saat dilimi.

TransitStopDetails

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

Alanlar
arrival_stop

TransitStop

Adım için varış noktası hakkında bilgi.
arrival_time

Timestamp

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

TransitStop

Adımın kalkış noktasıyla ilgili bilgiler.
departure_time

Timestamp

Adımın tahmini kalkış saati.

RouteLegStepTravelAdvisory

Kullanıcının bilgilendirilmesi 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 adımda hakkında bilgilendirilmesi gereken ek bilgileri (ör. olası trafik bölgesi kısıtlamaları) içerir.

Alanlar
toll_info

TollInfo

Belirli RouteLeg üzerindeki ücretli geçişlerle ilgili bilgileri içerir. Bu alan yalnızca RouteLeg üzerinde ücretli geçiş olmasını bekliyorsak doldurulur. Bu alan ayarlanır, ancak tahmini_fiyat alt alanı doldurulmazsa, söz konusu yolun ücretli geçişler içermesini bekleriz, ancak tahmini bir fiyat bilmiyoruz. Bu alan yoksa RouteLeg üzerinde ücretli geçiş yoktur.
speed_reading_intervals[]

SpeedReadingInterval

Trafik yoğunluğunu ayrıntılı olarak veren hızlı okuma aralıkları. TRAFFIC_AWARE ve TRAFFIC_AWARE_OPTIMAL yönlendirme tercihleri için geçerlidir. Aralıklar, çakışma olmadan RouteLeg öğesinin çoklu çizgisinin tamamını kapsar. Belirtilen aralığın başlangıç noktası, kendisinden önce gelen aralığın bitiş noktasıyla aynı.

Ö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. Varış noktası

RouteMatrixElement

ComputeRouteMatrix API'sinde bir başlangıç/hedef çifti için hesaplanan rota bilgilerini içerir. Bu proto, istemciye yayınlanabilir.

Alanlar
status

Status

Bu öğe için hata durum kodu.
condition

RouteMatrixElementCondition

Rotanın bulunup bulunmadığını belirtir. 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 öğesini TRAFFIC_UNAWARE olarak ayarlarsanız bu değer static_duration ile aynı olur. routing_preference öğesini 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 rota boyunca seyahatin süresi.
travel_advisory

RouteTravelAdvisory

Rota hakkında ek bilgi. Örneğin: kısıtlama bilgileri ve geçiş ücreti bilgileri
fallback_info

FallbackInfo

Sunucunun söz konusu başlangıç/hedef çifti için verilen tercihlerle güzergahı hesaplayamadığı bazı durumlarda, farklı bir hesaplama modu kullanmaya geçebilir. Yedek modu kullanıldığında bu alan, yedek yanıtı hakkında ayrıntılı bilgiler içerir. Aksi takdirde bu alan ayarlanmaz.
localized_values

LocalizedValues

RouteMatrixElement özelliklerinin metin temsilleri.
origin_index

int32

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

int32

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

LocalizedValues

Belirli mülklerin metin temsilleri.

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 bilgileri 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 uygun olmadığında kullanılır.
ROUTE_EXISTS Bir rota bulundu ve öğeye ilişkin 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ıç noktası
route_modifiers

RouteModifiers

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

RouteModifiers

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

Alanlar
avoid_tolls

bool

Doğru değerine ayarlandığında, uygun olduğu durumlarda ücretli yollardan kaçınarak paralı yol içermeyen rotalara öncelik verilir. Yalnızca DRIVE ve TWO_WHEELER RouteTravelMode için geçerlidir.
avoid_highways

bool

Doğru değerine ayarlandığında, makul olduğunda otoyollardan kaçınarak otoyol içermeyen rotalara öncelik verilir. Yalnızca DRIVE ve TWO_WHEELER RouteTravelMode için geçerlidir.
avoid_ferries

bool

Doğru değerine ayarlandığında, makul durumlarda feribotlardan kaçınarak feribot içermeyen rotalara öncelik verilir. Yalnızca DRIVE ve TWO_WHEELER RouteTravelMode için geçerlidir.
avoid_indoor

bool

Doğru değerine ayarlandığında, makul olduğunda iç mekanlarda gezinmekten kaçınır ve iç mekan navigasyonunu içermeyen rotalara öncelik verir. Yalnızca WALK RouteTravelMode için geçerlidir.
vehicle_info

VehicleInfo

Araç bilgilerini belirtir.
toll_passes[]

TollPass

Ücretli geçiş kartlarıyla ilgili bilgileri içerir. Ücretli geçiş kartı sağlanırsa API geçiş fiyatını döndürmeye çalışır. Ücretli geçiş kartı sağlanmamışsa API, geçiş ücretini bilinmiyor olarak kabul eder ve nakit fiyatı iade etmeye ç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

Rota üzerindeki ücretli geçişlerle ilgili bilgileri içerir. Bu alan yalnızca rotada ücretli geçiş olması bekleniyorsa doldurulur. Bu alan ayarlanırsa ancak estimatedPrice alt alanı doldurulmazsa rota ücretli geçişleri içerir ancak tahmini fiyat bilinmiyor. Bu alan ayarlanmazsa rotada ücretli geçiş yoktur.
speed_reading_intervals[]

SpeedReadingInterval

Trafik yoğunluğunu ayrıntılı olarak veren hızlı okuma aralıkları. TRAFFIC_AWARE ve TRAFFIC_AWARE_OPTIMAL yönlendirme tercihleri için geçerlidir. Aralıklar, çakışma olmadan rotanın çoklu çizgisinin tamamını kapsar. Belirtilen aralığın başlangıç noktası, kendisinden önce gelen aralığın bitiş noktasıyla aynı.

Ö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.
route_restrictions_partially_ignored

bool

Dönüş rotası için, istenen ulaşım şekline veya rota değiştiricilere uygun olmayan kısıtlamalar olabilir.
transit_fare

Money

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

RouteTravelMode

Ulaşım şeklini belirtmek için kullanılan bir değer grubu. NOT: WALK, BICYCLE ve TWO_WHEELER rotaları beta sürümündedir ve bazen boş kaldırımlar, yaya yolları veya bisiklet yolları eksik olabilir. Uygulamanızda gösterdiğiniz tüm yürüyüş, bisiklet ve iki tekerlekli 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 aracıyla seyahat.
BICYCLE Bisikletle seyahat edin.
WALK Yürüyerek seyahat edin.
TWO_WHEELER İki tekerlekli, motorlu taşıt. Örneğin, motosiklet. Bunun, insan gücüyle çalışan BICYCLE ulaşım modundan farklı olduğunu unutmayın.
TRANSIT Mevcut olduğu durumlarda, toplu taşıma rotalarıyla seyahat edin.

RoutingPreference

Rotayı hesaplarken dikkate alınacak faktörleri belirten bir değer 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ğerin kullanılması en düşük gecikmeyi üretir. 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 zamana bağlı ortalama trafik koşullarına dayanmaktadır. Dolayısıyla, rotalar geçici olarak kapatılmış yollar içerebilir. Belirli bir isteğe ilişkin sonuçlar, yol ağındaki değişiklikler, güncellenen ortalama trafik koşulları ve hizmetin dağıtılmış yapısına bağlı olarak zaman içinde değişiklik gösterebilir. Benzer güzergâhlar arasında herhangi bir zamanda veya sıklıkta, neredeyse eşdeğer rotalar arasında da sonuçlar farklılık gösterebilir.
TRAFFIC_AWARE Canlı trafik koşullarını dikkate alarak rotaları hesaplar. TRAFFIC_AWARE_OPTIMAL uygulamasının aksine, gecikmeyi önemli ölçüde azaltmak için bazı optimizasyonlar uygulanır.
TRAFFIC_AWARE_OPTIMAL En fazla performans optimizasyonunu uygulamadan, canlı trafik koşullarını dikkate alarak rotaları hesaplar. Bu değerin kullanılması en yüksek gecikmeyi üretir.

SpeedReadingInterval

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

Alanlar
start_polyline_point_index

int32

Çoklu çizgideki bu aralığın başlangıç dizini.
end_polyline_point_index

int32

Çoklu çizgideki bu aralığın bitiş dizini.

Birleştirme alanı speed_type.

speed_type şunlardan yalnızca biri olabilir:
speed

Speed

Bu aralıktaki trafik hızı.

Hız

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

Sıralamalar
SPEED_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
NORMAL Normal hız, yavaşlama algılanmadı.
SLOW Yavaşlama algılandı ancak trafik sıkışıklığı oluşmadı.
TRAFFIC_JAM Trafik sıkışıklığı algılandı.

TollInfo

Route veya RouteLeg üzerinde ücretli geçiş bilgilerini içerir.

Alanlar
estimated_price[]

Money

İlgili Route veya RouteLeg için ücretli geçişlerin parasal tutarı. Bu liste, paralı istasyonlar tarafından ücretlendirilmesi beklenen her para birimi için bir para tutarı içerir. Bu liste, genellikle ücretli geçişlerin tek bir para biriminde olduğu rotalar için yalnızca bir öğe içerir. Uluslararası seyahatler için bu liste, geçiş ücretlerini farklı para birimlerinde yansıtmak üzere birden çok öğe içerebilir.

TollPass

Dünya genelinde desteklediğimiz geçiş geçişlerinin listesi.

Sıralamalar
TOLL_PASS_UNSPECIFIED Kullanılmıyor. Bu değer kullanılırsa istek başarısız olur.
AU_ETOLL_TAG Sidney geçiş kartı. Daha ayrıntılı bilgi için https://www.myetoll.com.au adresini ziyaret edin.
AU_EWAY_TAG Sidney geçiş kartı. Daha fazla bilgi için https://www.tollpay.com.au adresini ziyaret edin.
AU_LINKT Avustralya genelinde geçerli geçiş kartı. Daha ayrıntılı bilgi için https://www.linkt.com.au/ adresini ziyaret edin.
AR_TELEPASE Arjantin geçiş kartı. Daha ayrıntılı bilgi için https://telepase.com.ar adresini ziyaret edin
BR_AUTO_EXPRESO Brezilya geçiş kartı. Daha ayrıntılı bilgi için https://www.autoexpreso.com adresini ziyaret edebilirsiniz.
BR_CONECTCAR Brezilya geçiş kartı. Daha ayrıntılı bilgi için https://conectcar.com adresini ziyaret edin.
BR_MOVE_MAIS Brezilya geçiş kartı. Daha ayrıntılı bilgi için https://movemais.com adresini ziyaret edin.
BR_PASSA_RAPIDO Brezilya geçiş kartı. Daha ayrıntılı bilgi için https://pasorapido.gob.do/ adresini ziyaret edin.
BR_SEM_PARAR Brezilya geçiş kartı. Daha fazla bilgi için https://www.semparar.com.br adresini ziyaret edebilirsiniz.
BR_TAGGY Brezilya geçiş kartı. Daha ayrıntılı bilgi için https://taggy.com.br adresini ziyaret edin.
BR_VELOE Brezilya geçiş kartı. Daha ayrıntılı bilgi için https://veloe.com.br/site/onde-usar adresini ziyaret edin.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Kanada-ABD sınır geçişi.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Kanada-ABD sınır geçişi.
CA_US_BLUE_WATER_EDGE_PASS Kanada, Ontario ve Michigan, ABD sınır geçişi.
CA_US_CONNEXION Kanada, Ontario ve Michigan, ABD sınır geçişi.
CA_US_NEXUS_CARD Kanada-ABD sınır geçişi.
ID_E_TOLL Endonezya. Geçiş ücretleri için ödeme yapmak üzere birden fazla banka tarafından sunulan e-kart. Bankalar aracılığıyla gönderilen tüm e-kartlardan aynı ödeme alınır. Bu nedenle yalnızca bir numaralandırma değeri gerekir. Ör. 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 Japan ETC. Ücretli geçişleri toplamak için elektronik kablosuz sistemi. https://www.go-etc.jp/
JP_ETC2 Japan ETC2.0 ile uyumlu olması gerekir. Araçlardaki cihazlar ve yoldaki antenler arasında daha fazla indirim ve çift yönlü iletişim sunan ETC'nin yeni sürümü. https://www.go-etc.jp/etc2/index.html
MX_IAVE Meksika 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 geçiş kartı şirketi. Mexico City'de faaliyet gösteren birçok şirketten biri. Daha fazla bilgi için https://www.televia.com.mx adresini ziyaret edin.
MX_TELEVIA Meksika geçiş kartı şirketi. Mexico City'de faaliyet gösteren birçok şirketten biri. https://www.televia.com.mx
MX_VIAPASS Meksika geçiş kartı. Daha ayrıntılı bilgi 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 Kanada, ABD.
US_CA_FASTRAK_CAV_STICKER Sürücünün, DMV tarafından verilen Temiz Hava Aracı (CAV) çıkartmasına ek olarak FasTrak girişine sahip olduğunu gösterir. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO, ABD.
US_CO_GO_PASS CO, ABD.
US_DE_EZPASSDE Almanya, 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 Hindistan, 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 geçiş türü artık mevcut olmadığı için 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

Trafikteki süreyi hesaplarken kullanılacak varsayımları belirtir. Bu ayar, yanıttaki duration alanında döndürülen değeri etkiler. Bu alan, geçmiş ortalamalara göre trafikte tahmini süreyi içerir.

Sıralamalar
TRAFFIC_MODEL_UNSPECIFIED Kullanılmayan. 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ünde bulundurularak en iyi seyahat süresi tahmini olması gerektiğini belirtir. departure_time bugün yaklaştıkça canlı trafik daha önemli hale gelir.
PESSIMISTIC Döndürülen sürenin, çoğu gündeki gerçek seyahat süresinden uzun olması gerektiğini belirtir. Ancak, trafik koşulları çok kötü olan ara sıra günler bu değeri aşabilir.
OPTIMISTIC Döndürülen sürenin, çoğu gündeki gerçek seyahat süresinden kısa olması gerektiğini belirtir. Ancak, trafik koşulları özellikle iyi olan bazen günler bu değerden daha hızlı olabilir.

TransitAgency

Transit hattı işleten bir toplu taşıma acentesi.

Alanlar
name

string

Bu transit operatörün adı.
phone_number

string

Transit operatörün yerel ayara özel biçimlendirilmiş telefon numarası.
uri

string

Transit operatörü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 transit operatörü (veya acenteleri).
name

string

Bu toplu taşıma hattının tam adı. Örneğin, "8 Bulvar Yerel".
uri

string

Transit operatörü tarafından sağlanan bu toplu taşıma hattına ait URI.
color

string

Bu çizginin tabelalarında yaygın olarak kullanılan renk. Onaltılı 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 normalde "M7" veya "355" gibi bir satır numarası olur.
text_color

string

Bu satırın tabelalarındaki metinde yaygın olarak kullanılan renk. Onaltılı olarak gösterilir.
vehicle

TransitVehicle

Bu toplu taşıma hattında çalışan aracın türü.

TransitPreferences

Döndürülen rotayı etkileyen TRANSIT tabanlı rotalar için tercihler.

Alanlar
allowed_travel_modes[]

TransitTravelMode

TRANSIT rotası alınırken kullanılacak bir dizi ulaşım şekli. Varsayılan olarak desteklenen tüm ulaşım modları kullanılır.
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 rotanın sınırlı miktarda yürüyüş tercih etmesi gerektiğini belirtir.
FEWER_TRANSFERS Hesaplanan rotanın sınırlı sayıda aktarma tercih etmesi gerektiğini belirtir.

TransitTravelMode

Toplu taşıma modunu belirtmek için kullanılan bir değer grubu.

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

TransitStop

Toplu taşıma durağı hakkında bilgi.

Alanlar
name

string

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

Location

Enlem/boylam koordinatlarıyla ifade edilen durağın konumu.

TransitVehicle

Toplu taşıma rotalarında kullanılan bir araç hakkında bilgiler.

Alanlar
name

LocalizedText

Bu aracın adı (büyük harfle).
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 tabelalarına göre bu araç türüyle ilişkili simgenin URI'si.

TransitVehicleType

Toplu taşıma güzergahları için kullanılan araçların türü.

Sıralamalar
TRANSIT_VEHICLE_TYPE_UNSPECIFIED Kullanılmayan.
BUS Otobüs.
CABLE_CAR Genellikle yerde, kabloyla çalışan bir araç. Teleferikler GONDOLA_LIFT türünde olabilir.
COMMUTER_TRAIN Banliyö treni.
FERRY Feribot.
FUNICULAR Kabloyla dik bir yokuştan çekilen araç. Füniküler genellikle iki arabadan oluşur ve her araba diğeri için karşı ağırlık görevi görür.
GONDOLA_LIFT Teleferik.
HEAVY_RAIL Ağır tren yolu.
HIGH_SPEED_TRAIN Hızlı tren.
INTERCITY_BUS Şehirler arası otobüs.
LONG_DISTANCE_TRAIN Şehirlerarası tren.
METRO_RAIL Hafif raylı toplu taşıma.
MONORAIL Monoray.
OTHER Diğer tüm araçlar.
RAIL Raylı sistem.
SHARE_TAXI Paylaşımlı taksi, güzergahın herhangi bir yerine yolcu alıp alma özelliğine sahip bir otobüs türüdür.
SUBWAY Hafif raylı sistem.
TRAM Yer üstü hafif raylı sistem.
TROLLEYBUS Troleybüs.

Birimler

Ekranda kullanılan ölçü birimini belirten değerler grubu.

Sıralamalar
UNITS_UNSPECIFIED Ölçü birimleri belirtilmedi. Varsayılan olarak istekten tahmin edilen ölçü birimi kullanılır.
METRIC Metrik ölçü birimleri.
IMPERIAL İngiliz ölçü birimleridir.

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 Benzinli/benzinli araç.
ELECTRIC Elektrikle çalışan araç.
HYBRID Hibrit yakıt (ör. benzinli + elektrikli) araç.
DIESEL Dizel yakıtla çalışan araç.

VehicleInfo

Araç emisyonu 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 referans noktasını içerir. Referans noktaları bir rotanın hem başlangıcını hem de sonunu işaretler ve rota boyunca ara durakları içerir.

Alanlar
via

bool

Bu ara noktayı bir ara hedef yerine bir ara hedef olarak işaretler. İstekteki geçiş olmayan her ara nokta için yanıt, gezinin ilgili ayağındaki duraklamalarla ilgili ayrıntıları sağlamak amacıyla legs dizisine bir giriş ekler. Rotanın bu ara noktadan geçmesini istiyorsanız bu değeri true olarak ayarlayın. Ara noktalar, legs dizisine bir giriş eklenmesine neden olmaz, ancak yolculuğu ara nokta boyunca yönlendirir. Bu değeri yalnızca ara olan ara noktalarda ayarlayabilirsiniz. Bu alanı terminal ara noktalarında ayarlarsanız istek başarısız olur. ComputeRoutesRequest.optimize_waypoint_order doğru değerine ayarlanırsa bu alan doğru olarak ayarlanamaz; aksi takdirde istek başarısız olur.
vehicle_stopover

bool

Araçların durması için işaret noktası olduğunu belirtir. Burada amaç, alma veya bırakma amacı vardır. Bu değeri ayarladığınızda hesaplanan rota, alma ve bırakma için uygun olmayan yollarda via olmayan ara noktaları içermez. 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 ara noktanın konumunun, aracın yolun belirli bir tarafında durması için tercih edilmesinin amaçlandığını belirtir. Bu değeri ayarladığınızda, araç, konumun yolun merkezine doğru eğildiği bir yolda durabileceği şekilde rota, konumdan geçer. Bu seçenek yalnızca DRIVE ve TWO_WHEELER RouteTravelMode için çalışır.
Birleştirme alanı location_type. Bir yeri temsil etmenin farklı yolları. location_type şunlardan yalnızca 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 noktayla ilişkili ÖY Yeri Kimliği.
address

string

İnsan tarafından okunabilir bir adres veya artı kodu. Ayrıntılar için https://plus.codes sayfasına bakın.