Package google.maps.routing.v2

Dizin

Rotalar

Routes API

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

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

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

Örneğin, bu yöntemde:

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

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

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

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

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

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

Örneğin, bu yöntemde:

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

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

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

ComputeRouteMatrixRequest

ComputeRouteMatrix istek mesajı

Alanlar
origins[]

RouteMatrixOrigin

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

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

RouteMatrixDestination

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

RouteTravelMode

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

RoutingPreference

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

Timestamp

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

Timestamp

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

string

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

string

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

Units

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

ExtraComputation

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

TrafficModel

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

TransitPreferences

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

ExtraComputation

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

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

ComputeRoutesRequest

ComputeRoutes istek mesajı.

Alanlar
origin

Waypoint

Zorunlu. Başlangıç noktası.
destination

Waypoint

Zorunlu. Hedef ara nokta.
intermediates[]

Waypoint

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

RouteTravelMode

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

RoutingPreference

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

PolylineQuality

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

PolylineEncoding

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

Timestamp

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

Timestamp

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

bool

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

RouteModifiers

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

string

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

string

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

Units

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

bool

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

ReferenceRoute

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

ExtraComputation

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

TrafficModel

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

TransitPreferences

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

ExtraComputation

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

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

ReferenceRoute

ComputeRoutesRequest üzerinde desteklenen bir referans rota.

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

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

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

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

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

ComputeRoutesResponse

ComputeRoutes yanıt mesajı.

Alanlar
routes[]

Route

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

FallbackInfo

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

GeocodingResults

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

FallbackInfo

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

Alanlar
routing_mode

FallbackRoutingMode

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

FallbackReason

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

FallbackReason

Yedek yanıtı kullanma nedenleri.

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

FallbackRoutingMode

Geri dönen 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 kullanıldığını gösterir.
FALLBACK_TRAFFIC_AWARE Yanıtı hesaplamak için TRAFFIC_AWARE RoutingPreference kullanıldığını gösterir.

GeocodedWaypoint

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

Alanlar
geocoder_status

Status

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

string

Sonucun türleri(sıfır veya daha fazla tür etiketi şeklinde). 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ştirebilmesine rağmen orijinal istek için tam eşleşme döndürmediğini gösterir. Yazım hataları ve/veya eksik adres olup olmadığını görmek için orijinal isteği inceleyebilirsiniz.
place_id

string

Bu sonucun yer kimliği.
intermediate_waypoint_request_index

int32

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

GeocodingResults

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

Alanlar
origin

GeocodedWaypoint

Başlangıç noktası coğrafi kodlu ara noktası.
destination

GeocodedWaypoint

Hedef coğrafi kodlu ara nokta.
intermediates[]

GeocodedWaypoint

Her biri, istekte belirtildikleri sıraya göre ara nokta konumunun sıfır tabanlı konumuna karşılık gelen bir dizin alanı içeren, ara coğrafi kodlanmış 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. Değer, IANA Saat Dilimi Veritabanı'nda tanımlanan saat diliminin adıdır (ör. "America/New_York").

Konum

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

Alanlar
lat_lng

LatLng

Ara noktanın coğrafi koordinatları.
heading

Int32Value

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

Manevra

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

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 Keskin bir şekilde sağa dönün.
UTURN_RIGHT Sağa U dönüşü yapın.
TURN_RIGHT Sağa dönün.
STRAIGHT Düz gidin.
RAMP_LEFT Soldaki rampayı kullanın.
RAMP_RIGHT Doğru rampayı kullanın.
MERGE Trafiğe katılın.
FORK_LEFT Soldaki çatala girin.
FORK_RIGHT Sağdaki yolu seç.
FERRY Feribota binin.
FERRY_TRAIN Feribota giden trene binin.
ROUNDABOUT_LEFT Döner kavşaktan sola dönün.
ROUNDABOUT_RIGHT Döner kavşaktan sağa dönün.
DEPART İlk manevra.
NAME_CHANGE Sokak adı değişikliğini belirtmek için kullanılır.

RouteLegStep için gezinme talimatlarını kapsar.

Alanlar
maneuver

Maneuver

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

string

Bu adımda gezinmeyle ilgili talimatlar.

Çoklu çizgi

Kodlanmış bir çoklu çizgiyi kapsar.

Alanlar
polyline_type birleşik alanı. Çoklu çizgi türünü kapsar. Varsayılan olarak encoded_polyline değerine ayarlanır. polyline_type aşağıdakilerden 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 çizgi belirtir.

PolylineDetails

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

Alanlar
flyover_info[]

FlyoverInfo

Çoklu çizgi boyunca fareyle üzerine gelme ayrıntıları.
narrow_road_info[]

NarrowRoadInfo

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

FlyoverInfo

Çoklu çizgi boyunca üstten görünümle ilgili bilgileri kapsar.

Alanlar
flyover_presence

RoadFeatureState

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

PolylinePointIndex

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

NarrowRoadInfo

