Route (beta)

Rota sınıfı

google.maps.routes.Route sınıf

Başlangıç, bitiş ve ara yol noktalarını birleştiren bir dizi bağlı yol segmentinden oluşan bir rota içerir.

const {Route} = await google.maps.importLibrary("routes") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
computeRoutes
computeRoutes(request)
Parametreler: 
İade Değeri:  Promise<{
  routes:Array<Route> optional,
  fallbackInfo:FallbackInfo optional,
  geocodingResults:GeocodingResults optional
}>
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, ComputeRoutesRequest.fields özelliğini ayarlayarak istekte bir yanıt alan maskesi belirtmeniz gerekir. Değer, alan yollarının listesidir.

Örneğin:
  • Kullanılabilir tüm alanların alan maskesi: fields: ['*']
  • Rota düzeyinde süre, mesafe ve yolun alan maskesi: fields: ['durationMillis', 'distanceMeters', 'path']

Joker karakter yanıt alanı maskesinin fields: ['*'] kullanılması şu nedenlerle önerilmez:
  • 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ı bir şekilde performans göstermesini sağlar. Gelecekte daha fazla yanıt alanı ekleyebiliriz ve bu yeni alanlar ek hesaplama süresi gerektirebilir. Tüm alanları veya ü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 daha küçük bir yanıt boyutu ve dolayısıyla ağ üzerinden daha hızlı yükleme sağlar.
description
Tür:  string optional
Rotanın açıklaması.
distanceMeters
Tür:  number optional
Rotanın metre cinsinden seyahat mesafesi.
durationMillis
Tür:  number optional
Rotada gezinmek için gereken süre (milisaniye). ComputeRoutesRequest.routingPreference öğesini TRAFFIC_UNAWARE olarak ayarlarsanız bu değer Route.staticDurationMillis ile aynı olur. ComputeRoutesRequest.routingPreference değerini TRAFFIC_AWARE veya TRAFFIC_AWARE_OPTIMAL olarak ayarlarsanız bu değer, trafik koşulları dikkate alınarak hesaplanır.

Not: Süre 2^53 milisaniyeyi aşarsa bu değer Number.POSITIVE_INFINITY olur.
legs
Tür:  Array<RouteLeg> optional
Rotayı oluşturan ayaklar (ara noktalar arasındaki yol segmentleri) koleksiyonu. Her aşama, iki via olmayan yol noktası arasındaki yolculuğa karşılık gelir.

Örneğin:
  • Ara yol noktası olmayan bir rotada yalnızca bir bölüm bulunur.
  • via olmayan bir ara nokta içeren bir rota iki etaptan oluşur.
  • Bir via ara yol noktası içeren rotanın bir ayağı vardır.
Rotaların sırası, origin'dan intermediates'ye ve destination'e kadar olan ara noktaların sırasıyla eşleşir.
localizedValues
Tür:  RouteLocalizedValues optional
Route özelliklerinin metin gösterimleri.
optimizedIntermediateWaypointIndices
Tür:  Array<number> optional
ComputeRoutesRequest.optimizeWaypointOrder değerini true olarak ayarlarsanız bu alan, ara yol noktalarının optimize edilmiş sıralamasını içerir. Aksi takdirde bu alan boş olur. Dizin, girişte sağlanan ilk ara yol noktası için 0 ile başlar.

Örneğin, şu girişi yaparsanız:
  • Kaynak: LA
  • Ara yol noktaları: Dallas, Bangor, Phoenix
  • Varış noktası: New York
