Method: computeRoutes

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

NOT: Bu yöntem, girişte bir yanıt alanı maskesi belirtmenizi gerektirir. Yanıt alanı maskesini $fields veya fields URL parametresini ya da X-Goog-FieldMask HTTP/gRPC başlığını kullanarak sağlayabilirsiniz (kullanılabilir URL parametreleri ve başlıklarına 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ı belgeleri inceleyin.

Ö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 çizginin alan maskesi (örnek üretim kurulumu): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

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

  • 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 sunmamıza olanak tanır.
  • Üretim işinizde yalnızca ihtiyacınız olan alanların seçilmesi, gecikme performansının istikrarlı olmasını sağlar. Gelecekte daha fazla yanıt alanı ekleyebiliriz ve bu yeni alanlar ekstra 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üşüş yaşayabilirsiniz.
  • Yalnızca ihtiyacınız olan alanların seçilmesi, daha küçük bir yanıt boyutuyla ve dolayısıyla daha yüksek ağ işleme hızıyla sonuçlanır.

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

İsteğin gövdesi, aşağıdaki yapıya sahip veriler 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ı ara noktası.

destination

object (Waypoint)

Zorunlu. Hedef ara nokta.

intermediates[]

object (Waypoint)

İsteğe bağlı. Rota boyunca, durak noktaları dışında durmak veya geçmek için kullanılan ara noktalar grubu (uç noktalar hariç). 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, yolu hesaplamak için seçili yönlendirme tercihini kullanmayı dener. Yönlendirme tercihi hataya veya ekstra uzun gecikmeye yol açarsa 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 bu değer varsayılan olarak, istekte bulunduğunuz zamana ayarlanır. NOT: Yalnızca RouteTravelMode, TRANSIT olarak ayarlandığında departureTime öğesini belirtebilirsiniz. Toplu taşıma seyahatleri, geçmiş en fazla 7 gün veya gelecekteki 100 gün için mevcuttur.

Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Ö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 yapılabilir. departureTime veya arrivalTime değerlerinden birini belirtebilirsiniz, ancak ikisini birden belirtemezsiniz. Toplu taşıma seyahatleri, geçmiş en fazla 7 gün veya gelecekteki 100 gün için mevcuttur.

Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Ö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 noktaları olan istekler için alternatif rotalar döndürülmez.

routeModifiers

object (RouteModifiers)

İsteğe bağlı. Rotaların hesaplanma şeklini etkileyecek koşulları karşılamak için bir dizi koşul.

languageCode

string

İsteğe bağlı. "en-US" veya "sr-Latn" gibi BCP-47 dil kodu. 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 sayfasına göz atın. Bu değeri sağlamadığınızda görüntüleme dili, rota isteğinin konumundan tahmin edilir.

regionCode

string

İsteğe bağlı. ccTLD ("üst düzey alan") iki karakterli değer olarak belirtilen bölge kodu. 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ülenen 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 konumuna göre belirlenir.

optimizeWaypointOrder

boolean

İsteğe bağlı. Doğru değerine ayarlanırsa hizmet, belirtilen ara ara noktaları yeniden sıralayarak rotanın toplam maliyetini en aza indirmeye çalışır. Ara ara noktalardan 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ş bırakılır.

requestedReferenceRoutes[]

enum (ReferenceRoute)

İsteğe bağlı. Varsayılan rotaya ek olarak isteğin parçası olarak hangi referans rotaları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, yakıt verimliliği yüksek bir rota oluşturacak çeşitli parametreler dikkate alınır.

extraComputations[]

enum (ExtraComputation)

İsteğe bağlı. İsteği tamamlamak için kullanılabilecek ekstra hesaplamaların listesi. Not: Bu ekstra 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üreyi hesaplarken kullanılacak varsayımları belirtir. Bu ayar, Route ve RouteLeg alanlarındaki süre alanında döndürülen değeri etkiler. Bu değer, geçmiş ortalamalara göre trafikte tahmini süreyi içerir. TrafficModel, yalnızca RoutingPreference öğesinin TRAFFIC_AWARE_OPTIMAL ve RouteTravelMode öğesinin DRIVE olarak ayarlandığı istekler için kullanılabilir. Trafik isteniyorsa ve TrafficModel belirtilmezse varsayılan olarak BEST_GUESS olur.

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ı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 belirttiğinizde bir hesaplanan rota dizisi (en fazla üç) içerir, belirtmediğinizde ise yalnızca bir rota içerir. Bu dizi birden çok giriş içerdiğinde, ilki en çok önerilen yoldur. Dizi boşsa, hiç rota bulunamadı demektir.

fallbackInfo

object (FallbackInfo)

Sunucunun tüm giriş tercihleriyle rota sonuçlarını hesaplayamadığı bazı durumlarda, farklı bir hesaplama yöntemi kullanmaya geçebilir. Yedek modu 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 kalite tercihi belirtilmedi. Varsayılan olarak OVERVIEW değerine ayarlanır.
HIGH_QUALITY Artırılmış yanıt boyutu pahasına, OVERVIEW değerinden daha fazla nokta kullanılarak oluşturulan yüksek kaliteli çoklu çizgiyi belirtir. Daha fazla kesinliğe 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 genel görünümünü gösterirken bu değeri kullanın. Bu seçeneğin kullanılması, HIGH_QUALITY seçeneğine kıyasla daha düşük bir istek gecikmesine neden 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 çizgi 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 belirlenir.

ExtraComputation

İstek tamamlanırken gerçekleştirilecek ekstra 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 bilgisi.
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çeriğin olduğu gibi okunması amaçlanmıştır. Bu içerik yalnızca görüntüleme amaçlıdır. Bunu programlı bir şekilde ayrıştırmayın.

Rota

Başlangıç, bitiş ve ara noktaları birleştiren 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 belirli özelliklerini belirleyerek diğerleriyle karşılaştırmak için yararlı olan Route etiketleri.

legs[]

object (RouteLeg)

Rotayı oluşturan bacak koleksiyonu (ara noktaları arasındaki yol segmentleri). Her bacak, via olmayan iki Waypoints arasındaki seyahate karşılık gelir. Örneğin, ara noktaları olmayan bir rotanın yalnızca tek ayağı olur. via dışında bir ara nokta içeren bir rotanın iki ayağı vardır. via ara noktasında bir ara nokta içeren rotanın tek bacağı vardır. Bacakların sırası, origin - intermediates - destination arasındaki ara noktaların sıralamasıyla aynıdır.

distanceMeters

integer

Rotanın metre cinsinden seyahat mesafesi.

duration

string (Duration format)

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

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

staticDuration

string (Duration format)

Trafik koşulları dikkate alınmadan rota boyunca yapılan seyahat süresi.

"s" ile biten ve en fazla dokuz kesir basamağı olan, saniye cinsinden bir 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

Rota görüntülenirken gösterilecek bir uyarı dizisi.

viewport

object (Viewport)

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

travelAdvisory

object (RouteTravelAdvisory)

Rota hakkında ek bilgi.

optimizedIntermediateWaypointIndex[]

integer

optimizeWaypointOrder öğesini true olarak ayarlarsanız bu alan, ara ara noktaların optimize edilmiş sıralamasını içerir. Aksi takdirde bu alan boş bırakılır. Örneğin, Başlangıç noktası: LA; Ara ara noktalar: Dallas, Bangor, Phoenix; Hedef: New York; optimize edilmiş ara ara nokta sırası Phoenix, Dallas, Bangor ise, bu alan [2, 0, 1] değerlerini içerir. Dizin, girişte sağlanan ilk ara ara nokta için 0 ile başlar.

localizedValues

object (RouteLocalizedValues)

Route özelliklerinin metin temsilleri.

routeToken

string

Navigasyon SDK'sına geçirilebilen web güvenli, base64 kodlu rota jetonu, Navigasyon SDK'sının navigasyon sırasında rotayı yeniden oluşturmasına olanak tanır ve yeniden rota çizme durumunda, v2.computeRoutes yöntemini çağırarak rotayı oluşturduğunuzdaki asıl amacı dikkate alır. Müşteriler bu jetonu opak blob olarak işlemelidir. Okuma veya dönüştürme amaçlı değildir. NOT: Route.route_token, yalnızca ComputeRoutesRequest.routing_preference öğesinin TRAFFIC_AWARE veya TRAFFIC_AWARE_OPTIMAL olarak ayarlandığı isteklerde kullanılabilir. Route.route_token, üzerinden ara noktaları olan istekler için desteklenmez.

RouteLabel

Rotanın belirli özelliklerini belirleyerek diğerleriyle karşılaştırmak için yararlı olan Route etiketleri.

Sıralamalar
ROUTE_LABEL_UNSPECIFIED Varsayılan (kullanılmıyor).
DEFAULT_ROUTE Rota hesaplaması için varsayılan "en iyi" rota döndürüldü.
DEFAULT_ROUTE_ALTERNATE Varsayılan "en iyi" rotanın bir alternatifidir. computeAlternativeRoutes belirtildiğinde bunun gibi rotalar döndürülür.
FUEL_EFFICIENT Yakıt verimliliği yüksek rota. Bu değerle etiketlenen rotalar, yakıt tüketimi gibi Eko parametreler için optimize edilmiş olarak belirlenir.

RouteLeg

via olmayan ara 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 aşaması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 veya TRAFFIC_AWARE_OPTIMAL ise bu değer trafik koşulları dikkate alınarak hesaplanır.

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

staticDuration

string (Duration format)

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

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

polyline

object (Polyline)

Bu bacağın, her step çoklu çizgisini içeren genel çoklu çizgisi.

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 son 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 bacak içindeki segmentleri belirten bir adım dizisi. Her adım bir gezinme talimatını temsil eder.

travelAdvisory

object (RouteLegTravelAdvisory)

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

stepsOverview

object (StepsOverview)

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

Çoklu çizgi

Kodlanmış bir çoklu çizgi 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ü içerir. Varsayılan olarak coding_polyline değerine ayarlanı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 segmenti içerir. Bir adım, tek bir gezinme 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 alanda değer bulunmayabilir.

staticDuration

string (Duration format)

Trafik koşulları dikkate alınmadan bu adımdaki seyahat süresi. Bazı durumlarda bu alanda değer bulunmayabilir.

"s" ile biten ve en fazla dokuz kesir basamağı olan, saniye cinsinden bir 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 temsilleri.

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 (örneğin, sola dön, birleştir veya düz) belirten değerler grubu.

Sıralamalar
MANEUVER_UNSPECIFIED Kullanılmıyor.
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 Tam sağa dönün.
UTURN_RIGHT Sağa bir u dönüşü yapın.
TURN_RIGHT Sağa dönün.
STRAIGHT Dümdüz gidin.
RAMP_LEFT Soldaki rampayı kullanın.
RAMP_RIGHT Sağdaki rampayı kullanın.
MERGE Trafikle birleştirin.
FORK_LEFT Soldaki çatalı kullanın.
FORK_RIGHT Doğru çatalı kullanın.
FERRY Feribota binin.
FERRY_TRAIN Feribota doğru 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 göstermek için kullanılır.

RouteLegStepTravelAdvisory

Kullanıcının bilgilendirilmesi 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 mülklerin 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ının dikkate alınmadığı ve metin biçiminde gösterilen süre.

RouteLegStepTransitDetails

RouteLegStep için TRANSIT rotalarıyla ilgili 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 için varış ve kalkış durakları hakkında bilgi.

localizedValues

object (TransitDetailsLocalizedValues)

RouteLegStepTransitDetails özelliklerinin metin temsilleri.

headsign

string

Araçta veya kalkış durağında belirtildiği şekilde bu hatta seyahat edilecek yönü belirtir. Gideceğiniz yol genellikle terminal istasyonudur.

headway

string (Duration format)

Beklenen süreyi, aynı duraktan yapılan kalkışlar arasındaki süre olarak belirtir. Örneğin, 600 mesafe saniye değeri varsa, otobüsü kaçırırsanız on dakika beklemeniz gerekir.

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

transitLine

object (TransitLine)

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

stopCount

integer

Kalkıştan varış durağına kadar aktarma sayısı. Bu sayıya varış durağı dahil, ancak kalkış durağı dahil değildir. Örneğin, rotanız A Durağı'ndan ayrılıyor, B ve C duraklarından geçiyorsa ve D durağına gelirse, stopCount 3 değerini döndürecektir.

tripShortText

string

Yolculara yapılacak toplu taşıma seyahatini tanımlamak için tarifelerde ve tabelalarda görünen metin. Metin, bir hizmet günü içindeki bir geziyi benzersiz bir şekilde tanımlamalıdır. Örneğin, "538" San Jose, Kaliforniya'dan hafta içi 15:10'da Sacramento, Kaliforniya'ya giden Amtrak treninin tripShortText hattıdır.

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 için varış noktası hakkında bilgi.

arrivalTime

string (Timestamp format)

Adımın tahmini varış saati.

Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Ö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.

Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

TransitStop

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)

