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 (TransitStop)
  },
  "departureTime": string
}
Alanlar
arrivalStop

object (TransitStop)

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

string (Timestamp format)

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

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".
departureStop

object (TransitStop)

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

string (Timestamp format)

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

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

TransitStop

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

JSON gösterimi 
{
  "name": string,
  "location": {
    object (Location)
  }
}
Alanlar
name

string

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

object (Location)

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

TransitDetailsLocalizedValues

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

JSON gösterimi 
{
  "arrivalTime": {
    object (LocalizedTime)
  },
  "departureTime": {
    object (LocalizedTime)
  }
}
Alanlar
arrivalTime

object (LocalizedTime)

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

object (LocalizedTime)

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

LocalizedTime

Zamanın yerelleştirilmiş açıklaması.

JSON gösterimi 
{
  "time": {
    object (LocalizedText)
  },
  "timeZone": string
}
Alanlar
time

object (LocalizedText)

Belirli bir saat diliminde dize olarak belirtilen saat.
timeZone

string

Saat dilimini içerir. Değer, IANA Saat Dilimi Veritabanı'nda tanımlanan saat diliminin adıdır (ör. "America/New_York").

TransitLine

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

JSON gösterimi 
{
  "agencies": [
    {
      object (TransitAgency)
    }
  ],
  "name": string,
  "uri": string,
  "color": string,
  "iconUri": string,
  "nameShort": string,
  "textColor": string,
  "vehicle": {
    object (TransitVehicle)
  }
}
Alanlar
agencies[]

