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

NOT: Bu yöntem, girişte bir yanıt alanı maskesi belirtmenizi gerektirir. Yanıt alanı maskesini $fields veya fields URL parametresini ya da X-Goog-FieldMask HTTP/gRPC ü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 yolları listesidir. Alan yollarının nasıl oluşturulacağı hakkında ayrıntılı dokümanları inceleyin.

Örneğin, bu yöntemde:

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

Aksi takdirde tüm mesajlar OK olarak görüneceğinden, alan maskenize status eklemeniz önemlidir. Google, aşağıdaki nedenlerle joker karakter (*) yanıt alanı maskesinin kullanılmasını önermez:

  • Yalnızca ihtiyacınız olan alanları seçmek, sunucumuzun hesaplama döngülerini azaltmasına yardımcı olur. Bu da sonucu size daha düşük gecikmeli olarak döndürmemize olanak tanır.
  • Üretim işinizde yalnızca ihtiyacınız olan alanları seçmek, kararlı bir gecikme performansı sağlar. Gelecekte daha fazla yanıt alanı ekleyebiliriz ve bu yeni alanlar için ek hesaplama süresi gerekebilir. Tüm alanları veya üst düzeydeki tüm alanları seçerseniz ekleyeceğimiz yeni alanlar yanıta otomatik olarak dahil edileceğinden performansta düşüş yaşayabilirsiniz.
  • Yalnızca ihtiyacınız olan alanları seçmek, yanıt boyutunun küçülmesine ve dolayısıyla ağ aktarım hızının artmasına neden olur.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

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

NOT: Bu yöntem, girişte bir yanıt alanı maskesi belirtmenizi gerektirir. Yanıt alanı maskesini $fields veya fields URL parametresini ya da X-Goog-FieldMask HTTP/gRPC ü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 yolları listesidir. Alan yollarının nasıl oluşturulacağı hakkında ayrıntılı dokümanları inceleyin.

Örneğin, bu yöntemde:

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

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

  • Yalnızca ihtiyacınız olan alanları seçmek, sunucumuzun hesaplama döngülerinde tasarruf etmesine yardımcı olur. Bu da sonucu size daha düşük gecikmeli olarak döndürmemize olanak tanır.
  • Üretim işinizde yalnızca ihtiyacınız olan alanları seçmek, kararlı bir gecikme performansı sağlar. Gelecekte daha fazla yanıt alanı ekleyebiliriz ve bu yeni alanlar için ek hesaplama süresi gerekebilir. Tüm alanları veya üst düzeydeki tüm alanları seçerseniz ekleyeceğimiz yeni alanlar yanıta otomatik olarak dahil edileceğinden performansta düşüş yaşayabilirsiniz.
  • Yalnızca ihtiyacınız olan alanları seçmek, yanıt boyutunun küçülmesine ve dolayısıyla ağ aktarım hızının artmasına neden olur.

ComputeRouteMatrixRequest

ComputeRouteMatrix istek mesajı

Alanlar
origins[]

RouteMatrixOrigin

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

  • place_id veya address olarak belirtilen başlangıç sayısı ile varış sayısı 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 başlangıç sayısı × hedef sayısı çarpımı 100'den büyük olmamalıdır.
destinations[]

RouteMatrixDestination

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

travel_mode

RouteTravelMode

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

routing_preference

RoutingPreference

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

departure_time

Timestamp

İsteğe bağlı. Kalkış saati. Bu değeri ayarlamazsanız varsayılan olarak isteği gönderdiğiniz 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 ayarlanabilir. departure_time ve arrival_time ikilisinden birini belirtin; ikisini birden belirtmeyin.

language_code

string

İsteğe bağlı. BCP-47 dil kodu ("en-US" veya "sr-Latn" gibi). Daha fazla bilgi için Unicode Yerel Ayarı Tanımlayıcısı başlıklı makaleyi inceleyin. Desteklenen dillerin listesi için Dil desteği bölümüne bakın. Bu değeri sağlamazsanız görüntüleme dili, ilk kaynağın konumundan anlaşılır.

region_code

string

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

units

Units

İsteğe bağlı. Gösterge 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 ek alanlar döndürebilir. Bu ek alanlar, yanıtta döndürülecek şekilde alan maskesinde de belirtilmelidir.

traffic_model

TrafficModel

İsteğe bağlı. Trafikte geçirilen süreyi hesaplarken kullanılacak varsayımları belirtir. Bu ayar, geçmiş ortalamalara göre trafikte tahmini süreyi içeren RouteMatrixElement öğesindeki süre alanında döndürülen değeri etkiler. RoutingPreference - TRAFFIC_AWARE_OPTIMAL ve RouteTravelMode - DRIVE. Trafik istenirse 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 transit_preferences belirtebilirsiniz.

ExtraComputation

İsteği tamamlarken yapılacak ek hesaplamalar.

Sıralamalar
EXTRA_COMPUTATION_UNSPECIFIED Kullanılmadı. 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ıç ara noktası.

destination

Waypoint

Zorunlu. Hedef yol noktası.

intermediates[]

Waypoint

