Method: computeRoutes

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

NOT: Bu yöntem, girişte bir yanıt alanı maskesi belirtmenizi gerektirir. $fields veya fields URL parametresini ya da bir HTTP/gRPC üstbilgisi X-Goog-FieldMask kullanarak yanıt alanı maskesini sağlayabilirsiniz (kullanılabilir URL parametreleri ve üstbilgilerine bakın). Değer, alan yollarının virgülle ayrılmış bir listesidir. Alan yollarının nasıl oluşturulacağı ile ilgili ayrıntılı dokümanlara 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 için alan maskesi (örnek üretim kurulumu): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google, aşağıdaki nedenlerle joker karakter (*) yanıt alanı maskesinin kullanılmasını veya alan maskesinin üst düzeyde (routes) belirtilmesini önermez:

  • Yalnızca ihtiyacınız olan alanları seçmeniz, sunucumuzun hesaplama döngülerini kaydetmesine yardımcı olarak sonucu size daha düşük bir gecikmeyle döndürmemizi sağlar.
  • Üretim işinizde yalnızca ihtiyaç duyduğunuz alanları seçmeniz, gecikme performansının istikrarlı olmasını sağlar. Gelecekte daha fazla yanıt alanı ekleyebiliriz ve bu yeni alanlar daha fazla hesaplama süresi gerektirebilir. Tüm alanları seçerseniz veya en üst düzeydeki tüm alanları seçerseniz, eklediğimiz yeni alanlar yanıta otomatik olarak dahil edileceğinden performansta düşüşle karşılaşabilirsiniz.
  • Yalnızca ihtiyacınız olan alanları seçtiğinizde yanıt boyutu küçülür ve böylece daha yüksek ağ işleme hızı elde edilir.

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 gövdesi, aşağıdaki yapıya sahip 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ıç noktası referans noktası.

destination

object (Waypoint)

Zorunlu. Hedef referans noktası.

intermediates[]

object (Waypoint)

İsteğe bağlı. Güzergah üzerinde durmak veya geçmek için rota üzerinde bir dizi ara nokta (uç noktalar hariç). En fazla 25 ara ara nokta desteklenir.

travelMode

enum (RouteTravelMode)

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

routingPreference

enum (RoutingPreference)

İsteğe bağlı. Rotanın nasıl hesaplanacağını belirtir. Sunucu, yolu hesaplamak için seçilen yönlendirme tercihini kullanmaya çalışır. Yönlendirme tercihi hataya veya ekstra uzun gecikmeye neden olursa bir 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 kalitesi için 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 değer, varsayılan olarak isteği yaptığınız zaman olur. NOT: Yalnızca RouteTravelMode, TRANSIT olarak ayarlandığında geçmişte bir departureTime belirtebilirsiniz. Geçmişteki 7 güne veya gelecekteki 100 güne kadar toplu taşıma seyahatleri mevcuttur.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

arrivalTime

string (Timestamp format)

İsteğe bağlı. Varış saati. NOT: Yalnızca RouteTravelMode, TRANSIT olarak ayarlandığında ayarlanabilir. departureTime ve arrivalTime öğelerinden birini belirtebilirsiniz ancak ikisini birden belirtemezsiniz. Geçmişteki 7 güne veya gelecekteki 100 güne kadar toplu taşıma seyahatleri mevcuttur.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

computeAlternativeRoutes

boolean

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

routeModifiers

object (RouteModifiers)

İsteğe bağlı. Rotaların hesaplanma şeklini etkileyen ve yerine getirilecek bir dizi koşul.

languageCode

string

İsteğe bağlı. "en-US" gibi BCP-47 dil kodu veya "sr-Latn" girin. Daha fazla bilgi için Unicode Yerel Ayar Tanımlayıcısı bölümüne bakın. Desteklenen dillerin listesi için Dil Desteği bölümüne bakın. Bu değeri sağlamadığınızda, görüntüleme dili, rota isteğinin konumundan belirlenir.

regionCode

string