ve optimize edilmiş ara nokta sırası Phoenix, Dallas, Bangor ise bu alan [2, 0, 1] olur.
path
Tür:  Array<LatLngAltitude> optional
Rota polylines'ı çizmek için kullanılabilecek rotanın LatLngAltitude listesi. Yolun ayrıntı düzeyi, ComputeRoutesRequest.polylineQuality ayarlanarak kontrol edilebilir.
polylineDetails
Tür:  PolylineDetails optional
Yol üzerindeki ayrıntılarla ilgili bilgileri içerir.
routeLabels
Tür:  Array<RouteLabel> optional
Rotanın, belirli özellikleri tanımlamak veya diğerleriyle karşılaştırmak için yararlı olan etiketleri.
routeToken
Tür:  string optional
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ı dikkate alan 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: routeToken yalnızca ComputeRoutesRequest.routingPreference değerinin TRAFFIC_AWARE veya TRAFFIC_AWARE_OPTIMAL olarak ayarlandığı istekler için kullanılabilir. via ara noktası olan isteklerde desteklenmez.
speedPaths
Tür:  Array<SpeedPath> optional
Rota yolunun bölümlerinin, ilgili hız okumalarıyla birlikte gruplandırılması. Bu alanın doldurulması için ComputeRoutesRequest.routingPreference, TRAFFIC_AWARE veya TRAFFIC_AWARE_OPTIMAL olarak ayarlanmalı ve ComputeRoutesRequest.extraComputations, TRAFFIC_ON_POLYLINE içermelidir.
staticDurationMillis
Tür:  number optional
Trafik koşulları dikkate alınmadan rotada seyahat etme süresi.

Not: Süre 2^53 milisaniyeyi aşarsa bu değer Number.POSITIVE_INFINITY olur.
travelAdvisory
Tür:  RouteTravelAdvisory optional
Rota hakkında ek bilgiler.
viewport
Tür:  LatLngBounds optional
Rotanın görüntü alanı sınırlayıcı kutusu.
warnings
Tür:  Array<string> optional
Rota gösterilirken gösterilecek uyarı dizisi.
createPolylines
createPolylines([options])
Parametreler: 
İade Değeri:  Array<Polyline>
Mevcut verilere göre rota için çoklu çizgiler oluşturur.

Çok formatlı çoklu çizgiler:
  • Gereksinimler:
  • Her çok formatlı rota segmenti için bir çoklu çizgi oluşturur. Çoklu çizgiler, segmentin seyahat moduna ve varsa toplu taşıma hattı verilerine göre şekillendirilir. Seçenekler, ulaşım şekline ve toplu taşıma hattına göre çoklu çizgi stilini değiştirmek için iletilebilir.

Trafik çoklu çizgileri:
  • Gereksinimler:
  • Hız okuması önceki aralıktan farklı olduğunda her rota aralığı için bir çoklu çizgi oluşturur. Çoklu çizgilerde varsayılan hıza dayalı stil uygulanır. Seçenekler, çoklu çizgi stilini hıza göre değiştirmek için iletilebilir.

Genel çoklu çizgi:
  • Gereksinimler:
  • Varsayılan stilin uygulandığı, rotanın tamamı için tek bir çoklu çizgi oluşturur. Seçenekler, rotanın ulaşım şekline göre çoklu çizgi stilini değiştirmek için iletilebilir. Daha fazla özelleştirme için doğrudan Route.path veya RouteLeg.path kullanarak çoklu çizgiler oluşturun.
createWaypointAdvancedMarkers
createWaypointAdvancedMarkers([options])
Parametreler: 
İade Değeri:  Promise<Array<AdvancedMarkerElement>>
Her bir ara nokta için rotada "A", "B", "C" vb. olarak etiketlenmiş işaretçiler oluşturur. İşaretçilere varsayılan stil uygulanır. Seçenekler, işaretçi dizinine veya ilgili RouteLeg özelliklerine göre işaretçi stilini değiştirmek için iletilebilir. Rotada etap yoksa WaypointMarkerDetails.leg parametresi tanımsız olur.

Ara yol noktalarının dahil edilmesi için "legs" alanı ComputeRoutesRequest.fields içinde istenmelidir.
toJSON
toJSON()
Parametreler: Yok
İade Değeri:  Object
Nesneye dönüştürür.

ComputeRoutesRequest arayüzü

google.maps.routes.ComputeRoutesRequest arayüz

