Method: computeRoutes

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

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

Örneğin, bu yöntemde:

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

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

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

HTTP isteği

POST https://routes.googleapis.com/directions/v2:computeRoutes

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "intermediates": [
    {
      object (Waypoint)
    }
  ],
  "travelMode": enum (RouteTravelMode),
  "routingPreference": enum (RoutingPreference),
  "polylineQuality": enum (PolylineQuality),
  "polylineEncoding": enum (PolylineEncoding),
  "departureTime": string,
  "arrivalTime": string,
  "computeAlternativeRoutes": boolean,
  "routeModifiers": {
    object (RouteModifiers)
  },
  "languageCode": string,
  "regionCode": string,
  "units": enum (Units),
  "optimizeWaypointOrder": boolean,
  "requestedReferenceRoutes": [
    enum (ReferenceRoute)
  ],
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "trafficModel": enum (TrafficModel),
  "transitPreferences": {
    object (TransitPreferences)
  }
}
Alanlar
origin

object (Waypoint)

Zorunlu. Başlangıç ara noktası.

destination

object (Waypoint)

Zorunlu. Hedef ara nokta.

intermediates[]

object (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.

travelMode

enum (RouteTravelMode)

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

routingPreference

enum (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 travelMode DRIVE veya TWO_WHEELER olduğunda belirtebilirsiniz. Aksi takdirde istek başarısız olur.

polylineQuality

enum (PolylineQuality)

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

polylineEncoding

enum (PolylineEncoding)

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

departureTime

string (Timestamp format)

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

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

arrivalTime

string (Timestamp format)

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

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

computeAlternativeRoutes

boolean

İ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.

routeModifiers

object (RouteModifiers)

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

languageCode

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.

regionCode

string

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

units

enum (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.

optimizeWaypointOrder

boolean

İ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. optimizeWaypointOrder yanlış olarak ayarlanırsa ComputeRoutesResponse.optimized_intermediate_waypoint_index boş olur.

requestedReferenceRoutes[]

enum (ReferenceRoute)

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

extraComputations[]

enum (ExtraComputation)

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

trafficModel

enum (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.

transitPreferences

object (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 transitPreferences belirtebilirsiniz.

Yanıt gövdesi

v2.computeRoutes yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "routes": [
    {
      object (Route)
    }
  ],
  "fallbackInfo": {
    object (FallbackInfo)
  },
  "geocodingResults": {
    object (GeocodingResults)
  }
}
Alanlar
routes[]

object (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.

fallbackInfo

object (FallbackInfo)

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

geocodingResults

object (GeocodingResults)

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

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.

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.

ReferenceRoute

ComputeRoutesRequest üzerinde desteklenen bir referans rota.

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

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

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

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

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

ExtraComputation

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

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

Rota

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

JSON gösterimi
{
  "routeLabels": [
    enum (RouteLabel)
  ],
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ],
  "localizedValues": {
    object (RouteLocalizedValues)
  },
  "routeToken": string,
  "polylineDetails": {
    object (PolylineDetails)
  }
}
Alanlar
routeLabels[]

enum (RouteLabel)

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

legs[]

object (RouteLeg)

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

distanceMeters

integer

Rotanın metre cinsinden seyahat mesafesi.

duration

string (Duration format)

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

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

staticDuration

string (Duration format)

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

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

polyline

object (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

object (Viewport)

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

travelAdvisory

object (RouteTravelAdvisory)

Rota hakkında ek bilgiler.

optimizedIntermediateWaypointIndex[]

integer

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

localizedValues

object (RouteLocalizedValues)

Route özelliklerinin metin gösterimleri.

routeToken

string

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

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

polylineDetails

object (PolylineDetails)

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

RouteLabel

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

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

RouteLeg

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

JSON gösterimi
{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegLocalizedValues)
  },
  "stepsOverview": {
    object (StepsOverview)
  }
}
Alanlar
distanceMeters

integer

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

duration

string (Duration format)

Ayağın tamamlanması için gereken süre. route_preference, TRAFFIC_UNAWARE olarak ayarlanmışsa bu değer staticDuration 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.

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

staticDuration

string (Duration format)

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

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

polyline

object (Polyline)

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

startLocation

object (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.

endLocation

object (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[]

object (RouteLegStep)

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

travelAdvisory

object (RouteLegTravelAdvisory)

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

localizedValues

object (RouteLegLocalizedValues)

RouteLeg özelliklerinin metin gösterimleri.

stepsOverview

object (StepsOverview)

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

Çoklu çizgi

Kodlanmış bir çoklu çizgiyi kapsar.

JSON gösterimi
{

  // Union field polyline_type can be only one of the following:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of list of possible types for union field polyline_type.
}
Alanlar
Birleştirme alanı polyline_type. Çoklu çizgi türünü kapsar. Varsayılan olarak encoded_polyline değerine ayarlanır. polyline_type yalnızca aşağıdakilerden biri olabilir:
encodedPolyline

string

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

geoJsonLinestring

object (Struct format)

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

RouteLegStep

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

JSON gösterimi
{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegStepLocalizedValues)
  },
  "transitDetails": {
    object (RouteLegStepTransitDetails)
  },
  "travelMode": enum (RouteTravelMode)
}
Alanlar
distanceMeters

integer

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

staticDuration

string (Duration format)

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

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

polyline

object (Polyline)

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

startLocation

object (Location)

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

endLocation

object (Location)

Bu adımın bitiş konumu.

navigationInstruction

object (NavigationInstruction)

Navigasyon talimatları.

travelAdvisory

object (RouteLegStepTravelAdvisory)

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

localizedValues

object (RouteLegStepLocalizedValues)

RouteLegStep özelliklerinin metin gösterimleri.

transitDetails

object (RouteLegStepTransitDetails)

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

travelMode

enum (RouteTravelMode)

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

Maneuver

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

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

RouteLegStepTravelAdvisory

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

JSON gösterimi
{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
Alanlar
speedReadingIntervals[]

object (SpeedReadingInterval)

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

RouteLegStepLocalizedValues

Belirli özelliklerin metin gösterimleri.

JSON gösterimi
{
  "distance": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
Alanlar
distance

object (LocalizedText)

Metin biçiminde gösterilen seyahat mesafesi.

staticDuration

object (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.

JSON gösterimi
{
  "stopDetails": {
    object (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}
Alanlar
stopDetails

object (TransitStopDetails)

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

localizedValues

object (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

string (Duration format)

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

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

transitLine

object (TransitLine)

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

stopCount

integer

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

stopCount

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

tripShortText

string

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

TransitStopDetails

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

JSON gösterimi
{
  "arrivalStop": {
    object (TransitStop)
  },
  "arrivalTime": string,
  "departureStop": {
    object (