İsteğe bağlı. ccTLD ("üst düzey alan") olarak belirtilen iki karakterlik değer. 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ünen alanlar için ölçü birimlerini belirtir. Bu alanlar, NavigationInstruction içindeki instruction alanını içerir. Rota, bacak, 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 tahmin edilir.

optimizeWaypointOrder

boolean

İsteğe bağlı. Doğru değerine ayarlanırsa hizmet, belirtilen ara noktaları yeniden sıralayarak rotanın toplam maliyetini en aza indirmeye çalışır. Ara ara noktaların herhangi biri via referans noktasıysa istek başarısız olur. Yeni sıralamayı bulmak için ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index öğesini kullanın. X-Goog-FieldMask başlığında ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index istenmezse istek başarısız olur. optimizeWaypointOrder yanlış değerine ayarlanırsa ComputeRoutesResponse.optimized_intermediate_waypoint_index boş görünür.

requestedReferenceRoutes[]

enum (ReferenceRoute)

İsteğe bağlı. Varsayılan rotaya ek olarak istek kapsamında hangi referans rotalarının hesaplanacağını belirtir. Referans rota, varsayılan rotadan farklı bir rota hesaplama hedefine sahip rotadır. Örneğin, FUEL_EFFICIENT referans rota hesaplamasında, ideal yakıt verimliliği rotası oluşturacak çeşitli parametreler dikkate alınır.

extraComputations[]

enum (ExtraComputation)

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

trafficModel

enum (TrafficModel)

İsteğe bağlı. Trafikteki süre hesaplanırken kullanılacak varsayımları belirtir. Bu ayar, geçmiş ortalamalara göre trafikteki tahmini süreyi içeren Route ve RouteLeg alanlarındaki süre alanında döndürülen değeri etkiler. TrafficModel, yalnızca RoutingPreference değerini TRAFFIC_AWARE_OPTIMAL ve RouteTravelMode değerini DRIVE olarak ayarlayan istekler için kullanılabilir. Trafik isteniyorsa ve TrafficModel belirtilmezse varsayılan olarak BEST_GUESS değerine ayarlanı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 bir transitPreferences belirtebilirsiniz.

Yanıt gövdesi

v2.computeRoutes, yanıt mesajını gönderir.

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 değerini belirttiğinizde bir hesaplanan rota dizisi (en fazla üç) ve eklemediğinizde yalnızca bir rota içerir. Bu dizi birden fazla giriş içerdiğinde ilki en önerilen rotadır. Dizinin boş olması, herhangi bir rota bulunamadığı anlamına gelir.

fallbackInfo

object (FallbackInfo)

Bazı durumlarda sunucu, tüm giriş tercihlerini kullanarak rota sonuçlarını hesaplayamadığında, farklı bir hesaplama yöntemi kullanmaya geçebilir. Yedek mod kullanıldığında bu alan, yedek yanıt hakkında ayrıntılı bilgiler içerir. Aksi takdirde bu alan ayarlanmaz.

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ğer grubu.

Sıralamalar
POLYLINE_QUALITY_UNSPECIFIED Çoklu çizgi kalitesi tercihi belirtilmedi. Varsayılan olarak OVERVIEW değerine ayarlanır.
HIGH_QUALITY Artan yanıt boyutu pahasına, OVERVIEW değerinden daha fazla nokta kullanılarak oluşturulan yüksek kaliteli bir çoklu çizgiyi belirtir. Daha fazla hassasiyete ihtiyacınız olduğunda bu değeri kullanın.
OVERVIEW Az sayıda nokta kullanılarak oluşturulan genel bakış çoklu çizgisini belirtir. Rotanın bir özetini görüntülerken bu değeri kullanın. Bu seçenek kullanıldığında, HIGH_QUALITY seçeneğine kıyasla daha düşük bir istek gecikmesi olur.

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 çizgiyi belirtir.
GEO_JSON_LINESTRING GeoJSON LineString biçimini kullanarak bir çoklu çizgiyi belirtir