İsteğe bağlı. Rota üzerinde (terminal noktaları hariç) durmak veya geçmek için bir dizi yol noktası. 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 hatayla veya aşırı uzun bir 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ı. Poli çizginin kalitesiyle ilgili tercihinizi belirtir.

polyline_encoding

PolylineEncoding

İsteğe bağlı. Poli ç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 gezileri, geçmişte 7 güne kadar veya gelecekte 100 güne kadar kullanılabilir.

arrival_time

Timestamp

İsteğe bağlı. Varış saati. NOT: Yalnızca RouteTravelMode TRANSIT olarak ayarlandığında ayarlanabilir. departure_time ve arrival_time ikilisinden birini belirtin; ikisini birden belirtmeyin. Toplu taşıma gezileri, geçmişte 7 güne kadar veya gelecekte 100 güne kadar kullanılabilir.

compute_alternative_routes

bool

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

route_modifiers

RouteModifiers

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

language_code

string

İsteğe bağlı. BCP-47 dil kodu ("en-US" veya "sr-Latn" gibi). Daha fazla bilgi için Unicode Yerel Ayarı Tanımlayıcısı başlıklı makaleyi inceleyin. Desteklenen dillerin listesi için Dil desteği bölümüne bakın. Bu değeri sağlamadığınızda ekran dili, rota isteğinin konumundan anlaşılır.

region_code

string

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

units

Units

İsteğe bağlı. Gösterge alanları için ölçü birimlerini belirtir. Bu alanlar, NavigationInstruction içindeki instruction alanını içerir. Rota, etap, 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 türetilir.

optimize_waypoint_order

bool

İsteğe bağlı. Doğru olarak ayarlanırsa hizmet, belirtilen ara yol işaretlerini yeniden düzenleyerek rotanın toplam maliyetini en aza indirmeye çalışır. Ara yol işaretçilerinden herhangi biri via yol işaretçisi ise istek başarısız olur. Yeni sıralamayı bulmak için ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index simgesini kullanın. X-Goog-FieldMask üstbilgisinde ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index istenmezse istek başarısız olur. optimize_waypoint_order yanlış olarak ayarlanırsa ComputeRoutesResponse.optimized_intermediate_waypoint_index boş olur.

requested_reference_routes[]

ReferenceRoute

İsteğe bağlı. Varsayılan rotaya ek olarak istek kapsamında hangi referans rotaların hesaplanacağını belirtir. Referans rota, varsayılan rotadan farklı bir rota hesaplama hedefine sahip bir rotadır. Örneğin, FUEL_EFFICIENT referans rota hesaplaması, en uygun yakıt tasarruflu rotayı oluşturacak çeşitli parametreleri hesaba katar. Bu özelliği kullanırken, bulunan rotalarda route_labels simgesini arayın.

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ülecek şekilde alan maskesinde de belirtilmelidir.

traffic_model

TrafficModel

İsteğe bağlı. Trafikte geçirilen süreyi hesaplarken kullanılacak varsayımları belirtir. Bu ayar, geçmiş ortalamalara göre trafikte tahmini süreyi içeren Route ve RouteLeg öğelerindeki duration alanında döndürülen değeri etkiler. TrafficModel yalnızca RoutingPreference'u TRAFFIC_AWARE_OPTIMAL ve RouteTravelModeDRIVE olarak ayarlayan istekler için kullanılabilir. Trafik istenirse 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 transit_preferences belirtebilirsiniz.

ExtraComputation

İsteği tamamlarken yapılacak ek hesaplamalar.

Sıralamalar
EXTRA_COMPUTATION_UNSPECIFIED Kullanılmadı. 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 trafik bilinçli çoklu çizgiler.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions biçimlendirilmiş HTML metin dizesi olarak sunulur. Bu içerik olduğu gibi okunmak üzere tasarlanmıştır. Bu içerik yalnızca görüntüleme amaçlıdır. Programlı olarak ayrıştırmayın.
FLYOVER_INFO_ON_POLYLINE Rotalar için havadan görüntüleme bilgileri. Bu bilgilerin döndürülmesi için routes.polyline_details.flyover_info alan maskesi belirtilmelidir. Bu veriler şu anda yalnızca Hindistan'daki belirli metrolar için doldurulur. Bu özellik deneme aşamasındadır ve SKU/ücret değişebilir.
NARROW_ROAD_INFO_ON_POLYLINE Rotalar için dar yol bilgileri. Bu bilgilerin döndürülmesi için routes.polyline_details.narrow_road_info alan maskesi belirtilmelidir. Bu veriler şu anda yalnızca Hindistan'daki belirli metrolar için doldurulur. Bu özellik deneme aşamasındadır ve SKU/ücret değişebilir.

ReferenceRoute

ComputeRoutesRequest üzerinde desteklenen bir referans rotası.

Sıralamalar
REFERENCE_ROUTE_UNSPECIFIED Kullanılmadı. 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.

DRIVE istekleri için bu özellik, sürüş konforuna göre daha kısa mesafeye öncelik verir. Örneğin, otoyollar yerine yerel yolları tercih edebilir, toprak yollardan geçebilir, otoparklardan kestirebilir. Bu özellik, Google Haritalar'ın yasa dışı olduğunu bildiği hiçbir manevrayı döndürmez.