Rota isteği
destination
Rotanın varış noktası. Dize olarak iletilen değer bir adres, artı kodu veya Yer kaynağı adı olabilir. Rotalar hesaplanırken yükseklik değerleri dikkate alınmaz.
fields
Tür:  Iterable<string>
Getirilecek alanların koleksiyonu. Tüm alanlar için ["*"] değerini belirtin.
origin
Rotanın başlangıç noktası. Dize olarak iletilen değer bir adres, artı kodu veya Yer kaynağı adı olabilir. Rotalar hesaplanırken yükseklik değerleri dikkate alınmaz.
arrivalTime optional
Tür:  Date optional
Varış saati

Not: Yalnızca ComputeRoutesRequest.travelMode, TRANSIT olarak ayarlandığında belirlenebilir. ComputeRoutesRequest.departureTime veya ComputeRoutesRequest.arrivalTime değerini belirtebilirsiniz ancak ikisini birden belirtemezsiniz. Toplu taşıma yolculukları, geçmişte 7 güne veya gelecekte 100 güne kadar kullanılabilir.
computeAlternativeRoutes optional
Tür:  boolean optional
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.
departureTime optional
Tür:  Date optional
Kalkış saati. Bu değeri ayarlamazsanız varsayılan olarak isteği gönderdiğiniz zaman kullanılır.

Not: Yalnızca ComputeRoutesRequest.travelMode TRANSIT olarak ayarlandığında geçmiş bir zaman belirtebilirsiniz. Toplu taşıma yolculukları, geçmişte 7 güne veya gelecekte 100 güne kadar kullanılabilir.
extraComputations optional
İ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ülmesi için ComputeRoutesRequest.fields içinde de belirtilmesi gerekir.
intermediates optional
Tür:  Iterable<Waypoint> optional
Rotadaki bir dizi ara nokta (terminal noktaları hariç), durmak veya geçmek için. En fazla 25 ara nokta desteklenir.
language optional
Tür:  string optional
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 dil, Google Maps JavaScript API yerelleştirme ayarlarınızdan çıkarılır. Aksi takdirde dil, kaynağın konumundan çıkarılır.
optimizeWaypointOrder optional
Tür:  boolean optional
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 "aracılığıyla" yol noktasıysa istek başarısız olur. Yeni sıralamayı bulmak için yanıtta Route.optimizedIntermediateWaypointIndices kullanın. ComputeRoutesRequest.fields içinde "optimizedIntermediateWaypointIndices" istenmezse istek başarısız olur. Yanlış olarak ayarlanırsa yanıttaki Route.optimizedIntermediateWaypointIndices boş olur.
polylineQuality optional
Tür:  PolylineQuality optional
Çoklu çizginin kalitesiyle ilgili tercihi belirtir.
region optional
Tür:  string optional
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. Bu değeri sağlamadığınızda bölge, Google Maps JavaScript API yerelleştirme ayarlarınızdan çıkarılır. Aksi takdirde bölge, kaynağın konumundan çıkarılır.
requestedReferenceRoutes optional
Tür:  Iterable<ReferenceRoute> optional
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, FUEL_EFFICIENT referans rota hesaplaması, yakıt açısından verimli bir rota oluşturacak çeşitli parametreleri dikkate alır. Bu özelliği kullanırken sonuç rotalarda Route.routeLabels simgesini bulun.
routeModifiers optional
Tür:  RouteModifiers optional
Rotaların hesaplanma şeklini etkileyen ve karşılanması gereken bir dizi koşul. Örneğin, ücretli geçişler veya otoyollar gibi kaçınılması gereken özellikleri belirtebilirsiniz.
routingPreference optional
Tür:  RoutingPreference optional
Rotanın nasıl hesaplanacağını belirtir. Sunucu, rotayı hesaplamak için seçilen yönlendirme tercihini kullanmaya çalışır. Yönlendirme tercihi hata veya çok uzun gecikmeye neden olursa hata döndürülür. Bu seçeneği yalnızca ComputeRoutesRequest.travelMode DRIVING veya TWO_WHEELER olduğunda belirtebilirsiniz. Aksi takdirde istek başarısız olur.
trafficModel optional
Tür:  TrafficModel optional
Trafikteki süreyi hesaplarken kullanılacak varsayımları belirtir. Bu ayar, geçmiş ortalamalara göre trafikteki tahmini süreyi içeren Route.durationMillis ve RouteLeg.durationMillis değerlerini etkiler. ComputeRoutesRequest.trafficModel yalnızca ComputeRoutesRequest.routingPreference değerinin TRAFFIC_AWARE_OPTIMAL, ComputeRoutesRequest.travelMode değerinin ise DRIVING olarak ayarlandığı istekler için kullanılabilir. Varsayılan olarak BEST_GUESS değerine ayarlanır.
transitPreference optional
Tür:  TransitPreference optional
TRANSIT rotaları için döndürülen rotayı etkileyen tercihleri belirtir.

