Method: computeRoutes

Bir dizi terminal ve ara yol noktası verildiğinde, birincil rotayı ve isteğe bağlı alternatif rotaları 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 ü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 yolları listesidir. Alan yollarının nasıl oluşturulacağı hakkında ayrıntılı dokümanları inceleyin.

Örneğin, bu yöntemde:

  • Kullanılabilir tüm alanların alan maskesi (manuel inceleme için): X-Goog-FieldMask: *
  • Rota düzeyinde süre, mesafe ve poli ç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:

  • Yalnızca ihtiyacınız olan alanları seçmek, sunucumuzun hesaplama döngülerinde tasarruf etmesine yardımcı olur. Bu da sonucu size daha düşük gecikmeli olarak döndürmemize olanak tanır.
  • Üretim işinizde yalnızca ihtiyacınız olan alanları seçmek, kararlı bir gecikme performansı sağlar. Gelecekte daha fazla yanıt alanı ekleyebiliriz ve bu yeni alanlar için ek hesaplama süresi gerekebilir. Tüm alanları veya üst düzeydeki tüm alanları seçerseniz ekleyeceğimiz yeni alanlar yanıta otomatik olarak dahil edileceğinden performansta düşüş yaşayabilirsiniz.
  • Yalnızca ihtiyacınız olan alanları seçmek, yanıt boyutunun küçülmesine ve dolayısıyla ağ aktarım hızının artmasına neden olur.

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 yol noktası.

intermediates[]

object (Waypoint)