BICYCLE ve TWO_WHEELER istekleri için bu özellik, requested_reference_routes belirtmediğiniz durumlarda döndürülen rotalara benzer rotalar döndürür.

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

ComputeRoutesResponse

Yanıt mesajını hesaplar.

Alanlar
routes[]

Route

compute_alternatives_routes değerini belirttiğinizde hesaplanan rotalar dizisi (en fazla üç) içerir. Aksi takdirde yalnızca bir rota içerir. Bu dizi birden fazla giriş içeriyorsa ilk giriş en çok önerilen rotadır. Dizi boşsa rota bulunamadı demektir.

fallback_info

FallbackInfo

Sunucu, rota sonuçlarını tüm giriş tercihleriyle hesaplayamadığında farklı bir hesaplama yöntemi kullanabilir. Yedek modu kullanıldığında bu alan, yedek yanıtla ilgili ayrıntılı bilgi içerir. Aksi takdirde bu alanın değeri belirlenmez.

geocoding_results

GeocodingResults

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

FallbackInfo

Yedek sonucun nasıl ve neden kullanıldığıyla ilgili bilgiler. Bu alan ayarlanmışsa sunucu, yedek olarak tercih ettiğiniz moddan farklı bir yönlendirme modu kullanmıştır.

Alanlar
routing_mode

FallbackRoutingMode

Yanıt için kullanılan yönlendirme modu. Yedekleme 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ın kullanılmasının 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 yönlendirme moduyla hesaplamayı zamanında tamamlayamadık ancak alternatif bir modla hesaplanan bir sonuç döndürebildik.

FallbackRoutingMode

İade edilen yedek yanıt için kullanılan gerçek yönlendirme modu.

Sıralamalar
FALLBACK_ROUTING_MODE_UNSPECIFIED Kullanılmadı.
FALLBACK_TRAFFIC_UNAWARE Yanıtı hesaplamak için TRAFFIC_UNAWARE RoutingPreference'un kullanıldığını belirtir.
FALLBACK_TRAFFIC_AWARE Yanıtı hesaplamak için TRAFFIC_AWARE RoutingPreference'un kullanıldığını belirtir.

GeocodedWaypoint

Dönüm noktası olarak kullanılan konumlarla ilgili ayrıntılar. Yalnızca adres yol noktaları için doldurulur. Adresin coğrafi kodlamanın hangi konuma göre yapıldığı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 belirtir.

type[]

string

Sonuç 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ı, istenen adresin bir kısmını eşleştirebilmesine rağmen orijinal istek için tam eşleşme döndürmedi. Orijinal isteği yazım hataları ve/veya eksik adres olup olmadığını kontrol etmek isteyebilirsiniz.

place_id

string

Bu sonucun yer kimliği.

intermediate_waypoint_request_index

int32

İstekteki ilgili ara yol noktasının dizini. Yalnızca ilgili yol noktası ara yol noktasıysa doldurulur.

GeocodingResults

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

Alanlar
origin

GeocodedWaypoint

Coğrafi kodlanmış başlangıç noktası.

destination

GeocodedWaypoint

Coğrafi kodlanmış hedef yol noktası.

intermediates[]

GeocodedWaypoint

Her biri, istekte belirtildikleri sırada yol işaretinin sıfır tabanlı konumuna karşılık gelen bir dizin alanı içeren, coğrafi olarak kodlanmış ara yol işaretlerinin listesi.

LocalizedTime

Saatin 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ı bir başlık) kapsar.

Alanlar
lat_lng

LatLng

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

heading

Int32Value

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

Manevra

Mevcut adım için yapılacak gezinme işlemini (ör. sola dön, birleş veya düz git) belirten bir değer kümesi.

Sıralamalar
MANEUVER_UNSPECIFIED Kullanılmadı.
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 Sol rampadan gidin.
RAMP_RIGHT Sağ rampaya girin.
MERGE Trafik akışı ile birleşin.
FORK_LEFT Sol çataldan gidin.
FORK_RIGHT Sağ çataldan gidin.
FERRY Feribota binin.
FERRY_TRAIN Feribota giden trene binin.
ROUNDABOUT_LEFT Dönel kavşakta sola dönün.
ROUNDABOUT_RIGHT Dönel kavşakta sağa dönün.
DEPART İlk manevra.
NAME_CHANGE Cadde adı değişikliğini belirtmek için kullanılır.

Bir RouteLegStep için gezinme talimatlarını kapsar.

Alanlar
maneuver

Maneuver

Geçerli adıma ilişkin gezinme talimatlarını (ör. sola dön, birleş veya düz git) kapsar. Bu alan, hangi simgesinin gösterileceğini belirler.

instructions

string

Bu adımda gezinme talimatları.

Çoklu çizgi

Kodlanmış bir çoklu çizgiyi kapsüller.

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

string

Poli çizgisi kodlama algoritması kullanılarak poli çizgisinin dize kodlaması

geo_json_linestring

Struct

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

PolylineDetails

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