Enlem/boylam koordinatlarıyla ifade edilen durağın 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 biçiminde saat ve karşılık gelen saat dilimi.

departureTime

object (LocalizedTime)

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

LocalizedTime

Yerelleştirilmiş zaman 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 dilimi 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 transit operatörü (veya acenteleri).

name

string

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

uri

string

Transit operatörü tarafından sağlanan bu toplu taşıma hattına ait URI.

color

string

Bu çizginin tabelalarında yaygın olarak kullanılan renk. Onaltılı 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 normalde "M7" veya "355" gibi bir satır numarası olur.

textColor

string

Bu satırın tabelalarındaki metinde yaygın olarak kullanılan renk. Onaltılı olarak gösterilir.

vehicle

object (TransitVehicle)

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

TransitAgency

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

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

string

Bu transit operatörün adı.

phoneNumber

string

Transit operatörün yerel ayara özel biçimlendirilmiş telefon numarası.

uri

string

Transit operatörün URI'si.

TransitVehicle

Toplu taşıma rotalarında kullanılan bir araç hakkında 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 harfle).

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 tabelalarına göre bu araç türüyle ilişkili simgenin URI'si.

TransitVehicleType

Toplu taşıma güzergahları için kullanılan araçların türü.

Sıralamalar
TRANSIT_VEHICLE_TYPE_UNSPECIFIED Kullanılmayan.
BUS Otobüs.
CABLE_CAR Genellikle yerde, kabloyla çalışan bir araç. Teleferikler GONDOLA_LIFT türünde olabilir.
COMMUTER_TRAIN Banliyö treni.
FERRY Feribot.
FUNICULAR Kabloyla dik bir yokuştan çekilen araç. Füniküler genellikle iki arabadan oluşur ve her araba diğeri için karşı ağırlık görevi görür.
GONDOLA_LIFT Teleferik.
HEAVY_RAIL Ağır tren yolu.
HIGH_SPEED_TRAIN Hızlı tren.
INTERCITY_BUS Şehirler arası otobüs.
LONG_DISTANCE_TRAIN Şehirlerarası tren.
METRO_RAIL Hafif raylı toplu taşıma.
MONORAIL Monoray.
OTHER Diğer tüm araçlar.
RAIL Raylı sistem.
SHARE_TAXI Paylaşımlı taksi, güzergahın herhangi bir yerine yolcu alıp alma özelliğine sahip bir otobüs türüdür.
SUBWAY Hafif raylı sistem.
TRAM Yer üstü hafif raylı sistem.
TROLLEYBUS Troleybüs.