object (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ı (ör. "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.
iconUri

string

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

string

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

string

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

object (TransitVehicle)

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

TransitAgency

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

JSON gösterimi 
{
  "name": string,
  "phoneNumber": string,
  "uri": string
}
Alanlar
name

string

Bu toplu taşıma kuruluşunun adı.
phoneNumber

string

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

string

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

TransitVehicle

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

JSON gösterimi 
{
  "name": {
    object (LocalizedText)
  },
  "type": enum (TransitVehicleType),
  "iconUri": string,
  "localIconUri": string
}
Alanlar
name

object (LocalizedText)

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

enum (TransitVehicleType)

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

string

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

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. Her vagon, diğerinin karşı ağırlığı olarak işlev görür.
GONDOLA_LIFT Teleferik
HEAVY_RAIL Ağır demiryolu.
HIGH_SPEED_TRAIN 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.

RouteLegTravelAdvisory

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

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

object (TollInfo)

Belirli bir RouteLeg üzerindeki geçiş ücretleriyle ilgili bilgileri içerir. Bu alan yalnızca RouteLeg üzerinde ücretli geçişlerin olduğunu düşünüyorsak ve TOLLS, isteğin ComputeRoutesRequest.extra_computations bölümünde yer alıyorsa doldurulur. Bu alan ayarlanmış ancak estimatedPrice alt alanı doldurulmamışsa yolun ücretli olduğunu tahmin ederiz ancak tahmini fiyatı bilmeyiz. tollInfo yoksa RouteLeg üzerinde geçiş ücreti yoktur.
speedReadingIntervals[]

object (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
speedReadingIntervals: [A,C), [C,D), [D,G).

RouteLegLocalizedValues

Belirli özelliklerin metin gösterimleri.

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

object (LocalizedText)

Metin biçiminde gösterilen seyahat mesafesi.
duration

object (LocalizedText)

Süre, metin biçiminde gösterilir ve sorgunun bulunduğu bölgeye göre yerelleştirilir. Trafik koşullarını dikkate alır. Not: Trafik bilgisi istemediyseniz bu değer, staticDuration ile aynı değerdir.
staticDuration

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

JSON gösterimi 
{
  "multiModalSegments": [
    {
      object (MultiModalSegment)
    }
  ]
}
Alanlar
multiModalSegments[]

object (MultiModalSegment)

RouteLeg.steps'nın farklı çok formatlı segmentleri hakkında özetlenmiş bilgiler. RouteLeg, adımlarda çok formatlı segmentler içermiyorsa 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ımlarda çok formatlı segmentler içermiyorsa bu alan doldurulmaz.

JSON gösterimi 
{
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}
Alanlar
navigationInstruction

object (NavigationInstruction)

Çok formatlı segment için NavigationInstruction.
travelMode

enum (RouteTravelMode)

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

integer

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

integer

Çok formatlı bir segmentin sonunu oluşturan ilgili RouteLegStep dizini.

Görüntü alanı

Enlem-boylam görüntü alanı, çapraz olarak zıt iki low ve high noktasıyla gösterilir. Görüntü alanı, kapalı bir bölge olarak kabul edilir. Yani sınırları da görüntü alanına dahildir. Enlem sınırları -90 ile 90 derece arasında (bu değerler dahil), boylam sınırları ise -180 ile 180 derece arasında (bu değerler dahil) olmalıdır. Çeşitli durumlar şunlardır:

  • low = high ise görüntü alanı tek bir noktadan oluşur.

  • low.longitude > high.longitude ise boylam aralığı ters çevrilir (görüntü alanı 180 derece boylam çizgisini geçer).

  • low.longitude = -180 derece ve high.longitude = 180 derece ise görüntü alanı tüm boylamları içerir.

  • low.longitude = 180 derece ve high.longitude = -180 derece ise boylam aralığı boş olur.

  • low.latitude > high.latitude ise enlem aralığı boş olur.

Hem low hem de high doldurulmalıdır ve gösterilen kutu boş olamaz (yukarıdaki tanımlarda belirtildiği gibi). Boş bir görünüm penceresi hataya neden olur.

Örneğin, bu görünüm penceresi New York City'yi tamamen kapsar:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

JSON gösterimi 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Alanlar
low

object (LatLng)

Zorunlu. Görüntü alanının en düşük noktası.
high

object (LatLng)

Zorunlu. Görüntü alanının en yüksek noktası.

RouteLocalizedValues

Belirli özelliklerin metin gösterimleri.

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

object (LocalizedText)

Metin biçiminde gösterilen seyahat mesafesi.
duration

object (LocalizedText)

Süre, metin biçiminde gösterilir ve sorgunun bulunduğu bölgeye göre yerelleştirilir. Trafik koşullarını dikkate alır. Not: Trafik bilgisi istemediyseniz bu değer, staticDuration ile aynı değerdir.
staticDuration

object (LocalizedText)

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

object (LocalizedText)

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

PolylineDetails

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

JSON gösterimi 
{
  "flyoverInfo": [
    {
      object (FlyoverInfo)
    }
  ],
  "narrowRoadInfo": [
    {
      object (NarrowRoadInfo)
    }
  ]
}
Alanlar
flyoverInfo[]

object (FlyoverInfo)

Çoklu çizgi boyunca fareyle üzerine gelindiğinde gösterilen ayrıntılar.
narrowRoadInfo[]

object (NarrowRoadInfo)

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

FlyoverInfo

Çoklu çizgi boyunca üstten geçişlerle ilgili bilgileri kapsar.

JSON gösterimi 
{
  "flyoverPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
Alanlar
flyoverPresence

enum (RoadFeatureState)

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

object (PolylinePointIndex)

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

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.

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 startIndex ve endIndex eşit olur.

JSON gösterimi 
{
  "startIndex": integer,
  "endIndex": integer
}
Alanlar
startIndex

integer

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

integer

Bu ayrıntının çoklu çizgi içindeki bitiş indeksi.

NarrowRoadInfo

Çoklu çizgi boyunca dar yollarla ilgili bilgileri kapsar.

JSON gösterimi 
{
  "narrowRoadPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
Alanlar
narrowRoadPresence

enum (RoadFeatureState)

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

object (PolylinePointIndex)

Çoklu çizgi boyunca dar yolla ilgili bilgilerin konumu.

GeocodingResults

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

JSON gösterimi 
{
  "origin": {
    object (GeocodedWaypoint)
  },
  "destination": {
    object (GeocodedWaypoint)
  },
  "intermediates": [
    {
      object (GeocodedWaypoint)
    }
  ]
}
Alanlar
origin

object (GeocodedWaypoint)

Başlangıç noktası için coğrafi kodlanmış ara nokta.
destination

object (GeocodedWaypoint)

Hedef coğrafi kodlu ara nokta.
intermediates[]

object (GeocodedWaypoint)

Her biri, istekte belirtildikleri sıraya göre ara coğrafi olarak kodlanmış yol noktalarının sıfır tabanlı konumuna karşılık gelen bir dizin alanı içeren ara coğrafi olarak kodlanmış yol noktalarının listesi.

GeocodedWaypoint

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

JSON gösterimi 
{
  "geocoderStatus": {
    object (Status)
  },
  "type": [
    string
  ],
  "partialMatch": boolean,
  "placeId": string,
  "intermediateWaypointRequestIndex": integer
}
Alanlar
geocoderStatus

object (Status)

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

string

Sonucun türleri; sıfır veya daha fazla tür etiketi biçiminde. Desteklenen türler: Adres türleri ve adres bileşeni türleri.
partialMatch

boolean

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

string

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

integer

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