Alanlar
flyover_info[]

FlyoverInfo

Poli çizgisi boyunca uçuş ayrıntıları.

narrow_road_info[]

NarrowRoadInfo

Poli çizgisi boyunca dar yol ayrıntıları.

FlyoverInfo

Poli çizgisi boyunca yapılan uçuş görüntüleriyle ilgili bilgileri kapsar.

Alanlar
flyover_presence

RoadFeatureState

Yalnızca çıkış. Poli çizginin belirli bir bölümü için havadan çekim olup olmadığını belirtir.

polyline_point_index

PolylinePointIndex

Çoklu çizgi üzerindeki uçuşla ilgili bilgilerin konumu.

NarrowRoadInfo

Poli çizgisi boyunca dar yollar hakkındaki bilgileri kapsar.

Alanlar
narrow_road_presence

RoadFeatureState

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

polyline_point_index

PolylinePointIndex

Çoklu çizgi üzerindeki dar yollarla ilgili bilgilerin konumu.

PolylinePointIndex

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

Alanlar
start_index

int32

Poli çizgisindeki bu ayrıntının başlangıç dizini.

end_index

int32

Bu ayrıntının poli çizgisindeki bitiş dizini.

RoadFeatureState

Bir çoklu çizgi 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 mevcuttur.
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 Poli çizgi türü tercihi belirtilmedi. Varsayılan olarak ENCODED_POLYLINE değerine ayarlanır.
ENCODED_POLYLINE Poli çizgisi kodlama algoritması kullanılarak kodlanmış bir poli çizgiyi belirtir.
GEO_JSON_LINESTRING GeoJSON LineString biçimini kullanarak bir çok çizgi belirtir.

PolylineQuality

Poli çizginin kalitesini belirten bir değer kümesi.

Sıralamalar
POLYLINE_QUALITY_UNSPECIFIED Poli çizgi kalitesi tercihi belirtilmedi. Varsayılan olarak OVERVIEW değerine ayarlanır.
HIGH_QUALITY Yanıt boyutunun artması pahasına OVERVIEW'ten daha fazla nokta kullanılarak oluşturulan yüksek kaliteli bir çok ç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ış poli çizgisini belirtir. Rotaya genel bakış gösterilirken bu değeri kullanın. Bu seçenek, HIGH_QUALITY seçeneğine kıyasla daha düşük istek gecikmesi sunar.

Rota

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

Alanlar
route_labels[]

RouteLabel

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

legs[]

RouteLeg

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

distance_meters

int32

Rotayı katedilen mesafe (metre cinsinden).

duration

Duration

Rotada gezinmek için gereken süre. routing_preference öğesini TRAFFIC_UNAWARE olarak ayarlarsanız bu değer static_duration ile aynıdır. 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 rotadaki seyahat süresi.

polyline

Polyline

Genel rota çoklu çizgisi. Bu çoklu çizgi, tüm legs'lerin birleştirilmiş çoklu çizgisidir.

description

string

Rotayı açıklayan bir metin.

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 doğru olarak ayarlarsanız bu alan, ara yol işaretlerinin optimize edilmiş sırasını içerir. Aksi takdirde bu alan boş bırakılır. Örneğin, Başlangıç: İstanbul; Ara yol işaretleri: Ankara, İzmir, Antalya; Varış noktası: Ankara şeklinde bir giriş yaparsanız ve optimize edilmiş ara yol işareti sırası Ankara, İzmir, Antalya 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 temsilleri.

route_token

string

Navigasyon sırasında rotayı yeniden oluşturmak ve yeniden yönlendirme durumunda rotanın oluşturulduğu orijinal amacı dikkate almak için Navigation SDK'ya iletilebilecek 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 parametresi TRAFFIC_AWARE veya TRAFFIC_AWARE_OPTIMAL olarak ayarlanmış isteklerde kullanılabilir. Route.route_token, Via yol işaretleri içeren istekler için desteklenmez.

polyline_details

PolylineDetails

Poli çizgisi boyunca ayrıntılar hakkında bilgi içerir.

RouteLocalizedValues

Belirli tesislerin metin temsilleri.

Alanlar
distance

LocalizedText

Metin biçiminde gösterilen seyahat mesafesi.

duration

LocalizedText

Metin biçiminde gösterilen ve sorgunun bulunduğu bölgeye göre yerelleştirilen süre. Trafik koşullarını dikkate alır. Not: Trafik bilgileri isteğinde bulunmadıysanız bu değer static_duration ile aynıdır.

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

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

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

RouteLeg

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

Alanlar
distance_meters

int32

Rota adımını oluşturan seyahat mesafesi (metre cinsinden).

duration

Duration

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

polyline

Polyline

Her step'nin çoklu çizgisini içeren bu bacak için genel çoklu çizgi.

start_location

Location

Bu etabın başlangıç konumu. Bu konum, sağlanan origin adresinden farklı olabilir. Örneğin, sağlanan origin bir yolun yakınında değilse bu, yoldaki bir noktadır.

end_location

Location

Bu etabın bitiş konumu. Bu konum, sağlanan destination adresinden farklı olabilir. Örneğin, sağlanan destination bir yolun yakınında değilse bu, yoldaki bir noktadır.