Çoklu çizgi boyunca dar yollarla ilgili bilgileri kapsar.

Alanlar
narrow_road_presence

RoadFeatureState

Yalnızca çıkış. Belirli bir çoklu çizgi aralığında dar bir yol olup olmadığını gösterir.
polyline_point_index

PolylinePointIndex

Çoklu çizgi boyunca dar yolla ilgili bilgilerin konumu.

PolylinePointIndex

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

Alanlar
start_index

int32

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

int32

Çoklu çizgi üzerindeki bu ayrıntının bitiş dizini.

RoadFeatureState

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

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

PolylineEncoding

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

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

PolylineQuality

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

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

Rota

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

Alanlar
route_labels[]

RouteLabel

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

RouteLeg

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

int32

Rotanın seyahat mesafesi (metre cinsinden).
duration

Duration

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

Duration

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

Polyline

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

string

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

string

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

Viewport

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

RouteTravelAdvisory

Rota hakkında ek bilgiler.
optimized_intermediate_waypoint_index[]

int32

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

RouteLocalizedValues

Route özelliklerinin metin gösterimleri.
route_token

string

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

NOT: Route.route_token yalnızca ComputeRoutesRequest.routing_preference değerinin TRAFFIC_AWARE veya TRAFFIC_AWARE_OPTIMAL olarak ayarlandığı istekler için kullanılabilir. Route.route_token, ara nokta içeren isteklerde desteklenmez.
polyline_details

PolylineDetails

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

RouteLocalizedValues

Belirli özelliklerin metin gösterimleri.

Alanlar
distance

LocalizedText

Metin biçiminde gösterilen seyahat mesafesi.
duration

LocalizedText

Metin biçiminde gösterilen ve sorgunun bölgesine göre yerelleştirilmiş süre. Trafik koşullarını dikkate alır. Not: Trafik bilgisi istemediyseniz bu değer, static_duration ile aynı değerdir.
static_duration

LocalizedText

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

LocalizedText

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

RouteLabel

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

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

RouteLeg

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

Alanlar
distance_meters

int32

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

Duration

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

Duration

Trafik koşulları dikkate alınmadan hesaplanan, rotanın bir bölümündeki seyahat süresi.
polyline

Polyline

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

Location

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

Location

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

RouteLegStep

Bu ayağın içindeki segmentleri gösteren bir dizi adım. Her adım bir gezinme talimatını temsil eder.
travel_advisory

RouteLegTravelAdvisory

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

RouteLegLocalizedValues

RouteLeg özelliklerinin metin gösterimleri.
steps_overview

StepsOverview

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

RouteLegLocalizedValues

Belirli özelliklerin metin gösterimleri.

Alanlar
distance

LocalizedText

Metin biçiminde gösterilen seyahat mesafesi.
duration

LocalizedText

Metin biçiminde gösterilen ve sorgunun bölgesine göre yerelleştirilmiş süre. Trafik koşullarını dikkate alır. Not: Trafik bilgisi istemediyseniz bu değer, static_duration ile aynı değerdir.
static_duration

LocalizedText

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

StepsOverview

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

Alanlar
multi_modal_segments[]

MultiModalSegment

RouteLeg.steps'nın farklı çok formatlı segmentleri hakkında özetlenmiş bilgiler. RouteLeg adımlarında çok formatlı segment yoksa bu alan doldurulmaz.

MultiModalSegment

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

Alanlar
navigation_instruction

NavigationInstruction

Çok formatlı segment için NavigationInstruction.
travel_mode

RouteTravelMode

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

int32

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

int32

Çok formatlı bir segmentin sonu olan ilgili RouteLegStep dizini.

RouteLegStep

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

Alanlar
distance_meters

int32

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

Duration

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

Polyline

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

Location

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

Location

Bu adımın bitiş konumu.
navigation_instruction

NavigationInstruction

Gezinme talimatları.
travel_advisory

RouteLegStepTravelAdvisory

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

RouteLegStepLocalizedValues

RouteLegStep özelliklerinin metin gösterimleri.
transit_details

RouteLegStepTransitDetails

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

RouteTravelMode

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

RouteLegStepLocalizedValues

Belirli özelliklerin metin gösterimleri.

Alanlar
distance

LocalizedText

Metin biçiminde gösterilen seyahat mesafesi.
static_duration

LocalizedText

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

RouteLegStepTransitDetails

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

Alanlar
stop_details

TransitStopDetails

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

TransitDetailsLocalizedValues

RouteLegStepTransitDetails özelliklerinin metin gösterimleri.
headsign

string

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

Duration

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

TransitLine

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

int32

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

stop_count

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

string

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

TransitDetailsLocalizedValues

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

Alanlar
arrival_time

LocalizedTime

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

LocalizedTime

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

TransitStopDetails

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

Alanlar
arrival_stop

TransitStop

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

Timestamp

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

TransitStop

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

Timestamp

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

RouteLegStepTravelAdvisory

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

Alanlar
speed_reading_intervals[]

SpeedReadingInterval

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

