Route

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

JSON gösterimi
{
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ]
}
Alanlar
legs[]

object (RouteLeg)

Rotayı oluşturan ayak koleksiyonu (ara noktalar arasındaki yol segmentleri). Her aşama, via olmayan iki yol noktası 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 nokta içeren rotanın iki ayağı var. Bir via ara yol noktası içeren rotanın bir ayağı vardır. Bacak sırası, origin ile intermediates ve destination arasındaki yol işaretlerinin sırasıyla eşleşir.

distanceMeters

integer

Rotayı katedilen mesafe (metre cinsinden).

duration

string (Duration format)

Rotada gezinmek için gereken süre. routingPreference özelliğini 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, rota boyunca seyahat etme 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şik çoklu çizgisidir.

description

string

Rotayı açıklayan bir metin.

warnings[]

string

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

viewport

object (Viewport)

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

travelAdvisory

object (RouteTravelAdvisory)

Rota hakkında ek bilgiler.

optimizedIntermediateWaypointIndex[]

integer

ComputeRoutesRequest.optimize_waypoint_order doğru olarak ayarlanırsa bu alan, ara yol işaret noktalarının optimize edilmiş sırasını içerir. Aksi takdirde bu alan boştur. Örneğin, girişin Kaynak: LA; Ara Malzemeler: Dallas, Bangor, Phoenix; Hedef: New York ve optimize edilmiş ara ara noktasının Phoenix, Dallas, Bangor olduğunu varsayalım. Bu durumda, alan [2, 0, 1] değerlerini içerir. Dizin, ilk ara ara noktası için 0 ile başlar.

RouteLeg

via olmayan yol işaretleri arasındaki bir segmenti kapsar.

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

integer

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

duration

string (Duration format)

Bacak boyunca gezinmek için gereken süre. route_preference, TRAFFIC_UNAWARE olarak ayarlanırsa bu değer staticDuration ile aynı olur. route_preference TRAFFIC_AWARE veya TRAFFIC_AWARE_OPTIMAL ise bu değer, trafik koşulları dikkate alınarak hesaplanır.

"s" ile biten, en fazla dokuz kesir basamağı içeren, saniye cinsinden süre. Örnek: "3.5s".

staticDuration

string (Duration format)

Trafik koşulları dikkate alınmadan hesaplanan, kol 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 bacağı oluşturan genel poli çizgi. Her step'nin çoklu çizgisi de buna dahildir.

startLocation

object (Location)

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

endLocation

object (Location)

Bu etabın bitiş konumu. Bu, sağlanan destination ile 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 belirten bir adım dizisi. Her adım bir gezinme talimatını temsil eder.

travelAdvisory

object (RouteLegTravelAdvisory)

Kullanıcıya bildirilmesi gereken ek bilgileri (ör. rota adımında olası trafik bölgesi kısıtlaması) kapsar.

Çoklu çizgi

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

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 çizginin türünü kapsar. Varsayılan olarak coding_polyline değeri kullanılır. polyline_type şunlardan yalnızca biri olabilir:
encodedPolyline

string

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

geoJsonLinestring

object (Struct format)

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

RouteLegStep

RouteLeg segmentini kapsar. Bir adım, tek bir gezinme talimatına karşılık gelir. Rota bacakları 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)
  }
}
Alanlar
distanceMeters

integer

Bu adımın metre cinsinden seyahat mesafesi. Bazı durumlarda bu alan için bir değer olmayabilir.

staticDuration

string (Duration format)

Trafik koşulları dikkate alınmadan bu adımda gerçekleştirilen seyahat süresi. Bazı durumlarda bu alan için bir değer olmayabilir.

"s" ile biten, en fazla dokuz kesir basamağı içeren, 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 yol adımında olası trafik bölgesi kısıtlaması gibi kullanıcının bilgilendirilmesi gereken ek bilgileri kapsar.

RouteLegStepTravelAdvisory

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

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

object (SpeedReadingInterval)

NOT: Bu alan şu anda doldurulmamaktadır.

RouteLegTravelAdvisory

Rotanın bir ayağında, olası trafik bölgesi kısıtlaması gibi kullanıcının bilgilendirilmesi gereken ek bilgileri içerir.

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

object (TollInfo)

Belirli bir RouteLeg üzerindeki ücretler hakkındaki bilgileri kapsar. Bu alan yalnızca RouteLeg üzerinde geçiş ücreti olduğunu tahmin ettiğimizde doldurulur. Bu alan ayarlanmışsa ancak estimatedPrice alt alanı doldurulmamışsa yolun ücretli olduğunu varsayıyoruz ancak tahmini fiyatı bilmiyoruz. Bu alan yoksa RouteLeg için ücret alınmaz.

speedReadingIntervals[]

object (SpeedReadingInterval)

Trafik yoğunluğunu ayrıntılı şekilde gösteren hızlı okuma aralıkları. TRAFFIC_AWARE ve TRAFFIC_AWARE_OPTIMAL yönlendirme tercihleri için geçerlidir. Aralıklar, 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
speedReadingIntervals: [A,C), [C,D), [D,G).