İsteğe bağlı. Rota üzerinde, duraklamak veya geçmek için bir dizi yol noktası (terminal 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, rotayı hesaplamak için seçilen yönlendirme tercihini kullanmaya çalışır. Yönlendirme tercihi bir hatayla veya aşırı uzun bir 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ı. Poli çizginin kalitesiyle ilgili tercihinizi belirtir.

polylineEncoding

enum (PolylineEncoding)

İsteğe bağlı. Poli ç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 saat kullanılır. NOT: Yalnızca RouteTravelMode, TRANSIT olarak ayarlandığında geçmişte bir departureTime belirtebilirsiniz. Toplu taşıma gezileri, geçmişte 7 güne kadar veya gelecekte 100 güne kadar kullanılabilir.

Nanosaniye çözünürlüğüne ve en fazla dokuz kesirli basamağa sahip, 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 ayarlanabilir. departureTime ve arrivalTime ikilisinden birini belirtin; ikisini birden belirtmeyin. Toplu taşıma gezileri, geçmişte 7 güne kadar veya gelecekte 100 güne kadar kullanılabilir.

Nanosaniye çözünürlüğüne ve en fazla dokuz kesirli basamağa sahip, 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 yol işaretleri içeren istekler için alternatif rota döndürülmez.

routeModifiers

object (RouteModifiers)

İsteğe bağlı. Yolların hesaplanma şeklini etkileyen ve karşılanması gereken bir dizi koşul.

languageCode

string

İsteğe bağlı. BCP-47 dil kodu ("en-US" veya "sr-Latn" gibi). Daha fazla bilgi için Unicode Yerel Ayarı Tanımlayıcısı başlıklı makaleyi inceleyin. Desteklenen dillerin listesi için Dil desteği bölümüne bakın. Bu değeri sağlamadığınızda ekran dili, rota isteğinin konumundan anlaşılır.

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österge alanları için ölçü birimlerini belirtir. Bu alanlar, NavigationInstruction içindeki instruction alanını içerir. Rota, etap, 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 türetilir.

optimizeWaypointOrder

boolean

İsteğe bağlı. Doğru olarak ayarlanırsa hizmet, belirtilen ara yol işaretlerini yeniden düzenleyerek rotanın toplam maliyetini en aza indirmeye çalışır. Ara yol işaretçilerinden herhangi biri via yol işaretçisi ise istek başarısız olur. Yeni sıralamayı bulmak için ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index simgesini kullanın. X-Goog-FieldMask üstbilgisinde ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index 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 bir rotadır. Örneğin, FUEL_EFFICIENT referans rota hesaplaması, en uygun yakıt tasarruflu rotayı oluşturacak çeşitli parametreleri hesaba katar. Bu özelliği kullanırken, bulunan rotalarda routeLabels simgesini arayın.

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, yanıtta döndürülecek şekilde alan maskesinde de belirtilmelidir.

trafficModel

enum (TrafficModel)

İsteğe bağlı. Trafikte geçirilen süreyi hesaplarken kullanılacak varsayımları belirtir. Bu ayar, geçmiş ortalamalara göre trafikte tahmini süreyi içeren Route ve RouteLeg öğelerindeki duration alanında döndürülen değeri etkiler. TrafficModel yalnızca RoutingPreference'u TRAFFIC_AWARE_OPTIMAL ve RouteTravelModeDRIVE olarak ayarlayan istekler için kullanılabilir. Trafik istenirse 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 transitPreferences belirtebilirsiniz.

Yanıt gövdesi

v2.computeRoutes, yanıt mesajını oluşturur.

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 hesaplanan rotalar dizisi (en fazla üç) içerir. Aksi takdirde yalnızca bir rota içerir. Bu dizi birden fazla giriş içeriyorsa ilk giriş en çok önerilen rotadır. Dizi boşsa rota bulunamadı demektir.

fallbackInfo

object (FallbackInfo)

Sunucu, rota sonuçlarını tüm giriş tercihleriyle hesaplayamadığında farklı bir hesaplama yöntemi kullanabilir. Yedek modu kullanıldığında bu alan, yedek yanıtla ilgili ayrıntılı bilgi içerir. Aksi takdirde bu alanın değeri belirlenmez.

geocodingResults

object (GeocodingResults)

Adres olarak belirtilen yol işaretleri için coğrafi kodlama yanıt bilgilerini içerir.

PolylineQuality

Poli çizginin kalitesini belirten bir değer kümesi.

Sıralamalar
POLYLINE_QUALITY_UNSPECIFIED Poli çizgi kalitesi tercihi belirtilmedi. Varsayılan olarak OVERVIEW değerine ayarlanır.
HIGH_QUALITY Yanıt boyutunun artması pahasına OVERVIEW'ten daha fazla nokta kullanılarak oluşturulan yüksek kaliteli bir çok ç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ış poli çizgisini belirtir. Rotaya genel bakış gösterilirken bu değeri kullanın. Bu seçenek, HIGH_QUALITY seçeneğine kıyasla daha düşük istek gecikmesi sunar.

PolylineEncoding

Döndürülecek tercih edilen çoklu çizgi türünü belirtir.

Sıralamalar
POLYLINE_ENCODING_UNSPECIFIED Poli çizgi türü tercihi belirtilmedi. Varsayılan olarak ENCODED_POLYLINE değerine ayarlanır.
ENCODED_POLYLINE Poli çizgisi kodlama algoritması kullanılarak kodlanmış bir poli çizgiyi belirtir.
GEO_JSON_LINESTRING GeoJSON LineString biçimini kullanarak bir çok çizgi belirtir.

ReferenceRoute

ComputeRoutesRequest üzerinde desteklenen bir referans rotası.

Sıralamalar
REFERENCE_ROUTE_UNSPECIFIED Kullanılmadı. 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.

DRIVE istekleri için bu özellik, sürüş konforuna göre daha kısa mesafeye öncelik verir. Örneğin, otoyollar yerine yerel yolları tercih edebilir, toprak yollardan geçebilir, otoparklardan kestirebilir. Bu özellik, Google Haritalar'ın yasa dışı olduğunu bildiği hiçbir manevrayı döndürmez.

BICYCLE ve TWO_WHEELER istekleri için bu özellik, requestedReferenceRoutes belirtmediğiniz durumlarda döndürülen rotalara benzer rotalar döndürür.

Bu özellik, ara yol noktaları veya optimizeWaypointOrder üzerinden 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 yapılacak ek hesaplamalar.

Sıralamalar
EXTRA_COMPUTATION_UNSPECIFIED Kullanılmadı. 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 trafik bilinçli çoklu çizgiler.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions biçimlendirilmiş HTML metin dizesi olarak sunulur. Bu içerik olduğu gibi okunmak üzere tasarlanmıştır. Bu içerik yalnızca görüntüleme amaçlıdır. Programlı olarak ayrıştırmayın.

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
}
Alanlar
routeLabels[]