ReferenceRoute

ComputeRoutesRequest'te desteklenen bir referans rota.

Sıralamalar
REFERENCE_ROUTE_UNSPECIFIED Kullanılmıyor. Bu değeri içeren istekler başarısız olur.
FUEL_EFFICIENT Yakıt verimliliği yüksek rota. Bu değerle etiketlenen rotaların, yakıt tüketimi gibi parametreler için optimize edildiği belirlenmiştir.

ExtraComputation

İstek tamamlanırken gerçekleştirilecek ek hesaplamalar.

Sıralamalar
EXTRA_COMPUTATION_UNSPECIFIED Kullanılmıyor. 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 trafiğe duyarlı çoklu çizgiler.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions, biçimlendirilmiş bir HTML metin dizesi olarak sunulur. Bu içerikler olduğu gibi okunmalıdır. Bu içerik yalnızca görüntüleme içindir. Kodu programlı bir şekilde ayrıştırmayın.

Rota

Başlangıç, bitiş ve ara ara noktaların birleştirildiği bir dizi bağlantı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
}
Alanlar
routeLabels[]

enum (RouteLabel)

Rotanın diğer özellikleriyle karşılaştırmak üzere belirli mülklerin tanımlanmasında yararlı olan Route etiketleri.

legs[]

object (RouteLeg)

Rotayı oluşturan ayak koleksiyonu (ara noktaların arasındaki yol segmentleri). Her bacak, via olmayan iki Waypoints 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 ara 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 gerçekleştirilen seyahat 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 öğelerinin birleşik çoklu çizgisidir.

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

optimizeWaypointOrder değerini doğru değerine ayarlarsanız bu alan, ara noktaların optimize edilmiş sıralamasını içerir. Aksi takdirde bu alan boş bırakılır. Örneğin, Kaynak: LA; Ara ara noktalar: Dallas, Bangor, Phoenix; Hedef: New York; ve optimize edilmiş ara ara nokta sırası Phoenix, Dallas, Bangor ise bu alanda [2, 0, 1] değerleri yer alır. Dizin, girişte sağlanan ilk ara ara noktası için 0 ile başlar.

localizedValues

object (RouteLocalizedValues)

Route özelliklerinin metin gösterimleri.

routeToken

string

Navigasyon SDK'sına iletilebilecek web güvenli, base64 kodlu rota jetonu. Bu jeton, Navigasyon SDK'sının navigasyon sırasında rotayı yeniden oluşturmasına olanak tanır ve yeniden rota oluşturulması durumunda v2.computeRoutes'u çağırarak rotayı oluşturduğunuzda asıl amacı dikkate alır. Müşteriler bu jetonu opak bir blob olarak değerlendirmelidir. Değerini istekler arasında karşılaştırmayın. Tam olarak aynı rota döndürülse bile bu jeton değişebilir. NOT: Route.route_token yalnızca ComputeRoutesRequest.routing_preference öğesini TRAFFIC_AWARE veya TRAFFIC_AWARE_OPTIMAL olarak ayarlayan isteklerde kullanılabilir. Route.route_token, Via ara noktaları olan istekler için desteklenmez.

RouteLabel

Rotanın diğer özellikleriyle karşılaştırmak üzere belirli mülklerin tanımlanmasında yararlı olan Route etiketleri.

Sıralamalar
ROUTE_LABEL_UNSPECIFIED Varsayılan - kullanılmaz.
DEFAULT_ROUTE Varsayılan "en iyi" rota hesaplaması için döndürülen rotadır.
DEFAULT_ROUTE_ALTERNATE Varsayılan "en iyi"ye bir alternatif yol gösterir. computeAlternativeRoutes belirtildiğinde buna benzer 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 eko parametreler için optimize edildiği tespit edilmiştir.

RouteLeg

via olmayan referans noktaları arasında bir segment içeriyor.

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)

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, ayak boyunca seyahat 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, her step adlı kullanıcının çoklu çizgisini içeren genel çoklu çizgi.