Not: Yalnızca ComputeRoutesRequest.travelMode, TRANSIT olarak ayarlandığında belirtilebilir.
travelMode optional
Tür:  TravelMode optional
Ulaşım şeklini belirtir.
units optional
Tür:  UnitSystem optional
Gezinme talimatları gibi görüntüleme alanlarının ölçü birimlerini belirtir. Rota, ayak, 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, kaynağın konumundan çıkarılır.

ComputeRoutesExtraComputation sabitleri

google.maps.routes.ComputeRoutesExtraComputation sabitler

Route.computeRoutes isteği için gerçekleştirilecek ek hesaplamalar.

const {ComputeRoutesExtraComputation} = await google.maps.importLibrary("routes") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
FLYOVER_INFO_ON_POLYLINE Rotalar için üstten görünüm bilgileri. Bu bilgilerin döndürülmesi için "polylineDetails" alanı ComputeRoutesRequest.fields içinde belirtilmelidir. Bu veriler şu anda yalnızca Hindistan'daki belirli metropoller için doldurulmaktadır. Bu özellik deneyseldir ve SKU/ücret değişebilir.
FUEL_CONSUMPTION Rotaların tahmini yakıt tüketimi.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS Biçimlendirilmiş bir HTML metin dizesi olarak sunulan navigasyon talimatları. Bu içerik olduğu gibi okunmak üzere hazırlanmıştır ve yalnızca görüntüleme amaçlıdır. Programatik olarak ayrıştırmayın.
NARROW_ROAD_INFO_ON_POLYLINE Rotalarla ilgili dar yol bilgileri. Bu bilgilerin döndürülmesi için "polylineDetails" alanı ComputeRoutesRequest.fields içinde belirtilmelidir. Bu veriler şu anda yalnızca Hindistan'daki belirli metropoller için doldurulmaktadır. Bu özellik deneyseldir ve SKU/ücret değişebilir.
TOLLS Rotalar için ücret bilgileri.
TRAFFIC_ON_POLYLINE Rotalar için trafik durumuna göre değişen çoklu çizgiler.

DirectionalLocationLiteral arayüzü

google.maps.routes.DirectionalLocationLiteral arayüz

Kolaylık sağlamak için DirectionalLocation örnekleri yerine nesne değişmezleri kabul edilir. Bunlar, Maps JS API tarafından karşılaşıldığında DirectionalLocation olarak dönüştürülür.

Bu arayüz, LatLngAltitudeLiteral arayüzünü genişletir.

heading optional
Tür:  number optional
Trafiğin akış yönüyle ilişkili pusula yönü. Başlık değerleri 0 ile 360 arasında sayılar olabilir. 0 değeri tam kuzey, 90 değeri tam doğu yönünü belirtir. Bu alanı yalnızca DRIVING ve TWO_WHEELER ComputeRoutesRequest.travelMode için kullanabilirsiniz.
Devralınan: altitude, lat, lng

DirectionalLocation class

google.maps.routes.DirectionalLocation sınıf

Bir coğrafi noktayı ve isteğe bağlı bir başlığı kapsar.

Bu sınıfın süresi LatLngAltitude tarihinde sona eriyor.

Bu sınıf DirectionalLocationLiteral öğesini uygular.