steps[]

RouteLegStep

Bu ayaktaki segmentleri belirten bir adım dizisi. Her adım bir gezinme talimatını temsil eder.

travel_advisory

RouteLegTravelAdvisory

Bir rota adımında olası trafik bölgesi kısıtlamaları gibi kullanıcının bilgilendirilmesi gereken ek bilgileri içerir.

localized_values

RouteLegLocalizedValues

RouteLeg özelliklerinin metin temsilleri.

steps_overview

StepsOverview

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

RouteLegLocalizedValues

Belirli tesislerin metin temsilleri.

Alanlar
distance

LocalizedText

Metin biçiminde gösterilen seyahat mesafesi.

duration

LocalizedText

Metin biçiminde gösterilen ve sorgunun bulunduğu bölgeye göre yerelleştirilen süre. Trafik koşullarını dikkate alır. Not: Trafik bilgileri isteğinde bulunmadıysanız bu değer static_duration ile aynıdır.

static_duration

LocalizedText

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

StepsOverview

RouteLegStep listesi hakkında genel bilgiler sağlar.

Alanlar
multi_modal_segments[]

MultiModalSegment

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

MultiModalSegment

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

Alanlar
navigation_instruction

NavigationInstruction

Çok modlu segment için NavigationInstruction.

travel_mode

RouteTravelMode

Çok modlu segmentin ulaşım şekli.

step_start_index

int32

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

step_end_index

int32

Çok modlu bir segmentin sonu olan ilgili RouteLegStep dizini.

RouteLegStep

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

Alanlar
distance_meters

int32

Bu adımın kat edilen mesafesi (metre cinsinden). Bazı durumlarda bu alanın değeri olmayabilir.

static_duration

Duration

Trafik koşulları dikkate alınmadan bu adımda seyahat 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 yol adımında kullanıcıya bildirilmesi gereken ek bilgileri (ör. olası trafik bölgesi kısıtlamaları) içerir.

localized_values

RouteLegStepLocalizedValues

RouteLegStep özelliklerinin metin temsilleri.

transit_details

RouteLegStepTransitDetails

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

travel_mode

RouteTravelMode

Bu adımda 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 hesaplanan ve metin biçiminde gösterilen süre.

RouteLegStepTransitDetails

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

Alanlar
stop_details

TransitStopDetails

Adımın varış ve kalkış duraklarıyla ilgili bilgiler.

localized_values

TransitDetailsLocalizedValues

RouteLegStepTransitDetails özelliklerinin metin temsilleri.

headsign

string

Araç üzerinde veya kalkış durağında belirtildiği şekilde, bu hatta seyahat edilecek yönü belirtir. Yön genellikle son duraktır.

headway

Duration

Bu saatte aynı duraktan yapılan kalkışlar arasındaki süre olarak beklenen zamanı belirtir. Örneğin, 600 saniyelik bir sefer aralığı değeriyle, otobüsünüz kaçırırsanız on dakika beklemeniz gerekir.

transit_line

TransitLine

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

stop_count

int32

Kalkış durağından varış duraklarına kadar olan durak sayısı. Bu sayıya varış durağı dahildir ancak kalkış durağı hariçtir. Ö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 değerini döndürür.

trip_short_text

string

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

TransitDetailsLocalizedValues

RouteTransitDetails değerlerinin yerelleştirilmiş açıklamaları.

Alanlar
arrival_time

LocalizedTime

Saat, ilgili saat dilimiyle birlikte biçimlendirilmiş metin temsilinde.

departure_time

LocalizedTime

Saat, ilgili saat dilimiyle birlikte biçimlendirilmiş metin temsilinde.

TransitStopDetails

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

Alanlar
arrival_stop

TransitStop

Adımın varış durağı hakkında bilgi.

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

Bir yol adımı üzerindeki 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 doldurulmamıştır.

RouteLegTravelAdvisory

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

Alanlar
toll_info

TollInfo

Belirli bir RouteLeg üzerindeki otoyol ücretleri hakkında bilgi içerir. Bu alan yalnızca RouteLeg üzerinde geçiş ücreti olduğunu tahmin ettiğimizde doldurulur. Bu alan ayarlanmışsa ancak estimated_price alt alanı doldurulmamışsa yolun ücretli olduğunu varsayıyoruz ancak tahmini fiyatı bilmiyoruz. Bu alan yoksa RouteLeg için ücret alınmaz.

speed_reading_intervals[]

SpeedReadingInterval

Trafik yoğunluğunu ayrıntılı olarak gösteren hız okuma aralıkları. TRAFFIC_AWARE ve TRAFFIC_AWARE_OPTIMAL yönlendirme tercihleri için geçerlidir. Aralıklar, RouteLeg çoklu çizgisinin tamamını çakışma olmadan 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 yol noktası

RouteMatrixElement

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

Alanlar
status

Status

Bu öğenin hata durumu kodu.

condition

RouteMatrixElementCondition

Rotanın bulunup bulunmadığını belirtir. Durumdan bağımsızdır.

distance_meters

int32