startLocation

object (Location)

Bu bacağı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 bacağı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 belirten bir dizi adım. Her adım bir gezinme talimatını temsil eder.

travelAdvisory

object (RouteLegTravelAdvisory)

Bir rota ayağı üzerinde kullanıcının bilgilendirilmesi gereken ek bilgileri (ör. olası trafik bölgesi kısıtlamaları) içerir.

localizedValues

object (RouteLegLocalizedValues)

RouteLeg özelliklerinin metin gösterimleri.

stepsOverview

object (StepsOverview)

Bu RouteLeg içindeki adımlarla ilgili genel bakış bilgileri. Bu alan yalnızca TRANSIT rotaları için doldurulur.

Ç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

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)
  },
  "localizedValues": {
    object (RouteLegStepLocalizedValues)
  },
  "transitDetails": {
    object (RouteLegStepTransitDetails)
  },
  "travelMode": enum (RouteTravelMode)
}
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, 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)

Ulaşım şekli TRANSIT ise bu adımla ilgili ayrıntılar.

travelMode

enum (RouteTravelMode)

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

Manevra

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

Sıralamalar
MANEUVER_UNSPECIFIED Kullanılmıyor.
TURN_SLIGHT_LEFT Hafifçe sola dönün.
TURN_SHARP_LEFT Sola keskin bir dönüş yapın.
UTURN_LEFT Sola u dönüşü yapın.
TURN_LEFT Sola dönün.
TURN_SLIGHT_RIGHT Sağa hafif dönüş yapın.
TURN_SHARP_RIGHT Sağa keskin bir dönüş yapı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 Sağdaki rampayı kullanın.
MERGE Trafiğe ekleyin.
FORK_LEFT Soldaki çatalı kullanın.
FORK_RIGHT Doğru çatalı kullanın.
FERRY Feribota binin.
FERRY_TRAIN Feribota giden trene binin.
ROUNDABOUT_LEFT Döner kavşakta 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

Bir ayak basamağındaki olası trafik bölgesi kısıtlamaları 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.

RouteLegStepLocalizedValues

Belirli tesislerin metin temsilleri.

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, metin biçiminde gösterilen süre.

RouteLegStepTransitDetails

TRANSIT rotalarıyla ilgili RouteLegStep 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 işaretlendiği şekilde bu çizgide seyahat edilecek yönü belirtir. Yol tarifi genellikle terminal istasyonudur.

headway

string (Duration format)

Beklenen süreyi, aynı duraktan yapılan kalkışlar arasındaki süre olarak belirtir. Örneğin, ileriye dönük saniye değeri 600 ise otobüsü kaçırırsanız on dakikalık bir bekleme süresi beklersiniz.

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

transitLine

object (TransitLine)

Bu adımda kullanılan toplu taşıma hattıyla ilgili bilgi.

stopCount

integer

Kalkış noktasından varış durağına kadar geçen durak sayısı. Bu sayıya varış durağı dahildir ancak kalkış noktası dahil değildir. Örneğin, rotanız A Durağı'ndan kalkıyor, B ve C duraklarından geçiyor ve D durağına varıyorsa, stopCount 3 sonucunu döndürür.

tripShortText

string

Yolcuların toplu taşıma seyahatini tanımlamak için zaman çizelgelerinde ve tabelalarda gösterilen metin. Metin, bir hizmet günü içindeki bir seyahati benzersiz şekilde tanımlamalıdır. Örneğin, "538" Kaliforniya, San Jose, Kaliforniya'da hafta içi saat 15:10'da Sacramento, Kaliforniya'ya giden Amtrak treninin tripShortText.

TransitStopDetails

RouteLegStep 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ış noktasıyla ilgili bilgiler.

arrivalTime

string (Timestamp format)

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

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

departureStop

object (TransitStop)

Adımın kalkış noktasıyla ilgili bilgiler.

departureTime

string (Timestamp format)

Adımın tahmini kalkış saati.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

TransitStop