RouteLegTravelAdvisory

Kullanıcının bir adımda hakkı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 RouteLeg üzerindeki ücretli geçişlerle ilgili bilgileri içerir. Bu alan yalnızca RouteLeg üzerinde ücretli geçiş olmasını bekliyorsak doldurulur. Bu alan ayarlanır ancak estimatedPrice alt alanı doldurulmazsa yolun ücretli geçişler içermesini bekleriz ancak tahmini bir fiyat bilmiyoruz. Bu alan yoksa RouteLeg üzerinde ücretli geçiş yoktur.

speedReadingIntervals[]

object (SpeedReadingInterval)

Trafik yoğunluğunu ayrıntılı olarak veren hızlı okuma aralıkları. TRAFFIC_AWARE ve TRAFFIC_AWARE_OPTIMAL yönlendirme tercihleri için geçerlidir. Aralıklar, çakışma olmadan RouteLeg öğesinin çoklu çizgisinin tamamını kapsar. Belirtilen aralığın başlangıç noktası, kendisinden önce gelen aralığın bitiş noktasıyla aynı.

Örnek:

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

RouteLegLocalizedValues

Belirli mülklerin 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)

Metin biçiminde gösterilen ve trafik koşullarının dikkate alındığı süre. Not: Trafik bilgisi istemediyseniz bu değer staticDuration ile aynı olur.