Rotayı katedilen mesafe (metre cinsinden).

duration

Duration

Rotada gezinmek için gereken süre. routing_preference öğesini TRAFFIC_UNAWARE olarak ayarlarsanız bu değer static_duration ile aynıdır. 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 rotadaki seyahat süresi.

travel_advisory

RouteTravelAdvisory

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

fallback_info

FallbackInfo

Sunucu, belirli bir kaynak/varış noktası çifti için verilen tercihlerle rotayı hesaplayamadığında farklı bir hesaplama modu kullanabilir. Yedek modu 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 temsilleri.

origin_index

int32

İstekte kaynağın sıfır tabanlı dizini.

destination_index

int32

İstekte 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ıdı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.

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ı. Bu konumu başlangıç noktası olarak kullanan her rota için değiştiriciler

RouteModifiers

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

Alanlar
avoid_tolls

bool

Doğru olarak ayarlandığında, makul olduğunda ücretli yollardan kaçınarak ücretli yol içermeyen rotalara öncelik verir. Yalnızca DRIVE ve TWO_WHEELER RouteTravelMode için geçerlidir.

avoid_highways

bool

Doğru olarak ayarlandığında, makul olduğunda otoyolları kullanmaz ve otoyol içermeyen rotalara öncelik verir. Yalnızca DRIVE ve TWO_WHEELER RouteTravelMode için geçerlidir.

avoid_ferries

bool

Doğru olarak ayarlandığında, uygun olduğunda feribotları atlar ve feribot içermeyen rotalara öncelik verir. Yalnızca DRIVE veTWO_WHEELER RouteTravelMode için geçerlidir.

avoid_indoor

bool

Doğru değerine ayarlandığında, makul olduğunda kapalı mekanda gezinmeyi önler ve kapalı mekanda gezinme içermeyen rotalara öncelik verir. Yalnızca WALK RouteTravelMode için geçerlidir.

vehicle_info

VehicleInfo

Araç bilgilerini belirtir.

toll_passes[]

TollPass

Otoyol geçiş kartlarıyla ilgili bilgileri kapsar. Geçiş kartları sağlanırsa API, kart fiyatını döndürmeye çalışır. Otoyol geçişleri sağlanmazsa API, otoyol geçişini bilinmiyor olarak değerlendirir ve nakit fiyatı döndürmeye çalışır. Yalnızca DRIVE ve TWO_WHEELER RouteTravelMode için geçerlidir.

RouteTravelAdvisory

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

Alanlar
toll_info

TollInfo

Rotadaki otoyol ücretleri hakkında bilgi içerir. Bu alan yalnızca rota üzerinde geçiş ücreti alınması bekleniyorsa doldurulur. Bu alan ayarlanmışsa ancak estimatedPrice alt alanı doldurulmamışsa rotada geçiş ücretleri vardır ancak tahmini fiyat bilinmemektedir. Bu alan ayarlanmazsa rota üzerinde geçiş ücreti beklenmez.

speed_reading_intervals[]

SpeedReadingInterval

Trafik yoğunluğunu ayrıntılı olarak gösteren hız okuma aralıkları. TRAFFIC_AWARE ve TRAFFIC_AWARE_OPTIMAL yönlendirme tercihleri için geçerlidir. Aralıklar, rotanın poli çizgisinin tamamını örtüşmeden 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

Tahmini yakıt tüketimi (mikrolitre cinsinden).

route_restrictions_partially_ignored

bool

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

transit_fare

Money

Varsa bu rotadaki toplam ücreti veya bilet maliyetlerini içerir. Bu özellik yalnızca TRANSIT istekleri için 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

Seyahat şeklini belirtmek için kullanılan bir değer 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ı eksik olabilir. Uygulamanızda gösterdiğiniz tüm yürüyüş, bisiklet ve iki tekerlekli araç rotaları için kullanıcıya bu uyarıyı göstermeniz gerekir.

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

RoutingPreference

Rota 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ı önemli olmadığında veya geçerli olmadığında 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 zamana bağlı olmayan ortalama trafik koşullarına göre belirlenir. Bu nedenle, rotalar geçici olarak kapalı olan yollar içerebilir. Belirli bir istek iç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, herhangi bir zamanda veya sıklıkta neredeyse eşdeğer rotalar arasında da değişiklik gösterebilir.
TRAFFIC_AWARE Rotaları, gerçek zamanlı trafik koşullarını dikkate alarak hesaplar. TRAFFIC_AWARE_OPTIMAL'e kıyasla, gecikmeyi önemli ölçüde azaltmak için bazı optimizasyonlar uygulanır.
TRAFFIC_AWARE_OPTIMAL Çoğu performans optimizasyonu uygulanmadan, canlı trafik koşullarını dikkate alarak rotaları hesaplar. Bu değerin kullanılması en yüksek gecikmeyi oluşturur.

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ını içeren bir yol verildiğinde SpeedReadingInterval bir aralık tanımlar ve trafiğini aşağıdaki kategorileri kullanarak açıklar.

Alanlar
start_polyline_point_index

int32

Poli çizgideki bu aralığın başlangıç dizini.

end_polyline_point_index