Bir toplu taşıma durağıyla ilgili bilgiler.

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

string

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

location

object (Location)

Enlem/boylam koordinatlarıyla ifade edilen durak 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 temsilinde saat ve karşılık gelen saat dilimi.

departureTime

object (LocalizedTime)

Biçimlendirilmiş metin temsilinde saat ve karşılık gelen saat dilimi.

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. Bu değer, IANA Saat Dilimi Veritabanı'nda tanımlanan saat diliminin adıdır (ör. "Amerika/New_York".

TransitLine

Bu adımda kullanılan toplu taşıma hattıyla ilgili bilgileri 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 acentesi (veya acenteleri).

name

string

Bu toplu taşıma hattının tam adı. Örneğin, "8 Bulvarı Yerel".

uri

string

bu toplu taşıma hattının, toplu taşıma acentesi tarafından sağlandığı URI'yı kullanın.

color

string

Bu çizgi için tabelalarda yaygın olarak kullanılan renk. Onaltılık sayı olarak gösterilir.

iconUri

string

Bu satırla ilişkili simgenin URI'sı.

nameShort

string

Bu toplu taşıma hattının kısa adı. Bu ad, normalde "M7" gibi bir satır numarasıdır. veya "355" gibi).

textColor

string

Bu satır için tabelalardaki metinde yaygın olarak kullanılan renk. Onaltılık sayı olarak gösterilir.

vehicle

object (TransitVehicle)

Bu toplu taşıma hattında çalışan aracın türü.

TransitAgency

Toplu taşıma hattı işleten bir toplu taşıma acentesi.

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

string

Bu toplu taşıma acentesinin adı.

phoneNumber

string

Transit operatörüne ait yerel ayara özgü biçimlendirilmiş telefon numarası.

uri

string

Transit operatörüne ait URI.

TransitVehicle

Toplu taşıma rotalarında kullanılan bir araç hakkında bilgi.

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

object (LocalizedText)

Bu aracın adının büyük harfle yazılmış adı.

type

enum (TransitVehicleType)

Kullanılan aracın türü.

iconUri

string

Bu araç türüyle ilişkilendirilmiş bir simgenin URI'sı.

localIconUri

string

Yerel ulaşım tabelalarına göre bu araç türüyle ilişkili simgenin URI'si.

TransitVehicleType

Toplu taşıma rotaları için taşıt türü.

Sıralamalar
TRANSIT_VEHICLE_TYPE_UNSPECIFIED Kullanılmayan.
BUS Otobüs.
CABLE_CAR Bir kablo üzerinde çalışan, genellikle yerde çalışan taşıttır. Teleferikler GONDOLA_LIFT türünde olabilir.
COMMUTER_TRAIN Banliyö treni.
FERRY Feribot.
FUNICULAR Dik bir eğimden kabloyla çekilen araç. Füniküler genellikle iki arabadan oluşur ve her araba diğeri için karşı ağırlık teşkil eder.
GONDOLA_LIFT Teleferik.
HEAVY_RAIL Tramvay.
HIGH_SPEED_TRAIN Hızlı tren.
INTERCITY_BUS Şehirlerarası otobüs.
LONG_DISTANCE_TRAIN Şehirlerarası tren.
METRO_RAIL Hafif raylı taşıt toplu taşıması.
MONORAIL Monoray.
OTHER Diğer tüm araçlar.
RAIL Demiryolu.
SHARE_TAXI Paylaşımlı taksi, rotasının her yerinden yolcuları indirip yolcu alma yeteneğine sahip bir otobüs türüdür.
SUBWAY Yer altı hafif raylı sistem.
TRAM Yer üstü hafif raylı sistem.
TROLLEYBUS Troleybüs.

RouteLegTravelAdvisory

Olası trafik bölgesi kısıtlamaları gibi, ayak adımında 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 üzerindeki ücretli geçişler hakkında bilgiler içerir. Bu alan yalnızca RouteLeg üzerinde ücretli geçiş 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 yoksa RouteLeg hattında ü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 RouteLeg çoklu çizgisinin tamamını 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).

