Route

Başlangıç, bitiş ve ara ara noktaların birleştirildiği bir dizi bağlantı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 bacak, via olmayan iki Referans Noktası arasındaki seyahate karşılık gelir. Örneğin, ara ara noktaları olmayan bir rotanın yalnızca tek ayağı vardır. via olmayan bir ara nokta içeren rotanın iki ayağı var. Bir via ara ara noktası içeren rotanın tek ayağı var. Ayakların sırası, origin - intermediates - destination arası Referans Noktalarının sıralamasıyla eşleşir.

distanceMeters

integer

Rotanın metre cinsinden seyahat mesafesi.

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 kesir basamağı olan 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 kesir basamağı olan ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

polyline

object (Polyline)

Genel rota çoklu çizgisi. Bu çoklu çizgi, tüm legs için birleşik çoklu çizgi olacak.

description

string

Rotanın açıklaması.

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 değerine ayarlanırsa bu alan, ara noktaların optimize edilmiş sıralamasını içerir. Aksi takdirde bu alan boş bırakılır. Örneğin, girişin Kaynak: LA; olduğunu varsayalım. Aracılar: Dallas, Bangor, Phoenix; Hedef: New York; optimize edilmiş ara nokta sırası şöyledir: Phoenix, Dallas, Bangor. Ardından bu alan [2, 0, 1] değerlerini içerir. Dizin, ilk ara ara noktası için 0 ile başlar.

RouteLeg

via olmayan referans noktaları arasındaki bir segmenti kapsüller.

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)

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

En fazla dokuz kesir basamağı olan ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

staticDuration

string (Duration format)

Trafik koşulları dikkate alınmadan hesaplanan, bacak boyunca hareket etme süresi.

En fazla dokuz kesir basamağı olan ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

polyline

object (Polyline)

Bu bacak için genel çoklu çizgi. Buna her step çoklu çizgisi 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, yol üzerindeki bir noktadır.

endLocation

object (Location)

Bu bacağın bitiş konumu. Bu değer, sağlanan destination değerinden 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 dizi adım. Her adım bir gezinme talimatını temsil eder.

travelAdvisory

object (RouteLegTravelAdvisory)

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

Ç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 çizgi türünü içerir. 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 LineString biçimini kullanarak bir çoklu çizgiyi belirtir

RouteLegStep

Bir RouteLeg segmentini içerir. Bir adım, tek bir gezinme talimatına karşılık gelir. Rota ayakları basamaklardan 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 alanda değer bulunmayabilir.

staticDuration

string (Duration format)

Trafik koşulları dikkate alınmadan bu adımda gerçekleştirilen seyahat süresi. Bazı durumlarda bu alanda değer bulunmayabilir.

En fazla dokuz kesir basamağı olan ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

polyline

object (Polyline)

Bu adımla ilişkilendirilen ç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 trafik bölgesi kısıtlaması gibi kullanıcının bilgilendirilmesi gereken ek bilgileri içerir.

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)

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, çakışma olmadan RouteLegStep'in tüm çoklu çizgisini kapsar. Belirtilen bir aralığın başlangıç noktası, önceki aralığın bitiş noktasıyla aynı.

Örnek:

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

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 RouteLeg'deki ücretli geçişlerle ilgili bilgileri içerir. Bu alan yalnızca RouteLeg'de ücretli geçişler olmasını beklersek doldurulur. Bu alan ayarlanır ancak estimatedPrice alt alanı doldurulmazsa bu yolun ücretli geçiş içerdiğini bekleriz ancak tahmini bir fiyat bilmeyiz. Bu alan mevcut değilse RouteLeg'de ücretli geçiş yoktur.

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, çakışma olmadan RouteLg'in tüm çoklu çizgisini kapsar. Belirtilen bir aralığın başlangıç noktası, önceki aralığın bitiş noktasıyla aynı.

Örnek:

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