RouteLegTravelAdvisory

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

Alanlar
toll_info

TollInfo

Belirli bir RouteLeg üzerindeki geçiş ücretleri hakkında bilgi içerir. Bu alan yalnızca RouteLeg üzerinde ücretli geçişlerin olacağını tahmin ediyorsak ve TOLLS, isteğin ComputeRoutesRequest.extra_computations bölümüne dahil edilmişse doldurulur. Bu alan ayarlanmış ancak estimated_price alt alanı doldurulmamışsa yolun ücretli olduğunu ancak tahmini fiyatı bilmediğimizi anlarız. toll_info yoksa RouteLeg üzerinde geçiş ücreti yoktur.
speed_reading_intervals[]

SpeedReadingInterval

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

Örnek:

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

RouteMatrixDestination

ComputeRouteMatrixRequest için tek bir hedef

Alanlar
waypoint

Waypoint

Zorunlu. Hedef ara nokta

RouteMatrixElement

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

Alanlar
status

Status

Bu öğenin hata durumu kodu.
condition

RouteMatrixElementCondition

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

int32

Rotanın seyahat mesafesi (metre cinsinden).
duration

Duration

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

Duration

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

RouteTravelAdvisory

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

FallbackInfo

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

LocalizedValues

RouteMatrixElement özelliklerinin metin gösterimleri.
origin_index

int32

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

int32

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

LocalizedValues

Belirli özelliklerin metin gösterimleri.

Alanlar
distance

LocalizedText

Metin biçiminde gösterilen seyahat mesafesi.
duration

LocalizedText

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

LocalizedText

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

LocalizedText

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

RouteMatrixElementCondition

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

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

RouteMatrixOrigin

ComputeRouteMatrixRequest için tek bir kaynak

Alanlar
waypoint

Waypoint

Zorunlu. Başlangıç ara noktası
route_modifiers

RouteModifiers

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

RouteModifiers

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

Alanlar
avoid_tolls

bool

Doğru olarak ayarlandığında, ücretli yolların olmadığı rotalara öncelik vererek mümkün olduğunda ücretli yollardan kaçınılır. Yalnızca DRIVE ve TWO_WHEELER RouteTravelMode için geçerlidir.
avoid_highways

bool

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

bool

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

bool

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

VehicleInfo

Araç bilgilerini belirtir.
toll_passes[]

TollPass

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

RouteTravelAdvisory

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

Alanlar
toll_info

TollInfo

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

SpeedReadingInterval

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

Örnek:

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

int64

Mikrolitre cinsinden tahmini yakıt tüketimi. Bu alan yalnızca isteğin ComputeRoutesRequest.extra_computations bölümüne FUEL_CONSUMPTION dahil edildiğinde doldurulur.
route_restrictions_partially_ignored

bool

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

Money

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

RouteTravelMode

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

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

RoutingPreference

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

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

SpeedReadingInterval

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

Alanlar
start_polyline_point_index

int32

Bu aralığın çoklu çizgi üzerindeki başlangıç dizini.
end_polyline_point_index

int32

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

Speed

Bu aralıktaki trafik hızı.

Hız

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

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

TollInfo

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

Alanlar
estimated_price[]

Money

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

TollPass

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

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

TrafficModel

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

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

TransitAgency

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

Alanlar
name

string

Bu transit operatörünün adı.
phone_number

string

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

string

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

TransitLine

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

Alanlar
agencies[]

TransitAgency

Bu toplu taşıma hattını işleten transit operatörü (veya operatörleri).
name

string

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

string

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

string

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

string

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

string

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

string

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

TransitVehicle

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

TransitPreferences

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

Alanlar
allowed_travel_modes[]

TransitTravelMode

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

TransitRoutingPreference

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

TransitRoutingPreference

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

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

TransitTravelMode

Toplu taşıma modunu belirtmek için kullanılan bir değerler kümesi.

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

TransitStop

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

Alanlar
name

string

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

Location

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

TransitVehicle

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

Alanlar
name

LocalizedText

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

TransitVehicleType

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

string

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

string

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

TransitVehicleType

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

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

Birimler

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

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

VehicleEmissionType

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

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

VehicleInfo

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

Alanlar
emission_type

VehicleEmissionType

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

Ara nokta

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

Alanlar
via

bool

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

bool

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

bool

Bu yol noktasının konumunun, aracın yolun belirli bir tarafında durmasını tercih etmek için kullanıldığını gösterir. Bu değeri ayarladığınızda rota, konumun bulunduğu tarafta durabilmesi için konumdan geçer. Bu seçenek yalnızca DRIVE ve TWO_WHEELER RouteTravelMode için geçerlidir.
location_type birleşik alanı. Bir konumu temsil etmenin farklı yolları. location_type aşağıdakilerden 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 nokta ile ilişkili ÖY yer kimliği.
address

string

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

string

Geocoding API'nin SearchDestinations yönteminden alınan, NavigationPoint öğesini tanımlayan bir jeton.