int32

Poli çizgideki bu aralığın bitiş dizini.

Birlik alanı speed_type.

speed_type yalnızca aşağıdakilerden biri olabilir:

speed

Speed

Bu aralıkta trafik hızı.

Hız

Poli ç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ılmamaktadır.
NORMAL Normal hız, yavaşlama algılanmadı.
SLOW Yavaşlama algılandı ancak trafik sıkışıklığı oluşmadı.
TRAFFIC_JAM Trafik sıkışıklığı algılandı.

TollInfo

Route veya RouteLeg'ta ücret bilgilerini kapsar.

Alanlar
estimated_price[]

Money

İlgili Route veya RouteLeg için geçiş ücretinin parasal tutarı. Bu liste, her para birimi için gişeler tarafından alınması beklenen para tutarını içerir. Bu liste genellikle tek bir para biriminde geçiş ücreti olan yollar için yalnızca bir öğe içerir. Uluslararası seyahatler için bu liste, farklı para birimlerindeki geçiş ücretlerini yansıtan birden fazla öğe içerebilir.

TollPass

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

Sıralamalar
TOLL_PASS_UNSPECIFIED Kullanılmadı. Bu değer kullanılırsa istek başarısız olur.
AU_ETOLL_TAG Sidney otoyol geçiş kartı. Daha fazla bilgi için https://www.myetoll.com.au adresini ziyaret edin.
AU_EWAY_TAG Sidney otoyol geçiş kartı. Daha fazla bilgi için https://www.tollpay.com.au adresini ziyaret edin.
AU_LINKT Avustralya genelinde geçerli otoyol geçiş kartı. Daha fazla bilgi için https://www.linkt.com.au/ adresini ziyaret edin.
AR_TELEPASE Arjantin otoyol geçiş kartı. Daha fazla bilgi için https://telepase.com.ar adresini ziyaret edin.
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ı. Ayrıntılı bilgi için https://movemais.com adresini ziyaret edin.
BR_PASSA_RAPIDO Brezilya otoyol geçiş kartı. Daha fazla bilgi için https://pasorapido.gob.do/ adresini ziyaret edin.
BR_SEM_PARAR Brezilya otoyol geçiş kartı. Daha fazla bilgi için https://www.semparar.com.br adresini ziyaret edin.
BR_TAGGY Brezilya otoyol geçiş kartı. Daha fazla bilgi için https://taggy.com.br adresini ziyaret edin.
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 geçiş noktası.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Kanada'dan ABD'ye geçiş noktası.
CA_US_BLUE_WATER_EDGE_PASS Kanada'nın Ontario eyaletinde ABD'nin Michigan eyaletine giden sınır kapısı.
CA_US_CONNEXION Kanada'nın Ontario eyaletinde ABD'nin Michigan eyaletine giden sınır kapısı.
CA_US_NEXUS_CARD Kanada'dan ABD'ye geçiş noktası.
ID_E_TOLL Endonezya. Birden fazla banka tarafından sunulan ve otoyol ücretlerini ödemek için kullanılan e-kart. Bankalar aracılığıyla yapılan tüm e-kart ödemeleri aynı olduğundan yalnızca bir enum değeri gerekir. Ör. Bank Mandiri https://www.bankmandiri.co.id/e-money - BCA https://www.bca.co.id/flazz - BNI https://www.bni.co.id/id-id/ebanking/tapcash
IN_FASTAG Hindistan.
IN_LOCAL_HP_PLATE_EXEMPT Hindistan, HP eyalet plakası muafiyeti.
JP_ETC Japonya ETC. Otoyol ücretlerini tahsil etmek için kullanılan elektronik kablosuz sistem. https://www.go-etc.jp/
JP_ETC2 Japonya ETC2.0. Araçlardaki cihazlar ile yoldaki antenler arasında daha fazla indirim ve iki yönlü iletişim sunan ETC'nin yeni sürümü. https://www.go-etc.jp/etc2/index.html
MX_IAVE Meksika otoyol 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 otoyol geçiş kartı şirketi. Mexico City'de faaliyet gösteren birçok restorandan biri. Daha fazla bilgi için https://www.televia.com.mx adresini ziyaret edin.
MX_TELEVIA Meksika otoyol geçiş kartı şirketi. Mexico City'de faaliyet gösteren birçok kanaldan biri. https://www.televia.com.mx
MX_VIAPASS Meksika otoyol geçiş kartı. Ayrıntılı bilgi için https://www.viapass.com.mx/viapass/web_home.aspx adresini ziyaret edin.
US_AL_FREEDOM_PASS AL, ABD.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS AK, ABD.
US_CA_FASTRAK 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ına sahip olduğunu gösterir. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO, ABD.
US_CO_GO_PASS CO, ABD.
US_DE_EZPASSDE 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 Los Angeles, ABD.
US_LA_TOLL_TAG Los Angeles, ABD.
US_MA_EZPASSMA MA, ABD.
US_MD_EZPASSMD MD, ABD.
US_ME_EZPASSME ME, ABD.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, ABD.
US_MI_BCPASS MI, ABD.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, ABD.
US_MI_IQ_PROX_CARD