enum (RouteLabel)

Route için, rotanın diğerleriyle karşılaştırılacak belirli özelliklerini tanımlamak için yararlı olan etiketler.

legs[]

object (RouteLeg)

Rotayı oluşturan yol segmentleri (ara noktalar arasındaki yol segmentleri) koleksiyonu. Her aşama, via olmayan iki Waypoints 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 yol noktası içeren rotanın iki bacağı vardır. Bir via ara yol noktası içeren rotanın bir ayağı vardır. Parkurların sırası, origin'ten intermediates'e ve destination'ye giden 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 öğesini TRAFFIC_UNAWARE olarak ayarlarsanız bu değer staticDuration ile aynıdır. 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 rotadaki 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'lerin birleştirilmiş çoklu çizgisidir.

description

string

Rotayı açıklayan bir metin.

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 doğru olarak ayarlarsanız bu alan, ara yol işaretlerinin optimize edilmiş sırasını içerir. Aksi takdirde bu alan boş bırakılır. Örneğin, Başlangıç: İstanbul; Ara yol işaretleri: Ankara, İzmir, Antalya; Varış noktası: Ankara şeklinde bir giriş yaparsanız ve optimize edilmiş ara yol işareti sırası Ankara, İzmir, Antalya 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 temsilleri.

routeToken

string

Navigasyon sırasında rotayı yeniden oluşturmak ve yeniden yönlendirme durumunda rotanın oluşturulduğu orijinal amacı dikkate almak için Navigation SDK'ya iletilebilecek 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, değerini istekler arasında karşılaştırmayın.

NOT: Route.route_token yalnızca ComputeRoutesRequest.routing_preference parametresi TRAFFIC_AWARE veya TRAFFIC_AWARE_OPTIMAL olarak ayarlanmış isteklerde kullanılabilir. Route.route_token, Via yol işaretleri içeren istekler için desteklenmez.

RouteLabel

Route için, rotanın diğerleriyle karşılaştırılacak belirli özelliklerini tanımlamak için yararlı olan etiketler.

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 olan rota. Bu, deneysel bir özelliktir.

RouteLeg

via olmayan yol işaretleri 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 adımını oluşturan seyahat mesafesi (metre cinsinden).

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ıdır. route_preference 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, yol 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)

Her step'nin çoklu çizgisini içeren bu bacak için genel çoklu çizgi.

startLocation

object (Location)

Bu etabın başlangıç konumu. Bu konum, sağlanan origin adresinden 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 konum, sağlanan destination adresinden farklı olabilir. Örneğin, sağlanan destination bir yolun yakınında değilse bu, yoldaki 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)

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

localizedValues

object (RouteLegLocalizedValues)

RouteLeg özelliklerinin metin temsilleri.

stepsOverview

object (StepsOverview)

Bu RouteLeg'teki adımlarla ilgili genel bilgiler. Bu alan yalnızca TOPLU TAŞIMA rotaları için doldurulur.

Çoklu çizgi

Kodlanmış bir çoklu çizgiyi kapsüller.

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
Birlik alanı polyline_type. Çoklu çizginin türünü kapsar. Varsayılan olarak encoded_polyline değerine ayarlanır. polyline_type yalnızca aşağıdakilerden biri olabilir:
encodedPolyline

string

Poli çizgisi kodlama algoritması kullanılarak poli çizgisinin dize kodlaması

geoJsonLinestring

object (Struct format)

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

RouteLegStep

RouteLeg segmenti içerir. 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)
  },
  "localizedValues": {
    object (RouteLegStepLocalizedValues)
  },
  "transitDetails": {
    object (RouteLegStepTransitDetails)
  },
  "travelMode": enum (RouteTravelMode)
}
Alanlar
distanceMeters

integer

Bu adımın kat edilen mesafesi (metre cinsinden). Bazı durumlarda bu alanın değeri olmayabilir.

staticDuration

string (Duration format)

Trafik koşulları dikkate alınmadan bu adımda seyahat 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)

Gezinme talimatları.

