Package google.maps.routing.v2

Dizin

Rotalar

Routes API.

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Kalkış ve varış noktalarının listesini alır ve her 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. $fields veya fields URL parametresini ya da X-Goog-FieldMask HTTP/gRPC başlığını kullanarak yanıt alanı maskesini sağlayabilirsiniz (kullanılabilir URL parametreleri ve üstbilgilerine 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ı dokümanlara 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 (örnek üretim kurulumu): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

Alan maskenize status eklemeniz çok önemlidir, aksi takdirde tüm iletilerde sorun yoktur. Google, aşağıdaki nedenlerle joker karakter (*) yanıt alanı maskesinin kullanılmasını önermez:

  • 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 döndürmemizi sağlar.
  • Üretim işinizde yalnızca ihtiyaç duyduğunuz alanları seçmeniz, gecikme performansının istikrarlı olmasını sağlar. Gelecekte daha fazla yanıt alanı ekleyebiliriz ve bu yeni alanlar daha fazla 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üşüşle karşılaşabilirsiniz.
  • Yalnızca ihtiyacınız olan alanları seçtiğinizde yanıt boyutu küçülür ve böylece daha yüksek ağ işleme hızı elde edilir.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

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

NOT: Bu yöntem, girişte bir yanıt alanı maskesi belirtmenizi gerektirir. $fields veya fields URL parametresini ya da bir HTTP/gRPC üstbilgisi X-Goog-FieldMask kullanarak yanıt alanı maskesini sağlayabilirsiniz (kullanılabilir URL parametreleri ve üstbilgilerine 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ı dokümanlara 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 için alan maskesi (örnek üretim kurulumu): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google, aşağıdaki nedenlerle joker karakter (*) yanıt alanı maskesinin kullanılmasını veya alan maskesinin üst düzeyde (routes) belirtilmesini önermez:

  • 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 döndürmemizi sağlar.
  • Üretim işinizde yalnızca ihtiyaç duyduğunuz alanları seçmeniz, gecikme performansının istikrarlı olmasını sağlar. Gelecekte daha fazla yanıt alanı ekleyebiliriz ve bu yeni alanlar daha fazla 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üşüşle karşılaşabilirsiniz.
  • Yalnızca ihtiyacınız olan alanları seçtiğinizde yanıt boyutu küçülür ve böylece daha yüksek ağ işleme hızı elde edilir.

ComputeRouteMatrixRequest

ComputeRouteMatrix istek mesajı

Alanlar
origins[]

RouteMatrixOrigin

Zorunlu. Yanıt matrisinin satırlarını belirleyen kaynaklar dizisi. Kaynakların ve hedeflerin kardinalitesi için çeşitli boyut kısıtlamaları uygulanır:

  • place_id veya address olarak belirtilen kaynak sayısı ile hedef sayısının toplamı 50'den büyük olmamalıdır.
  • Hiçbir durumda kaynak sayısının çarpımı × hedef sayısı 625'ten büyük olmamalıdır.
  • yönlendirme_preference TRAFFIC_AWARE_OPTIMAL olarak ayarlanırsa kaynak sayısının çarpımı × hedef sayısının çarpımı 100'den büyük olmamalıdır.
  • seyahat_modu TRANSIT olarak ayarlanırsa kaynak sayısının çarpımı × hedef sayısının çarpımı 100'den büyük olmamalıdır.
destinations[]

RouteMatrixDestination

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

travel_mode

RouteTravelMode

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

routing_preference

RoutingPreference

İsteğe bağlı. Rotanın nasıl hesaplanacağını belirtir. Sunucu, yolu hesaplamak için seçilen yönlendirme tercihini kullanmaya çalışır. Yönlendirme tercihi hatayla veya ekstra uzun gecikmeyle sonuçlanırsa bir 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 değer, varsayılan olarak isteği yaptığınız zaman olur. 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 ayarlanabilir. departure_time ve arrival_time öğelerinden birini belirtebilirsiniz ancak ikisini birden belirtemezsiniz.

language_code

string

İsteğe bağlı. "en-US" gibi BCP-47 dil kodu veya "sr-Latn" girin. 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 bölümüne bakın. Bu değeri sağlamadığınızda, görüntüleme dili ilk kaynağın konumundan türetilir.

region_code

string

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

units

Units

İsteğe bağlı. Görünen alanlar için ö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 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üre hesaplanırken kullanılacak varsayımları belirtir. Bu ayar, geçmiş ortalamalara göre trafikte tahmini süreyi içeren RouteMatrixElement içindeki süre alanında döndürülen değeri etkiler. RoutingPreference - TRAFFIC_AWARE_OPTIMAL ve RouteTravelMode - DRIVE. Trafik isteniyorsa ve TrafficModel belirtilmezse varsayılan olarak BEST_GUESS değerine ayarlanı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 bir transit_preferences belirtebilirsiniz.

ExtraComputation

İstek tamamlanırken gerçekleştirilecek ek 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ı referans noktası.

destination

Waypoint

Zorunlu. Hedef referans noktası.

intermediates[]

Waypoint

İsteğe bağlı. Güzergah üzerinde durmak veya geçmek için rota üzerinde bir dizi ara nokta (uç noktalar hariç). En fazla 25 ara ara nokta desteklenir.

travel_mode

RouteTravelMode

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

routing_preference

RoutingPreference

İsteğe bağlı. Rotanın nasıl hesaplanacağını belirtir. Sunucu, yolu hesaplamak için seçilen yönlendirme tercihini kullanmaya çalışır. Yönlendirme tercihi hataya veya ekstra uzun gecikmeye neden olursa bir 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 değer, varsayılan olarak isteği yaptığınız zaman olur. NOT: Yalnızca RouteTravelMode, TRANSIT olarak ayarlandığında geçmişte bir departure_time belirtebilirsiniz. Geçmişteki 7 güne veya gelecekteki 100 güne kadar toplu taşıma seyahatleri mevcuttur.

arrival_time

Timestamp

İsteğe bağlı. Varış saati. NOT: Yalnızca RouteTravelMode, TRANSIT olarak ayarlandığında ayarlanabilir. departure_time ve arrival_time öğelerinden birini belirtebilirsiniz ancak ikisini birden belirtemezsiniz. Geçmişteki 7 güne veya gelecekteki 100 güne kadar toplu taşıma seyahatleri mevcuttur.

compute_alternative_routes

bool

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

route_modifiers

RouteModifiers

İsteğe bağlı. Rotaların hesaplanma şeklini etkileyen ve yerine getirilecek bir dizi koşul.

language_code

string

İsteğe bağlı. "en-US" gibi BCP-47 dil kodu veya "sr-Latn" girin. 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 bölümüne bakın. Bu değeri sağlamadığınızda, görüntüleme dili, rota isteğinin konumundan belirlenir.

region_code

string

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

units

Units

İsteğe bağlı. Görünen 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 konumundan tahmin edilir.

optimize_waypoint_order

bool

İsteğe bağlı. Doğru değerine ayarlanırsa hizmet, belirtilen ara noktaları yeniden sıralayarak rotanın toplam maliyetini en aza indirmeye çalışır. Ara ara noktaların herhangi 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ş görünür.

requested_reference_routes[]

ReferenceRoute

İsteğe bağlı. Varsayılan rotaya ek olarak istek kapsamında hangi referans rotalarını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, ideal yakıt verimliliği rotası oluşturacak çeşitli parametreler dikkate alınır.

extra_computations[]

ExtraComputation

İsteğe bağlı. İsteği tamamlamak için kullanılabilecek ek hesaplamaların listesi. Not: Bu ek 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üre hesaplanırken kullanılacak varsayımları belirtir. Bu ayar, geçmiş ortalamalara göre trafikteki tahmini süreyi içeren Route ve RouteLeg alanlarındaki süre alanında döndürülen değeri etkiler. TrafficModel, yalnızca RoutingPreference değerini TRAFFIC_AWARE_OPTIMAL ve RouteTravelMode değerini DRIVE olarak ayarlayan istekler için kullanılabilir. Trafik isteniyorsa ve TrafficModel belirtilmezse varsayılan olarak BEST_GUESS değerine ayarlanı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 bir transit_preferences belirtebilirsiniz.

ExtraComputation

İstek tamamlanırken gerçekleştirilecek ek 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 bilgileri.
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çerikler olduğu gibi okunmalıdır. Bu içerik yalnızca görüntüleme içindir. Kodu 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 belirlenmiştir.

ComputeRoutesResponse

ComputeRoute, yanıt mesajını gönderir.

Alanlar
routes[]

Route

compute_alternatives_routes değerini belirttiğinizde bir hesaplanan rota dizisi (en fazla üç) ve eklemediğinizde yalnızca bir rota içerir. Bu dizi birden fazla giriş içerdiğinde ilki en önerilen rotadır. Dizinin boş olması, herhangi bir rota bulunamadığı anlamına gelir.

fallback_info

FallbackInfo

Bazı durumlarda sunucu, tüm giriş tercihlerini kullanarak rota sonuçlarını hesaplayamadığında, farklı bir hesaplama yöntemi kullanmaya geçebilir. Yedek mod 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ın ayarlanması, 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ı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 nedeni belirtilmedi.
SERVER_ERROR Tercih ettiğiniz yönlendirme moduyla rotalar hesaplanırken bir sunucu hatası oluştu. Ancak, alternatif bir mod tarafından hesaplanan bir sonuç döndürebildik.
LATENCY_EXCEEDED Tercih ettiğiniz yönlendirme moduyla hesaplamayı zamanında tamamlayamadık, ancak alternatif bir mod tarafından hesaplanan bir sonuç 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 öğesinin kullanıldığını gösterir.
FALLBACK_TRAFFIC_AWARE Yanıtı hesaplamak için TRAFFIC_AWARE RoutingPreference öğesinin kullanıldığını gösterir.

GeocodedWaypoint

Referans noktası olarak kullanılan konumlarla ilgili ayrıntılar. Yalnızca adres ara noktaları için doldurulur. Adresin coğrafi olarak neye kodlandığının belirlenmesi 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

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

Coğrafi kodlayıcının, orijinal istek için tam eşleşme döndürmediğini, ancak istenen adresin bir kısmını eşleştirebildiğini belirtir. Yazım hataları ve/veya eksik adres olup olmadığını kontrol etmek için orijinal isteği inceleyebilirsiniz.

place_id

string

Bu sonucun yer kimliği.

intermediate_waypoint_request_index

int32

İstekteki karşılık gelen ara ara noktanın dizini. Yalnızca karşılık gelen ara nokta bir 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 kodlu ara nokta.

destination

GeocodedWaypoint

Hedef coğrafi kodlu ara nokta.

intermediates[]

GeocodedWaypoint

Her biri, istekte belirtilen sırada referans noktasının sıfır tabanlı konumuna karşılık gelen bir dizin alanı içeren ara coğrafi kodlu ara noktaları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. Bu değer, IANA Saat Dilimi Veritabanı'nda tanımlanan saat diliminin adıdır (ör. "Amerika/New_York".

Konum

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

Alanlar
lat_lng

LatLng

Referans noktasının coğrafi koordinatları.

heading

Int32Value

Trafiğin akış yönüyle ilişkilendirilen pusula başlığı. Bu değer, alma ve bırakma için yolun kenarını belirtir. Başlık değerleri 0 ile 360 arasında olabilir. Burada 0, gereken Kuzeyin başlığını, 90 değeri ise gereken Doğu başlığını belirtir. 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 belirten bir değer grubu (örneğin, sola dönme, birleştirme veya düz).

Sıralamalar
MANEUVER_UNSPECIFIED Kullanılmıyor.
TURN_SLIGHT_LEFT Hafifçe sola dönün.
TURN_SHARP_LEFT Sola keskin bir dönüş yapın.
UTURN_LEFT Sola u dönüşü yapın.
TURN_LEFT Sola dönün.
TURN_SLIGHT_RIGHT Sağa hafif dönüş yapın.
TURN_SHARP_RIGHT Sağa keskin bir dönüş yapı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 Sağdaki rampayı kullanın.
MERGE Trafiğe ekleyin.
FORK_LEFT Soldaki çatalı kullanın.
FORK_RIGHT Doğru çatalı kullanın.
FERRY Feribota binin.
FERRY_TRAIN Feribota giden trene binin.
ROUNDABOUT_LEFT Döner kavşakta 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ı 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 gezinmeye ilişkin talimatlar.

Çoklu çizgi

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

Alanlar
Birleştirme alanı polyline_type. Çoklu çizgi türünü içerir. Varsayılan olarak coding_polyline değeri kullanılı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 çizgiyi 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 kalitesi tercihi belirtilmedi. Varsayılan olarak OVERVIEW değerine ayarlanır.
HIGH_QUALITY Artan yanıt boyutu pahasına, OVERVIEW değerinden daha fazla nokta kullanılarak oluşturulan yüksek kaliteli bir çoklu çizgiyi belirtir. Daha fazla hassasiyete 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 bir özetini görüntülerken bu değeri kullanın. Bu seçenek kullanıldığında, HIGH_QUALITY seçeneğine kıyasla daha düşük bir istek gecikmesi olur.

Rota

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

Alanlar
route_labels[]

RouteLabel

Rotanın diğer özellikleriyle karşılaştırmak üzere belirli mülklerin tanımlanmasında yararlı olan Route etiketleri.

legs[]

RouteLeg

Rotayı oluşturan ayak koleksiyonu (ara noktaların arasındaki yol segmentleri). Her bacak, via olmayan iki Waypoints arasındaki seyahate karşılık gelir. Örneğin, ara ara noktaları olmayan bir rotanın yalnızca tek ayağı vardır. via olmayan bir ara nokta içeren rotanın iki ayağı var. Bir via ara ara noktası içeren rotanın tek ayağı var. Ayakların sırası, origin - intermediates - destination ara noktalarının sıralamasıyla eşleşir.

distance_meters

int32

Rotanın metre cinsinden seyahat mesafesi.

duration

Duration

Rotada gezinmek için gereken süre. routing_preference özelliğini 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, rota boyunca gerçekleştirilen 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

Rotayı görüntülerken gösterilecek bir dizi uyarı.

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 doğru değerine ayarlarsanız bu alan, ara noktaların optimize edilmiş sıralamasını içerir. Aksi takdirde bu alan boş bırakılır. Örneğin, Kaynak: LA; Ara ara noktalar: Dallas, Bangor, Phoenix; Hedef: New York; ve optimize edilmiş ara ara nokta sırası Phoenix, Dallas, Bangor ise bu alanda [2, 0, 1] değerleri yer alır. Dizin, girişte sağlanan ilk ara ara noktası için 0 ile başlar.

localized_values

RouteLocalizedValues

Route özelliklerinin metin gösterimleri.

route_token

string

Navigasyon SDK'sına iletilebilecek web güvenli, base64 kodlu rota jetonu. Bu jeton, Navigasyon SDK'sının navigasyon sırasında rotayı yeniden oluşturmasına olanak tanır ve yeniden rota oluşturma durumunda ComputeRoutes'u çağırarak rotayı oluşturduğunuzda asıl amacı dikkate alır. Müşteriler bu jetonu opak bir blob olarak değerlendirmelidir. Değerini istekler arasında karşılaştırmayın. Tam olarak aynı rota döndürülse bile bu jeton değişebilir. NOT: Route.route_token yalnızca ComputeRoutesRequest.routing_preference öğesini TRAFFIC_AWARE veya TRAFFIC_AWARE_OPTIMAL olarak ayarlayan isteklerde kullanılabilir. Route.route_token, Via ara noktaları olan istekler için desteklenmez.

RouteLocalizedValues

Belirli tesislerin metin temsilleri.

Alanlar
distance

LocalizedText

Metin biçiminde gösterilen seyahat mesafesi.

duration

LocalizedText

Trafik koşullarını dikkate alan, metin biçiminde gösterilen süre. Not: Trafik bilgilerini istemediyseniz, bu değer static_duration ile aynı olacaktır.

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.

RouteLabel

Rotanın diğer özellikleriyle karşılaştırmak üzere belirli mülklerin tanımlanmasında yararlı olan Route etiketleri.

Sıralamalar
ROUTE_LABEL_UNSPECIFIED Varsayılan - kullanılmaz.
DEFAULT_ROUTE Varsayılan "en iyi" rota hesaplaması için döndürülen rotadır.
DEFAULT_ROUTE_ALTERNATE Varsayılan "en iyi"ye bir alternatif yol gösterir. compute_alternative_routes belirtildiğinde buna benzer 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 eko parametreler için optimize edildiği tespit edilmiştir.

RouteLeg

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

Alanlar
distance_meters

int32

Rota ayağı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 ya da 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 bacak için, her step adlı kullanıcının çoklu çizgisini içeren genel çoklu çizgi.

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 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 belirten bir dizi adım. Her adım bir gezinme talimatını temsil eder.

travel_advisory

RouteLegTravelAdvisory

Bir 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 gösterimleri.

steps_overview

StepsOverview

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

RouteLegLocalizedValues

Belirli tesislerin metin temsilleri.

Alanlar
distance

LocalizedText

Metin biçiminde gösterilen seyahat mesafesi.

duration

LocalizedText

Trafik koşullarını dikkate alan ve metin biçiminde gösterilen süre. Not: Trafik bilgilerini istemediyseniz bu değer, static_duration ile aynı değer olacaktır.

static_duration

LocalizedText

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

StepsOverview

RouteLegStep listesi hakkında genel bilgi sağlar.

Alanlar
multi_modal_segments[]

MultiModalSegment

RouteLeg.steps aracının farklı çok modlu segmentleri hakkındaki bilgileri özetledi. RouteLeg, adımlarda çok modlu segment içermiyorsa bu alan doldurulmaz.

MultiModalSegment

RouteLeg.steps öğesinin farklı çok modlu segmentleri hakkında özetlenmiş bilgiler sağlar. Çok modlu segment, aynı RouteTravelMode öğesine 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

RouteLeg segmentini içerir. Bir adım, tek bir gezinme talimatına karşılık gelir. Rota ayakları basamaklardan 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ımda gerçekleştirilen seyahat süresi. Bazı durumlarda bu alanda değer bulunmayabilir.

polyline

Polyline

Bu adımla ilişkilendirilen ç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

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 tesislerin metin temsilleri.

Alanlar
distance

LocalizedText

Metin biçiminde gösterilen seyahat mesafesi.

static_duration

LocalizedText

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

RouteLegStepTransitDetails

TRANSIT rotalarıyla ilgili RouteLegStep 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 işaretlendiği şekilde bu çizgide seyahat edilecek yönü belirtir. Yol tarifi genellikle terminal istasyonudur.

headway

Duration

Beklenen süreyi, aynı duraktan yapılan kalkışlar arasındaki süre olarak belirtir. Örneğin, ileriye dönük saniye değeri 600 ise otobüsü kaçırırsanız on dakikalık bir bekleme süresi beklersiniz.

transit_line

TransitLine

Bu adımda kullanılan toplu taşıma hattıyla ilgili bilgi.

stop_count

int32

Kalkış noktasından varış durağına kadar geçen durak sayısı. Bu sayıya varış durağı dahildir ancak kalkış noktası dahil değildir. Örneğin, rotanız A Durağı'ndan kalkıyor, B ve C duraklarından geçiyor ve D durağına varıyorsa, stop_count 3 döndürür.

trip_short_text

string

Yolcuların toplu taşıma seyahatini tanımlamak için zaman çizelgelerinde ve tabelalarda gösterilen metin. Metin, bir hizmet günü içindeki bir seyahati benzersiz şekilde tanımlamalıdır. Örneğin, "538" Kaliforniya, San Jose, Kaliforniya'da hafta içi saat 15:10'da Sacramento, Kaliforniya'ya giden Amtrak treninin trip_short_text.

TransitDetailsLocalizedValues

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

Alanlar
arrival_time

LocalizedTime

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

departure_time

LocalizedTime

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

TransitStopDetails

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

Alanlar
arrival_stop

TransitStop

Adımın varış noktasıyla ilgili bilgiler.

arrival_time

Timestamp

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

departure_stop

TransitStop

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

departure_time

Timestamp

Adımın tahmini kalkış saati.

RouteLegStepTravelAdvisory

Bir ayak basamağındaki olası trafik bölgesi kısıtlamaları gibi kullanıcının bilgilendirilmesi gereken ek bilgileri içerir.

Alanlar
speed_reading_intervals[]

SpeedReadingInterval

NOT: Bu alan şu anda doldurulmamaktadır.

RouteLegTravelAdvisory

Olası trafik bölgesi kısıtlamaları gibi, ayak adımında kullanıcının bilgilendirilmesi gereken ek bilgileri içerir.

Alanlar
toll_info

TollInfo

Belirli RouteLeg üzerindeki ücretli geçişler hakkında bilgiler içerir. Bu alan yalnızca RouteLeg üzerinde ücretli geçiş olmasını beklersek doldurulur. Bu alan ayarlanır ancak estimated_price alt alanı doldurulmazsa söz konusu yolun ücretli geçiş içermesini bekleriz ancak tahmini bir fiyat bilmeyiz. Bu alan yoksa RouteLeg hattında ücretli geçiş yoktur.

speed_reading_intervals[]

SpeedReadingInterval

Trafik yoğunluğunu ayrıntılı şekilde gösteren hızlı okuma aralıkları. TRAFFIC_AWARE ve TRAFFIC_AWARE_OPTIMAL yönlendirme tercihleri için geçerlidir. Aralıklar, çakışma olmadan RouteLeg çoklu çizgisinin tamamını kapsar. Belirtilen bir aralığın başlangıç noktası, önceki 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. Hedef ara nokta

RouteMatrixElement

ComputeRouteMatrix API'de bir kaynak/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ı 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 özelliğini 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, rota boyunca seyahat etme süresi.

travel_advisory

RouteTravelAdvisory

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

fallback_info

FallbackInfo

Bazı durumlarda sunucu, rotayı söz konusu kaynak/hedef çifti için verilen tercihlerle hesaplayamadığında farklı bir hesaplama modu kullanmaya geçebilir. Yedek mod 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 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 tesislerin 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 özelliği uygun olmadığında kullanılır.
ROUTE_EXISTS Bir rota bulundu ve öğeye karşılık gelen bilgiler dolduruldu.
ROUTE_NOT_FOUND Rota bulunamadı. Rota bilgilerini içeren alanlar (ör. distance_meters veya duration) öğede doldurulmaz.

RouteMatrixOrigin

ComputeRouteMatrixRequest için tek bir kaynak

Alanlar
waypoint

Waypoint

Zorunlu. Başlangıç noktası referans 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 içerir.

Alanlar
avoid_tolls

bool

Politika, Doğru değerine ayarlandığında makul olduğu durumlarda paralı yollardan kaçınarak paralı yollar içermeyen rotalara öncelik verir. Yalnızca DRIVE ve TWO_WHEELER RouteTravelMode için geçerlidir.

avoid_highways

bool

Doğru değerine ayarlandığında, otoyol içermeyen rotalara öncelik vererek makul olan durumlarda otoyollardan kaçınır. Yalnızca DRIVE ve TWO_WHEELER RouteTravelMode için geçerlidir.

avoid_ferries

bool

True (doğru) değerine ayarlandığında, feribot içermeyen rotaları tercih ederek makul olan durumlarda feribotlardan kaçınır. Yalnızca DRIVE veTWO_WHEELER RouteTravelMode için geçerlidir.

avoid_indoor

bool

Doğru değerine ayarlandığında, iç mekan navigasyonu içermeyen rotaları tercih ederek makul olan durumlarda iç mekanlarda gezinmekten kaçınır. 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. Geçiş kartı sağlanırsa API, geçiş fiyatını döndürmeye çalışır. Ücretli geçiş kartları sağlanmazsa API, geçiş ücretini bilinmez olarak değerlendirir ve nakit fiyatı iade etmeye çalışır. Yalnızca DRIVE ve TWO_WHEELER RouteTravelMode için geçerlidir.

RouteTravelAdvisory

Olası trafik bölgesi kısıtlamaları gibi kullanıcının bilgilendirilmesi gereken ek bilgileri içerir.

Alanlar
toll_info

TollInfo

Rota üzerindeki ücretli geçişler hakkında bilgiler içerir. Bu alan yalnızca rotada ücretli geçiş bekleniyorsa doldurulur. Bu alan ayarlanır ancak estimatedPrice alt alanı doldurulmazsa rota ücretli geçiş içeriyor ancak tahmini fiyat bilinmiyor. Bu alan ayarlanmazsa rotada ücretli geçiş beklenmiyordur.

speed_reading_intervals[]

SpeedReadingInterval

Trafik yoğunluğunu ayrıntılı şekilde gösteren 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 bir aralığın başlangıç noktası, önceki 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öndürülen rota, istenen ulaşım şekli veya rota değiştiricilere uygun olmayan kısıtlamalara sahip olabilir.

transit_fare

Money

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

RouteTravelMode

Seyahat şeklini belirtmek için kullanılan bir değer grubu. NOT: WALK, BICYCLE ve TWO_WHEELER rotaları beta sürümünde olduğundan bazen açık kaldırımlar, yaya yolları veya bisiklet yolları olmayabilir. 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 etme.
BICYCLE Bisikletle seyahat edin.
WALK Yürüyerek seyahat edin.
TWO_WHEELER İki tekerlekli, motorlu araç. Örneğin, motosiklet. Bunun insan destekli modu kapsayan BICYCLE ulaşım modundan farklı olduğunu unutmayın.
TRANSIT Mevcut olduğu durumlarda toplu taşıma rotalarıyla seyahat edin.

RoutingPreference

Güzergah hesaplanırken dikkate alınacak faktörleri belirten bir değer kümesi.

Sıralamalar
ROUTING_PREFERENCE_UNSPECIFIED Yönlendirme tercihi belirtilmedi. Varsayılan olarak TRAFFIC_UNAWARE değerine ayarlanır.
TRAFFIC_UNAWARE Rotaları, canlı trafik koşullarını dikkate almadan hesaplar. Trafik koşullarının önemli olmadığı veya geçerli olmadığı durumlarda uygundur. Bu değerin kullanılması en düşük gecikmeyi sağlar. Not: RouteTravelMode DRIVE ve TWO_WHEELER için, seçilen rota ve süre, güncel yol koşullarına değil, yol ağına ve zamandan bağımsız ortalama trafik koşullarına göre belirlenir. Sonuç olarak, rotalar geçici olarak kapalı olan yolları içerebilir. 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şiklik gösterebilir. Sonuçlar, neredeyse eşdeğer rotalar arasında herhangi bir zamanda veya sıklıkta değişiklik gösterebilir.
TRAFFIC_AWARE Rotaları, canlı trafik koşullarını dikkate alarak hesaplar. TRAFFIC_AWARE_OPTIMAL işlevinin aksine, gecikmeyi önemli ölçüde azaltmak için bazı optimizasyonlar uygulanır.
TRAFFIC_AWARE_OPTIMAL Çoğu performans optimizasyonu uygulamadan rotaları canlı trafik koşullarını dikkate alarak hesaplar. Bu değerin kullanılması en yüksek gecikmeyi sağlar.

SpeedReadingInterval

Bir çoklu çizginin 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 göz önüne alındığında SpeedReadingInterval, bir aralık tanımlar ve aşağıdaki kategorileri kullanarak trafiğini açıklar.

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ırması.

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

Bir Route veya RouteLeg ile ilgili ücretli geçiş bilgilerini içerir.

Alanlar
estimated_price[]

Money

İlgili Route veya RouteLeg için ücretli geçişlerin parasal tutarı. Bu liste, ücretli geçiş istasyonları tarafından ücretlendirilmesi beklenen her para birimine ilişkin bir tutar içerir. Genellikle bu liste, belirli bir para biriminde ücretli geçiş yapılan rotalar için yalnızca bir öğe içerir. Uluslararası seyahatler için bu listede, ücretlerin farklı para birimlerinde gösterilmesi için birden fazla öğe bulunabilir.

TollPass

Dünya genelinde desteklediğimiz ücretli geçişlerin 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 fazla 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çiş kartı. https://www.linkt.com.au/ adresinden daha fazla bilgi edinebilirsiniz.
AR_TELEPASE Arjantin geçiş kartı. Daha fazla bilgi için https://telepase.com.ar adresini ziyaret edin.
BR_AUTO_EXPRESO Brezilya geçiş kartı. Daha fazla bilgi için https://www.autoexpreso.com adresini ziyaret edin.
BR_CONECTCAR Brezilya geçiş kartı. Daha fazla bilgiyi https://conectcar.com adresinde bulabilirsiniz.
BR_MOVE_MAIS Brezilya geçiş kartı. Ayrıntılı bilgi için https://movemais.com sayfasını ziyaret edin.
BR_PASSA_RAPIDO Brezilya geçiş kartı. Daha fazla 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 edin.
BR_TAGGY Brezilya geçiş kartı. Daha fazla ayrıntı için https://taggy.com.br adresini ziyaret edebilirsiniz.
BR_VELOE Brezilya geçiş kartı. Daha ayrıntılı bilgiyi https://veloe.com.br/site/onde-usar adresinde bulabilirsiniz.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Kanada-ABD sınır kapısı.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Kanada-ABD sınır kapısı.
CA_US_BLUE_WATER_EDGE_PASS Ontario, Kanada- Michigan, ABD sınır kapısı.
CA_US_CONNEXION Ontario, Kanada- Michigan, ABD sınır kapısı.
CA_US_NEXUS_CARD Kanada-ABD sınır kapısı.
ID_E_TOLL Endonezya. Çeşitli bankalar tarafından ücretli geçiş ödemeleri için kullanılan e-kart. Bankalar üzerinden gönderilen tüm e-kartlardan aynı ücret alındığından yalnızca bir numaralandırma 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 Japan vb. Ücretli geçişleri toplamak için kullanılan elektronik kablosuz sistem. https://www.go-etc.jp/
JP_ETC2 Japonya ETC2.0. ETC'nin yeni sürümü, indirim ve yoldaki araçlar ile antenler arasında iki yönlü iletişim imkanı sunuyor. 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'da otoyol geçiş kartı şirketi. Mexico City'de faaliyet gösteren birçok kişiden biri. Daha fazla bilgiyi https://www.televia.com.mx adresinde bulabilirsiniz.
MX_TELEVIA Meksika'da otoyol geçiş kartı şirketi. Mexico City'de faaliyet gösteren birçok kişiden biri. https://www.televia.com.mx
MX_VIAPASS Meksika geçiş kartı. Diğer ayrıntıları https://www.viapass.com.mx/viapass/web_home.aspx adresinde bulabilirsiniz.
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 FasTrak kartı olduğunu belirtir. 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ığı için desteği sonlandı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üre hesaplanırken kullanılacak varsayımları belirtir. Bu ayar, yanıttaki duration alanında döndürülen değeri etkiler. Bu değer, geçmiş ortalamalara göre trafikte tahmini süreyi içerir.

Sıralamalar
TRAFFIC_MODEL_UNSPECIFIED Kullanılmayan. Belirtilirse varsayılan olarak BEST_GUESS değerine ayarlanır.
BEST_GUESS Hem geçmiş trafik koşulları hem de canlı trafik hakkında bilinenlere göre, döndürülen duration değerinin en iyi seyahat süresi tahmini olması gerektiğini belirtir. departure_time 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 daha uzun olması gerektiğini belirtir. Bununla birlikte, özellikle kötü trafik koşullarına sahip ara sıra günlerde 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. Bununla birlikte, trafik koşulları özellikle iyi olan günlerde, bu değerden daha hızlı olabilir.

TransitAgency

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

Alanlar
name

string

Bu toplu taşıma acentesinin adı.

phone_number

string

Transit operatörüne ait yerel ayara özgü biçimlendirilmiş telefon numarası.

uri

string

Transit operatörüne ait URI.

TransitLine

Bu adımda kullanılan toplu taşıma hattıyla ilgili bilgileri içerir.

Alanlar
agencies[]

TransitAgency

Bu toplu taşıma hattını işleten toplu taşıma acentesi (veya acenteleri).

name

string

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

uri

string

bu toplu taşıma hattının, toplu taşıma acentesi tarafından sağlandığı URI'yı kullanın.

color

string

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

icon_uri

string

Bu satırla ilişkili simgenin URI'sı.

name_short

string

Bu toplu taşıma hattının kısa adı. Bu ad, normalde "M7" gibi bir satır numarasıdır. veya "355" gibi).

text_color

string

Bu satır için tabelalardaki metinde yaygın olarak kullanılan renk. Onaltılık sayı 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ı rota tercihleri.

Alanlar
allowed_travel_modes[]

TransitTravelMode

TRANSIT rotası alınırken kullanılacak ulaşım şekilleri. Varsayılan olarak desteklenen tüm ulaşım şekilleri 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 aktarımı tercih etmesi gerektiğini belirtir.

TransitTravelMode

Ulaşım modunu belirtmek için kullanılan bir değer grubu.

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

TransitStop

Bir toplu taşıma durağıyla ilgili bilgiler.

Alanlar
name

string

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

location

Location

Enlem/boylam koordinatlarıyla ifade edilen durak konumu.

TransitVehicle

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

Alanlar
name

LocalizedText

Bu aracın adının büyük harfle yazılmış adı.

type

TransitVehicleType

Kullanılan aracın türü.

icon_uri

string

Bu araç türüyle ilişkilendirilmiş 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 rotaları için taşıt türü.

Sıralamalar
TRANSIT_VEHICLE_TYPE_UNSPECIFIED Kullanılmayan.
BUS Otobüs.
CABLE_CAR Bir kablo üzerinde çalışan, genellikle yerde çalışan taşıttır. Teleferikler GONDOLA_LIFT türünde olabilir.
COMMUTER_TRAIN Banliyö treni.
FERRY Feribot.
FUNICULAR Dik bir eğimden kabloyla ç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 Tramvay.
HIGH_SPEED_TRAIN Hızlı tren.
INTERCITY_BUS Şehirlerarası otobüs.
LONG_DISTANCE_TRAIN Şehirlerarası tren.
METRO_RAIL Hafif raylı taşıt toplu taşıması.
MONORAIL Monoray.
OTHER Diğer tüm araçlar.
RAIL Demiryolu.
SHARE_TAXI Paylaşımlı taksi, rotasının her yerinden yolcuları indirip yolcu alma yeteneğine sahip bir otobüs türüdür.
SUBWAY Yer altı hafif raylı sistem.
TRAM Yer üstü hafif raylı sistem.
TROLLEYBUS Troleybüs.

Birimler

Ekranda kullanılan ölçü birimini belirten değer 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çü 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 Benzinli/benzin yakıtlı araç.
ELECTRIC Elektrikle çalışan araç.
HYBRID Hibrit yakıtlı (ör. benzin + elektrikli) araç.
DIESEL Dizel yakıtlı 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ı rotanın hem başlangıcını hem de sonunu belirtir ve rota boyunca ara duraklar içerir.

Alanlar
via

bool

Bu ara noktayı bir bitiş noktası olarak değil, bir ara hedef olarak işaretler. İstekteki her bir ara nokta için yanıt, gezinin o ayağındaki duraklamalarla ilgili ayrıntıları sağlamak amacıyla legs dizisine bir giriş ekler. Rotanın bu ara noktadan devam etmesini istiyorsanız bu değeri true olarak ayarlayın. Geçiş noktaları, legs dizisine bir giriş eklenmesine neden olmaz ancak yolculuğu, ara nokta üzerinden yönlendirir. Bu değeri yalnızca 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 noktanın, araçların kalkış veya indirme amacıyla duracak şekilde tasarlandığını belirtir. Bu değeri ayarladığınızda, hesaplanan rota, alma ve bırakma için uygun olmayan yollarda via dışındaki ara noktaları içermez. Bu seçenek yalnızca DRIVE ile TWO_WHEELER ulaşım şekilleri için 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ına yönelik bir tercih olduğunu belirtir. Bu değeri ayarladığınızda rota, yerden geçer. Böylece araç, konumun merkezine doğru ağırlık verdiği yol kenarında durabilir. Bu seçenek yalnızca DRIVE ve TWO_WHEELER RouteTravelMode için çalışır.

Birleştirme alanı location_type. Bir konumu 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

Referans noktasıyla ilişkilendirilen ÖY yer kimliği.

address

string

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