RouteLegLocalizedValues

Belirli tesislerin metin temsilleri.

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)

Trafik koşullarını dikkate alan ve metin biçiminde gösterilen süre. Not: Trafik bilgisi istemediyseniz bu değer, staticDuration ile aynı değer olacaktır.

staticDuration

object (LocalizedText)

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

StepsOverview

RouteLegStep listesi hakkında genel bilgi sağlar.

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

object (MultiModalSegment)

RouteLeg.steps aracının farklı çok modlu segmentleri hakkındaki bilgileri özetledi. RouteLeg, adımlarda çok modlu segment içermiyorsa bu alan doldurulmaz.

MultiModalSegment

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

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

object (NavigationInstruction)

Çok modlu segment için NavigationTalimatları.

travelMode

enum (RouteTravelMode)

Çok modlu segmentin ulaşım şekli.

stepStartIndex

integer

Çok modlu bir segmentin başlangıcı olan karşılık gelen RouteLegStep dizini.

stepEndIndex

integer

Çok modlu bir segmentin sonu olan karşılık gelen RouteLegStep dizini.

Görüntü alanı

low ve high noktasının çapraz olarak iki yönünde çapraz olarak gösterilen enlem-boylam görüntü alanı. Görüntü alanı, kapalı bir bölge olarak kabul edilir. Yani kendi sınırlarını içerir. Enlem sınırları -90 ile 90 derece (dahil) arasında, boylam sınırları ise -180 ile 180 derece (her ikisi de dahil) arasında olmalıdır. Çeşitli durumlar şunlardır:

  • low = high olursa, görüntü alanı bu tek noktadan oluşur.

  • Eğer low.longitude > high.longitude ise, boylam aralığı tersine çevrilir (görüntü alanı 180 derecelik 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.

  • Eğer low.latitude > high.latitude, enlem aralığı boş.

Hem low hem de high doldurulmalı ve gösterilen kutu (yukarıdaki tanımlarda belirtildiği gibi) boş bırakılamaz. Boş görüntü alanı hatayla sonuçlanır.

Örneğin, bu görüntü alanı 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 düşük noktası.

high

object (LatLng)

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

RouteLocalizedValues

Belirli tesislerin metin temsilleri.

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)

Trafik koşullarını dikkate alan, metin biçiminde gösterilen süre. Not: Trafik bilgilerini istemediyseniz, bu değer staticDuration ile aynı olacaktır.

staticDuration

object (LocalizedText)

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

transitFare

object (LocalizedText)

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

GeocodingResults

Kalkış, hedef ve ara ara noktalar için GeocodedWaypoints içerir. Yalnızca adres ara noktaları için doldurulur.

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

object (GeocodedWaypoint)

Kaynak coğrafi kodlu ara nokta.

destination

object (GeocodedWaypoint)

Hedef coğrafi kodlu ara nokta.

intermediates[]

object (GeocodedWaypoint)

Her biri, istekte belirtilen sırada referans noktasının sıfır tabanlı konumuna karşılık gelen bir dizin alanı içeren ara coğrafi kodlu ara noktaların listesi.

GeocodedWaypoint

Referans noktası olarak kullanılan konumlarla ilgili ayrıntılar. Yalnızca adres ara noktaları için doldurulur. Adresin coğrafi olarak neye kodlandığının belirlenmesi amacıyla 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

Coğrafi kodlayıcının, orijinal istek için tam eşleşme döndürmediğini, ancak istenen adresin bir kısmını eşleştirebildiğini belirtir. Yazım hataları ve/veya eksik adres olup olmadığını kontrol etmek için orijinal isteği inceleyebilirsiniz.

placeId

string

Bu sonucun yer kimliği.

intermediateWaypointRequestIndex

integer

İstekteki karşılık gelen ara ara noktanın dizini. Yalnızca karşılık gelen ara nokta bir ara noktaysa doldurulur.