travelAdvisory

object (RouteLegStepTravelAdvisory)

Bir yol adımında kullanıcıya bildirilmesi gereken ek bilgileri (ör. olası trafik bölgesi kısıtlamaları) içerir.

localizedValues

object (RouteLegStepLocalizedValues)

RouteLegStep özelliklerinin metin temsilleri.

transitDetails

object (RouteLegStepTransitDetails)

Seyahat modu TRANSIT ise bu adımla ilgili ayrıntılar.

travelMode

enum (RouteTravelMode)

Bu adımda kullanılan ulaşım şekli.

Manevra

Mevcut adım için yapılacak gezinme işlemini (ör. sola dön, birleş veya düz git) belirten bir değer kümesi.

Sıralamalar
MANEUVER_UNSPECIFIED Kullanılmadı.
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 Sol rampadan gidin.
RAMP_RIGHT Sağ rampaya girin.
MERGE Trafik akışı ile birleşin.
FORK_LEFT Sol çataldan gidin.
FORK_RIGHT Sağ çataldan gidin.
FERRY Feribota binin.
FERRY_TRAIN Feribota giden trene binin.
ROUNDABOUT_LEFT Dönel kavşakta sola dönün.
ROUNDABOUT_RIGHT Dönel kavşakta sağa dönün.
DEPART İlk manevra.
NAME_CHANGE Cadde adı değişikliğini belirtmek için kullanılır.

RouteLegStepTravelAdvisory

Bir yol adımı üzerindeki 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 doldurulmamıştı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 hesaplanan ve metin biçiminde gösterilen süre.

RouteLegStepTransitDetails

TRANSIT rotalarıyla ilgili RouteLegStep için 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ıyla ilgili bilgiler.

localizedValues

object (TransitDetailsLocalizedValues)

RouteLegStepTransitDetails özelliklerinin metin temsilleri.

headsign

string

Araç üzerinde veya kalkış durağında belirtildiği şekilde, bu hatta seyahat edilecek yönü belirtir. Yön genellikle son duraktır.

headway

string (Duration format)

Bu saatte aynı duraktan yapılan kalkışlar arasındaki süre olarak beklenen zamanı belirtir. Örneğin, 600 saniyelik bir sefer aralığı değeriyle, otobüsünüz kaçırırsanız 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 bilgi.

stopCount

integer

Kalkış durağından varış duraklarına kadar olan durak sayısı. Bu sayıya varış durağı dahildir ancak kalkış durağı hariçtir. Örneğin, rotanız A durağından kalkı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 sefer tarifelerinde 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", hafta içi saat 15:10'da San Jose, CA'dan Sacramento, CA'ya giden Amtrak treninin tripShortText'sidir.

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ğı hakkında bilgi.

arrivalTime

string (Timestamp format)

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

Nanosaniye çözünürlüğüne ve en fazla dokuz kesirli basamağa sahip, 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ış durağı hakkında bilgi.

departureTime

string (Timestamp format)

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

Nanosaniye çözünürlüğüne ve en fazla dokuz kesirli basamağa sahip, 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)

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

TransitDetailsLocalizedValues

RouteTransitDetails değerlerinin yerelleştirilmiş açıklamaları.

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

object (LocalizedTime)

Saat, ilgili saat dilimiyle birlikte biçimlendirilmiş metin temsilinde.

departureTime

object (LocalizedTime)

Saat, ilgili saat dilimiyle birlikte biçimlendirilmiş metin temsilinde.

LocalizedTime

Yerelleştirilmiş saat 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ı. Örneğin, "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. On altı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 bir satır numarası olur (ör. "M7" veya "355").

textColor

string

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

vehicle

object (TransitVehicle)

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

TransitAgency

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

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

string

Bu toplu taşıma işletmesinin adı.

phoneNumber

string

Toplu taşıma acentesinin yerel ayara özel biçimlendirilmiş telefon numarası.

uri

string

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

TransitVehicle

Toplu taşıma rotalarında kullanılan bir 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.

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 rotalarındaki araç türü.