staticDuration

object (LocalizedText)

Trafik koşullarının dikkate alınmadığı ve metin biçiminde gösterilen süre.

StepsOverview

RouteLegStep listeleri hakkında genel bakış bilgileri sağlar.

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

object (MultiModalSegment)

RouteLeg.steps'nin farklı çok modlu segmentleri hakkında özet bilgiler. RouteLeg adımlarda çok modlu segment içermiyorsa bu alan doldurulmaz.

MultiModalSegment

RouteLeg.steps öğesinin farklı çok modlu segmentleri hakkında özet bilgiler sağlar. Çok modlu segment, aynı RouteTravelMode değerine 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 puntonun çapraz olarak iki noktasıyla temsil edilen enlem-boylam görüntü alanı. Bir görüntü alanı, kapalı bir bölge olarak kabul edilir, yani sınırını içerir. Enlem sınırları -90 ile 90 derece dahil, boylam sınırları ise -180 ile 180 derece (bu değerler dahil) arasında olmalıdır. Bazı durumlar şunlardır:

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

  • low.longitude > high.longitude ise boylam aralığı ters ç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.

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

Hem low hem de high doldurulmalıdır ve temsil edilen kutu boş olamaz (yukarıdaki tanımlarda belirtildiği gibi). Boş görüntü alanı hataya neden olur.

Örneğin, bu görünüm 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 alçak noktası.

high

object (LatLng)

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

RouteLocalizedValues

Belirli mülklerin 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ın dikkate alındığı ve metin biçiminde gösterilen süre. Not: Trafik bilgisi istemediyseniz bu değer staticDuration ile aynı olur.

staticDuration

object (LocalizedText)

Trafik koşullarının dikkate alınmadığı ve 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 kodlamalı ara nokta.

destination

object (GeocodedWaypoint)

Coğrafi olarak kodlanan hedef ara nokta.

intermediates[]

object (GeocodedWaypoint)

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

GeocodedWaypoint

Ara nokta olarak kullanılan konumlarla ilgili ayrıntılar. Yalnızca adres ara noktaları için doldurulur. Adresin coğrafi kodlamasını belirlemek 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

Sıfır veya daha fazla tür etiketi biçimindeki sonucun türleri. Desteklenen türler: Adres türleri ve adres bileşeni türleri.

partialMatch

boolean

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

placeId

string

Bu sonuç için yer kimliği.

intermediateWaypointRequestIndex

integer

İstekteki ilgili ara ara noktanın dizini. Yalnızca ilgili ara nokta bir ara ara noktaysa doldurulur.