- HTTP isteği
- İstek metni
- Yanıt metni
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- Rota
- RouteLabel
- RouteLeg
- Çoklu çizgi
- RouteLegStep
- NavigationInstruction
- Maneuver
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment
- Görüntü alanı
- RouteLocalizedValues
- PolylineDetails
- FlyoverInfo
- RoadFeatureState
- PolylinePointIndex
- NarrowRoadInfo
- GeocodingResults
- GeocodedWaypoint
Bir dizi terminal ve ara yol noktası verildiğinde, isteğe bağlı alternatif rotalarla birlikte birincil rotayı döndürür.
NOT: Bu yöntemde, girişte bir yanıt alan maskesi belirtmeniz gerekir. 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 yolu listesidir. Alan yollarının nasıl oluşturulacağı hakkında ayrıntılı belgelere 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 alan maskesi (üretim kurulumu örneği):
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
Google, joker karakter (*
) yanıt alanı maskesinin kullanılmasını veya alan maskesinin en üst düzeyde (routes
) belirtilmesini önermez. Bunun nedeni:
- Yalnızca ihtiyacınız olan alanları seçmek, sunucumuzun hesaplama döngülerini kaydetmesine yardımcı olur. Bu sayede, sonucu size daha düşük gecikmeyle döndürebiliriz.
- Üretim işinizde yalnızca ihtiyacınız olan alanları seçmek, gecikme süresinin kararlı olmasını sağlar. Gelecekte daha fazla yanıt alanı ekleyebiliriz ve bu yeni alanlar ek hesaplama süresi gerektirebilir. Tüm alanları veya en üst düzeydeki tüm alanları seçerseniz eklediğimiz her yeni alan yanıta otomatik olarak dahil edileceğinden performans düşüşü yaşayabilirsiniz.
- Yalnızca ihtiyacınız olan alanları seçmek, yanıt boyutunun küçülmesini ve dolayısıyla ağ verimliliğinin artmasını sağlar.
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 ( |
Alanlar | |
---|---|
origin |
Zorunlu. Başlangıç ara noktası. |
destination |
Zorunlu. Hedef ara nokta. |
intermediates[] |
İsteğe bağlı. Rotadaki bir dizi ara nokta (terminal noktaları hariç), durmak veya geçmek için. En fazla 25 ara nokta desteklenir. |
travelMode |
İsteğe bağlı. Ulaşım şeklini belirtir. |
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 hataya veya çok uzun bir gecikmeye neden olursa hata döndürülür. Bu seçeneği yalnızca |
polylineQuality |
İsteğe bağlı. Çoklu çizginin kalitesiyle ilgili tercihinizi belirtir. |
polylineEncoding |
İsteğe bağlı. Çoklu çizgi için tercih edilen kodlamayı belirtir. |
departureTime |
İsteğe bağlı. Kalkış saati. Bu değeri ayarlamazsanız varsayılan olarak isteği gönderdiğiniz zaman kullanılır. NOT: Yalnızca Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat farkları da kabul edilir. Örnekler: |
arrivalTime |
İsteğe bağlı. Varış saati NOT: İsteklerde Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat farkları da kabul edilir. Örnekler: |
computeAlternativeRoutes |
İsteğe bağlı. Rotaya ek olarak alternatif rotaların da hesaplanıp hesaplanmayacağını belirtir. Ara yol noktaları olan istekler için alternatif rotalar döndürülmez. |
routeModifiers |
İsteğe bağlı. Rotaların hesaplanma şeklini etkileyen ve karşılanması gereken bir dizi koşul. |
languageCode |
İsteğe bağlı. BCP-47 dil kodu (ör. "en-US" veya "sr-Latn"). Daha fazla bilgi için Unicode Yerel Kimliği başlıklı makaleyi inceleyin. Desteklenen dillerin listesi için Dil Desteği'ne bakın. Bu değeri sağlamadığınızda, rota isteğinin konumundan ekran dili çıkarılır. |
regionCode |
İsteğe bağlı. Bölge kodu, ccTLD ("üst düzey alan") olarak belirtilen iki karakterlik bir değerdir. Daha fazla bilgi için Ülke kodu üst düzey alanları başlıklı makaleyi inceleyin. |
units |
İsteğe bağlı. Görüntüleme alanlarının ölçü birimlerini belirtir. Bu alanlar, |
optimizeWaypointOrder |
İsteğe bağlı. Doğru olarak ayarlanırsa hizmet, belirtilen ara yol noktalarını yeniden sıralayarak rotanın toplam maliyetini en aza indirmeye çalışır. Ara yol noktalarından herhangi biri |
requestedReferenceRoutes[] |
İ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 olan rotadır. Örneğin, |
extraComputations[] |
İ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ın yanıtta döndürülmek üzere alan maskesinde de belirtilmesi gerekir. |
trafficModel |
İsteğe bağlı. Trafikteki süreyi hesaplarken kullanılacak varsayımları belirtir. Bu ayar, |
transitPreferences |
İsteğe bağlı. |
Yanıt gövdesi
v2.computeRoutes yanıt mesajı.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{ "routes": [ { object ( |
Alanlar | |
---|---|
routes[] |
|
fallbackInfo |
Bazı durumlarda, sunucu rota sonuçlarını tüm giriş tercihlerine göre hesaplayamadığında farklı bir hesaplama yöntemi kullanabilir. Yedek mod kullanıldığında bu alan, yedek yanıtla ilgili ayrıntılı bilgileri içerir. Aksi takdirde bu alanın değeri belirlenmez. |
geocodingResults |
Adres olarak belirtilen ara noktalar için coğrafi kodlama yanıt bilgilerini içerir. |
PolylineQuality
Çoklu çizginin kalitesini belirten bir değerler grubu.
Sıralamalar | |
---|---|
POLYLINE_QUALITY_UNSPECIFIED |
Çoklu çizgi kalitesi tercihi belirtilmedi. Varsayılan olarak OVERVIEW değerine ayarlanır. |
HIGH_QUALITY |
Yanıt boyutunun artması pahasına OVERVIEW değerinden daha fazla nokta kullanılarak oluşturulan yüksek kaliteli bir çoklu ç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ış çoklu çizgisini belirtir. Rotanın genel görünümünü gösterirken bu değeri kullanın. Bu seçeneği kullanmak, HIGH_QUALITY seçeneğini kullanmaya kıyasla daha düşük istek gecikmesine sahiptir. |
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 çizgi belirtir. |
ReferenceRoute
ComputeRoutesRequest üzerinde desteklenen bir referans rota.
Sıralamalar | |
---|---|
REFERENCE_ROUTE_UNSPECIFIED |
Kullanılmaz. 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. Bu özellik,
Bu özellik, ara yol noktaları üzerinden veya |
ExtraComputation
İsteği tamamlarken gerçekleştirilecek ek hesaplamalar.
Sıralamalar | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
Kullanılmaz. Bu değeri içeren istekler başarısız olur. |
TOLLS |
Rotalar için ücret bilgileri. |
FUEL_CONSUMPTION |
Rotaların tahmini yakıt tüketimi. |
TRAFFIC_ON_POLYLINE |
Rotalar için trafik durumuna göre değişen çoklu çizgiler. |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstructions , biçimlendirilmiş bir HTML metin dizesi olarak sunulur. Bu içerik olduğu gibi okunmalıdır. Bu içerik yalnızca görüntüleme amaçlıdır. Programatik olarak ayrıştırmayın. |
FLYOVER_INFO_ON_POLYLINE |
Rotalar için üstten görünüm bilgileri. Bu bilgilerin döndürülmesi için routes.polyline_details.flyover_info fieldmask'inin belirtilmesi gerekir. Bu veriler şu anda yalnızca Hindistan'daki belirli metropoller için doldurulmaktadır. Bu özellik deneyseldir ve SKU/ücret değişebilir. |
NARROW_ROAD_INFO_ON_POLYLINE |
Rotalarla ilgili dar yol bilgileri. Bu bilgilerin döndürülmesi için routes.polyline_details.narrow_road_info fieldmask'inin belirtilmesi gerekir. Bu veriler şu anda yalnızca Hindistan'daki belirli metropoller için doldurulmaktadır. Bu özellik deneyseldir ve SKU/ücret değişebilir. |
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 ( |
Alanlar | |
---|---|
routeLabels[] |
Rotanın diğerleriyle karşılaştırılacak belirli özelliklerini tanımlamak için yararlı olan |
legs[] |
Rotayı oluşturan ayaklar (ara noktalar arasındaki yol segmentleri) koleksiyonu. Her aşama, iki |
distanceMeters |
Rotanın metre cinsinden seyahat mesafesi. |
duration |
Rotada gezinmek için gereken süre. En fazla dokuz kesirli basamak içeren ve " |
staticDuration |
Trafik koşulları dikkate alınmadan rotada seyahat süresi. En fazla dokuz kesirli basamak içeren ve " |
polyline |
Genel rota çoklu çizgisi. Bu çoklu çizgi, tüm |
description |
Rotanın açıklaması. |
warnings[] |
Rota gösterilirken gösterilecek uyarı dizisi. |
viewport |
Çoklu çizginin görüntü alanı sınırlayıcı kutusu. |
travelAdvisory |
Rota hakkında ek bilgiler. |
optimizedIntermediateWaypointIndex[] |
|
localizedValues |
|
routeToken |
Rotayı izleme sırasında rotayı yeniden oluşturmak için Navigation SDK'ya iletilebilen ve yeniden yönlendirme durumunda rota oluşturulurkenki orijinal amacı karşılayan 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, istekler arasında değerini karşılaştırmayın. NOT: |
polylineDetails |
Çoklu çizgi üzerindeki ayrıntılarla ilgili bilgileri içerir. |
RouteLabel
Rotanın diğerleriyle karşılaştırılacak belirli özelliklerini tanımlamak için yararlı olan
etiketleri.Route
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. 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 rotası. Bu, deneysel bir özelliktir. |
RouteLeg
via
olmayan yol noktaları arasında bir segment içerir.
JSON gösterimi |
---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
Alanlar | |
---|---|
distanceMeters |
Rota ayağının metre cinsinden seyahat mesafesi. |
duration |
Ayağın tamamlanması için gereken süre. En fazla dokuz kesirli basamak içeren ve " |
staticDuration |
Trafik koşulları dikkate alınmadan hesaplanan, segment boyunca seyahat süresi. En fazla dokuz kesirli basamak içeren ve " |
polyline |
Bu ayağın genel çoklu çizgisi, her |
startLocation |
Bu ayağın başlangıç konumu. Bu konum, sağlanan |
endLocation |
Bu ayağın bitiş konumu. Bu konum, sağlanan |
steps[] |
Bu ayaktaki segmentleri gösteren bir adımlar dizisi. Her adım bir gezinme talimatını temsil eder. |
travelAdvisory |
Kullanıcının bilgilendirilmesi gereken ek bilgileri (ör. bir rota ayağında olası trafik bölgesi kısıtlamaları) içerir. |
localizedValues |
|
stepsOverview |
Bu |
Çoklu çizgi
Kodlanmış bir çoklu çizgiyi kapsar.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birleştirme alanı polyline_type . Çoklu çizgi türünü kapsar. Varsayılan olarak encoded_polyline değerine ayarlanır. polyline_type yalnızca aşağıdakilerden biri olabilir: |
|
encodedPolyline |
Çoklu çizgi kodlama algoritması kullanılarak çoklu çizginin dize kodlaması |
geoJsonLinestring |
GeoJSON LineString biçimini kullanarak bir çoklu çizgi belirtir. |
RouteLegStep
segmenti içerir. Bir adım, tek bir navigasyon talimatına karşılık gelir. Rota ayakları adımlardan oluşur.RouteLeg
JSON gösterimi |
---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
Alanlar | |
---|---|
distanceMeters |
Bu adımın metre cinsinden seyahat mesafesi. Bazı durumlarda bu alanın değeri olmayabilir. |
staticDuration |
Trafik koşulları dikkate alınmadan bu adımda seyahat etme süresi. Bazı durumlarda bu alanın değeri olmayabilir. En fazla dokuz kesirli basamak içeren ve " |
polyline |
Bu adımla ilişkili çoklu çizgi. |
startLocation |
Bu adımın başlangıç konumu. |
endLocation |
Bu adımın bitiş konumu. |
navigationInstruction |
Navigasyon talimatları. |
travelAdvisory |
Bir ayak adımında, kullanıcının bilgilendirilmesi gereken ek bilgileri (ör. olası trafik bölgesi kısıtlamaları) içerir. |
localizedValues |
|
transitDetails |
Seyahat modu |
travelMode |
Bu adım için kullanılan ulaşım şekli. |
Maneuver
Mevcut adım için gerçekleştirilecek gezinme işlemini belirten bir değer grubu (örneğin, sola dön, birleş veya düz git).
Sıralamalar | |
---|---|
MANEUVER_UNSPECIFIED |
Kullanılmaz. |
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 |
Soldaki rampayı kullanın. |
RAMP_RIGHT |
Doğru rampayı kullanın. |
MERGE |
Trafiğe karışın. |
FORK_LEFT |
Soldaki çatala girin. |
FORK_RIGHT |
Sağdaki yolu seç. |
FERRY |
Feribota binin. |
FERRY_TRAIN |
Feribota giden 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 belirtmek için kullanılır. |
RouteLegStepTravelAdvisory
Kullanıcıya bildirilmesi gereken ek bilgileri (ör. bir ayak adımında olası trafik bölgesi kısıtlamaları) içerir.
JSON gösterimi |
---|
{
"speedReadingIntervals": [
{
object ( |
Alanlar | |
---|---|
speedReadingIntervals[] |
NOT: Bu alan şu anda doldurulmamıştır. |
RouteLegStepLocalizedValues
Belirli özelliklerin metin gösterimleri.
JSON gösterimi |
---|
{ "distance": { object ( |
Alanlar | |
---|---|
distance |
Metin biçiminde gösterilen seyahat mesafesi. |
staticDuration |
Trafik koşulları dikkate alınmadan hesaplanan ve metin biçiminde gösterilen süre. |
RouteLegStepTransitDetails
RouteLegStep
ile ilgili TRANSIT
rotaları hakkında ek bilgiler.
JSON gösterimi |
---|
{ "stopDetails": { object ( |
Alanlar | |
---|---|
stopDetails |
Adımın varış ve kalkış durakları hakkında bilgiler. |
localizedValues |
|
headsign |
Araçta veya kalkış durağında belirtildiği şekilde, bu hat üzerinde seyahat edilecek yönü belirtir. Yön genellikle son istasyondur. |
headway |
Beklenen süreyi, bu saatte aynı duraktan kalkışlar arasındaki süre olarak belirtir. Örneğin, 600 saniyelik bir aralık değeriyle otobüsünüzü kaçırmanız durumunda on dakika beklemeniz gerekir. En fazla dokuz kesirli basamak içeren ve " |
transitLine |
Bu adımda kullanılan toplu taşıma hattı hakkında bilgiler. |
stopCount |
Kalkış durağından varış durağına kadar olan durak sayısı. Bu sayıya varış durağı dahil edilir ancak kalkış durağı dahil edilmez. Örneğin, rotanız A durağından başlıyor, B ve C duraklarından geçiyor ve D durağına varıyorsa
3 değerini döndürür. |
tripShortText |
Yolculara toplu taşıma yolculuğunu tanımlamak için programlarda ve tabelalarda görünen metin. Metin, hizmet verilen bir gün içindeki bir geziyi benzersiz şekilde tanımlamalıdır. Örneğin, "538", hafta içi günlerde saat 15:10'da San Jose, Kaliforniya'dan Sacramento, Kaliforniya'ya hareket eden Amtrak treninin |
TransitStopDetails
RouteLegStep
için toplu taşıma duraklarıyla ilgili ayrıntılar.
JSON gösterimi |
---|
{ "arrivalStop": { object ( |