Sıralamalar
TRANSIT_VEHICLE_TYPE_UNSPECIFIED Kullanılmamış.
BUS Otobüs.
CABLE_CAR Genellikle yerde kabloyla çalışan bir araç. Teleferikler GONDOLA_LIFT türü olabilir.
COMMUTER_TRAIN Banliyö treni.
FERRY Feribot.
FUNICULAR Dik yokuşları kabloyla yukarı çekilen araç. Teleferik genellikle iki arabadan oluşur ve her araba diğerine karşı ağırlık görevi görür.
GONDOLA_LIFT Teleferik.
HEAVY_RAIL Ağır raylı sistem.
HIGH_SPEED_TRAIN Yüksek hızlı tren.
INTERCITY_BUS Şehirlerarası otobüs.
LONG_DISTANCE_TRAIN Uzun mesafeli tren.
METRO_RAIL Hafif raylı sistem.
MONORAIL Monoray.
OTHER Diğer tüm araçlar.
RAIL Demiryolu.
SHARE_TAXI Paylaşılan taksi, güzergahındaki herhangi bir yerde yolcu alıp bırakabilen 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 yol adımı sırası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 geçiş ücreti olduğunu varsayarsak 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ı olarak gösteren hız 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).

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)

Metin biçiminde gösterilen ve sorgunun bulunduğu bölgeye göre yerelleştirilen süre. Trafik koşullarını dikkate alır. Not: Trafik bilgileri istemediyseniz bu değer, staticDuration ile aynıdır.

staticDuration

object (LocalizedText)

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

StepsOverview

RouteLegStep listesi hakkında genel bilgiler sağlar.

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

object (MultiModalSegment)

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

MultiModalSegment

RouteLeg.steps'ün 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 NavigationInstruction.

travelMode

enum (RouteTravelMode)

Çok modlu segmentin ulaşım şekli.

stepStartIndex

integer

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

stepEndIndex

integer

Çok modlu bir segmentin sonu olan ilgili RouteLegStep dizini.

Görüntü alanı

Çapraz olarak karşı karşıya iki low ve high noktası olarak gösterilen bir enlem-boylam görüntü alanı. Görüntü alanı kapalı bir bölge olarak kabul edilir. Yani görüntü alanı, sınırını içerir. Enlem sınırları -90 ile 90 derece (dahil) arasında, boylam sınırları ise -180 ile 180 derece (dahil) arasında olmalıdır. Bu tür durumlara örnek olarak şunlar verilebilir:

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

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

  • 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ş bir görüntü alanı hataya neden olur.

Örneğin, bu görüntü alanı New York'u tamamen kapsıyor:

{ "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 alt noktası.

high

object (LatLng)

Zorunlu. Görüntü alanının en 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)

Metin biçiminde gösterilen ve sorgunun bulunduğu bölgeye göre yerelleştirilen süre. Trafik koşullarını dikkate alır. Not: Trafik bilgileri isteğinde bulunmadıysanız bu değer staticDuration ile aynıdır.

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.

GeocodingResults

Başlangıç, hedef ve ara yol işaretleri 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)

Coğrafi kodlanmış başlangıç noktası.

destination

object (GeocodedWaypoint)

Coğrafi kodlanmış hedef yol noktası.

intermediates[]

object (GeocodedWaypoint)

Her biri, istekte belirtildikleri sırada yol işaretinin sıfır tabanlı konumuna karşılık gelen bir dizin alanı içeren, coğrafi olarak kodlanmış ara yol işaretlerinin listesi.

GeocodedWaypoint

Dönüm noktası olarak kullanılan konumlarla ilgili ayrıntılar. Yalnızca adres yol işaretleri için doldurulur. Adresin coğrafi kodlamanın hangi konuma göre yapıldığı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 belirtir.

type[]

string

Sonuç 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ı, istenen adresin bir kısmını eşleştirebilmesine rağmen orijinal istek için tam eşleşme döndürmedi. Orijinal isteği yazım hataları ve/veya eksik adres olup olmadığını kontrol etmek isteyebilirsiniz.

placeId

string

Bu sonucun yer kimliği.

intermediateWaypointRequestIndex

integer

İstekteki ilgili ara yol noktasının dizini. Yalnızca ilgili yol noktası ara yol noktasıysa doldurulur.