MI, ABD. Bu geçiş türü artık mevcut olmadığı için 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

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

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

TransitAgency

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

Alanlar
name

string

Bu toplu taşıma işletmesinin adı.

phone_number

string

Toplu taşıma acentesinin yerel ayara özel biçimlendirilmiş telefon numarası.

uri

string

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

TransitLine

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

Alanlar
agencies[]

TransitAgency

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

name

string

Bu toplu taşıma hattının tam adı. Ö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. On altı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 bir satır numarası olur (ör. "M7" veya "355").

text_color

string

Bu satırın tabelalarındaki metinde yaygın olarak kullanılan renk. On altılık 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ırken kullanılacak bir dizi ulaşım şekli. Varsayılan olarak tüm desteklenen seyahat modları 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 rotanın sınırlı miktarda yürüyüş tercih etmesi gerektiğini belirtir.
FEWER_TRANSFERS Hesaplanan rotanın sınırlı sayıda aktarma tercih etmesi gerektiğini gösterir.

TransitTravelMode

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

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

TransitStop

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

Alanlar
name

string

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

location

Location

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

TransitVehicle

Toplu taşıma rotalarında kullanılan bir araçla ilgili 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 tabelalarına göre bu araç türüyle ilişkili simgenin URI'si.

TransitVehicleType

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

Sıralamalar
TRANSIT_VEHICLE_TYPE_UNSPECIFIED Kullanılmamış.
BUS Otobüs.
CABLE_CAR Genellikle yerde kabloyla çalışan bir araç. Teleferikler GONDOLA_LIFT türü olabilir.
COMMUTER_TRAIN Banliyö treni.
FERRY Feribot.
FUNICULAR Dik yokuşları kabloyla yukarı çekilen araç. Teleferik genellikle iki arabadan oluşur ve her araba diğerine karşı ağırlık görevi 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 Uzun mesafeli tren.
METRO_RAIL Hafif raylı sistem.
MONORAIL Monoray.
OTHER Diğer tüm araçlar.
RAIL Demiryolu.
SHARE_TAXI Paylaşılan taksi, güzergahındaki herhangi bir yerde yolcu alıp bırakabilen 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ğer kümesi.

Sıralamalar
UNITS_UNSPECIFIED Ölçü birimleri belirtilmedi. Varsayılan olarak istekten çıkarılan ölçü birimidir.
METRIC Metrik ölçü birimleri.
IMPERIAL İngiliz (İngilizce) ö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 Yayın türü belirtilmedi. Varsayılan olarak GASOLINE değerine ayarlanır.
GASOLINE Benzinli araç.
ELECTRIC Elektrikle çalışan araç.
HYBRID Hibrit yakıtlı (ör. benzin + elektrik) araç.
DIESEL Dizel yakıtlı araç.

VehicleInfo

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

Alanlar
emission_type

VehicleEmissionType

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

Ara nokta

Bir ara noktayı kapsüller. Yol üstü işaretleri, bir rotanın hem başlangıcını hem de sonunu işaret eder ve rota üzerindeki ara durakları içerir.

Alanlar
via

bool

Bu yol noktasını durak noktası yerine ara hedef olarak işaretler. İstekte bulunan ve "via" özelliğine sahip olmayan her bir yol noktası için yanıt, seyahatin bu aşamasındaki duraklarla ilgili ayrıntıları sağlamak üzere legs dizisine bir giriş ekler. Rotanın bu yol noktasında durmadan geçmesini istediğinizde bu değeri doğru olarak ayarlayın. Ara noktalar, legs dizisine bir giriş eklenmesine neden olmaz ancak yolculuğu ara nokta üzerinden yönlendirir. Bu değeri yalnızca ara yol işaretlerinde ayarlayabilirsiniz. Bu alanı terminal yol noktalarında ayarlarsanız istek başarısız olur. ComputeRoutesRequest.optimize_waypoint_order doğru olarak ayarlanmışsa bu alan doğru olarak ayarlanamaz. Aksi takdirde istek başarısız olur.

vehicle_stopover

bool

Bu yol noktası, araçların durması için tasarlanmıştır ve teslim alma veya bırakma işleminin yapılmasını amaçlar. Bu değeri ayarlarsanız hesaplanan rota, teslim alma ve bırakma işlemi için uygun olmayan yollardaki via olmayan yol noktalarını içermez. Bu seçenek yalnızca DRIVE ve TWO_WHEELER seyahat modları için ve location_type Location olduğunda çalışır.

side_of_road

bool

Bu yol işaretinin konumunun, aracın yolun belirli bir tarafında durması için tercih edildiğini belirtir. Bu değeri ayarlarsanız rota, aracın yolun ortasından konuma doğru eğimli olan tarafında durabilmesi için konumdan geçer. Bu seçenek yalnızca DRIVE ve TWO_WHEELER RouteTravelMode için geçerlidir.

Birlik alanı location_type. Bir konumu temsil etmenin farklı yolları. location_type yalnızca aşağıdakilerden biri olabilir:
location

Location

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

place_id

string

Dönüm noktasıyla 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 adresine bakın.