const {DirectionalLocation} = await google.maps.importLibrary("routes") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
Devralınan: LatLngAltitude
heading
Tür:  number optional
Trafiğin akış yönüyle ilişkili pusula yönü. Başlık değerleri 0 ile 360 arasında sayılar olabilir. 0 değeri tam kuzey, 90 değeri tam doğu yönünü belirtir. Bu alanı yalnızca DRIVING ve TWO_WHEELER ComputeRoutesRequest.travelMode için kullanabilirsiniz.
Devralınan: altitude, lat, lng
toJSON
toJSON()
Parametreler: Yok
İade Değeri:  DirectionalLocationLiteral
Nesneye dönüştürür.
Devralınan: equals

FallbackInfo class

google.maps.routes.FallbackInfo sınıf

Bir Route.computeRoutes yanıtında yedek sonucun nasıl ve neden kullanıldığıyla ilgili bilgiler. Bu alan ayarlanırsa sunucunun, geri dönüş olarak tercih ettiğiniz moddan farklı bir yönlendirme modu kullandığı anlamına gelir.

const {FallbackInfo} = await google.maps.importLibrary("routes") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
reason
Tür:  FallbackReason optional
Orijinal yanıt yerine yedek yanıtın kullanılmasının nedeni. Bu alan yalnızca yedek mod tetiklendiğinde ve yedek yanıt döndürüldüğünde doldurulur.
routingMode
Tür:  FallbackRoutingMode optional
Yanıt için kullanılan yönlendirme modu. Yedekleme tetiklendiyse mod, orijinal istemci isteğinde ayarlanan yönlendirme tercihinden farklı olabilir.

FallbackReason sabitleri

google.maps.routes.FallbackReason sabitler

Route.computeRoutes yanıtında yedek yanıt döndürülmesinin nedeni.

const {FallbackReason} = await google.maps.importLibrary("routes") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
LATENCY_EXCEEDED Tercih ettiğiniz rota modunda hesaplama zamanında tamamlanamadı ancak alternatif bir modda hesaplanan sonuç döndürüldü.
SERVER_ERROR Tercih ettiğiniz yönlendirme moduyla rotalar hesaplanırken bir sunucu hatası oluştu ancak alternatif bir modla hesaplanan bir sonuç döndürebildik.

FallbackRoutingMode sabitleri

google.maps.routes.FallbackRoutingMode sabitler

Route.computeRoutes yanıtında yedek yanıt döndürüldüğünde kullanılan gerçek yönlendirme modu.

const {FallbackRoutingMode} = await google.maps.importLibrary("routes") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
TRAFFIC_AWARE Yanıtı hesaplamak için TRAFFIC_AWARE RoutingPreference kullanıldığını gösterir.
TRAFFIC_UNAWARE Yanıtı hesaplamak için TRAFFIC_UNAWARE RoutingPreference kullanıldığını gösterir.

GeocodedWaypoint sınıfı

google.maps.routes.GeocodedWaypoint sınıf

Ara nokta olarak kullanılan konumlarla ilgili coğrafi kodlama. Yalnızca adres yol noktaları için doldurulur. Adresin hangi coğrafi konuma göre kodlandığını belirlemek için coğrafi kodlama sonuçlarıyla ilgili ayrıntıları içerir.

const {GeocodedWaypoint} = await google.maps.importLibrary("routes") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
geocoderStatus
Tür:  RPCStatus optional
Coğrafi kodlama işleminden kaynaklanan durum kodunu gösterir.
intermediateWaypointRequestIndex
Tür:  number optional
İstekteki ilgili ara yol noktasının dizini. Yalnızca ilgili ara nokta bir ara nokta ise doldurulur.
partialMatch
Tür:  boolean
Kodlayıcının, istenen adresin bir kısmını eşleştirebilmesine rağmen orijinal istek için tam eşleşme döndürmediğini gösterir. Yazım hataları ve/veya eksik adres olup olmadığını görmek için orijinal isteği inceleyebilirsiniz.
placeId
Tür:  string
Bu sonucun yer kimliği.
types
Tür: