Route Matrix

RouteMatrix sınıfı

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

RouteMatrix.computeRouteMatrix tarafından bir dizi başlangıç/varış noktası çifti için hesaplanan rotaların matrisi

const {RouteMatrix} = await google.maps.importLibrary("routes") numarasını arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
computeRouteMatrix
computeRouteMatrix(request)
Parametreler: 
Dönüş Değeri:  Promise<{matrix:RouteMatrix}>
Başlangıç ve varış noktalarının listesini alır ve her başlangıç ve varış noktası kombinasyonu için rota bilgilerini içeren bir matris döndürür.

Not: Bu yöntem, ComputeRouteMatrixRequest.fields özelliğini ayarlayarak istekte bir yanıt alanı maskesi belirtmenizi gerektirir. Değer, alan yollarının bir listesidir.

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

Joker karakter yanıt alanı maskesi fields: ['*'] kullanımı şu nedenlerle önerilmez:
  • Yalnızca ihtiyacınız olan alanları seçmek, sunucumuzun hesaplama döngülerinden tasarruf etmesine yardımcı olur ve sonucu size daha düşük bir gecikmeyle döndürmemizi sağlar.
  • Üretim işinizde yalnızca ihtiyacınız olan alanları seçmek, gecikme performansının istikrarlı olmasını 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 eklediğimiz yeni alanlar yanıta otomatik olarak dahil edileceğinden performans düşüşü yaşayabilirsiniz.
  • Yalnızca ihtiyacınız olan alanları seçtiğinizde yanıt boyutu küçülür ve ağ üzerinden daha hızlı yüklenir.
rows
Matrisin satırları. Her satır bir başlangıç noktasına karşılık gelir ve her biri bir hedefe giden rotayı temsil eden RouteMatrixItem dizisi içerir.
toJSON
toJSON()
Parametreler:  Yok
Dönüş Değeri:  Object
Nesneye dönüştürür.

RouteMatrixRow sınıfı

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

RouteMatrix.computeRouteMatrix yöntemine iletilen bir kaynağa karşılık gelir. Her öğesi bir hedefe giden rotayı temsil eden RouteMatrixItem listesi içerir.

const {RouteMatrixRow} = await google.maps.importLibrary("routes") numarasını arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
items
Her bir varış noktası için rota bilgileri.
toJSON
toJSON()
Parametreler:  Yok
Dönüş Değeri:  Object
Nesneye dönüştürür.

RouteMatrixItem sınıfı

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

RouteMatrix.computeRouteMatrix yöntemine iletilen bir başlangıç/varış noktası çifti için hesaplanan rota bilgilerini içerir.

const {RouteMatrixItem} = await google.maps.importLibrary("routes") numarasını arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
condition
Tür:  RouteMatrixItemCondition optional
Rotanın bulunup bulunmadığını gösterir.
distanceMeters
Tür:  number optional
Rotanın metre cinsinden seyahat mesafesi.
durationMillis
Tür:  number optional
Rotada gezinmek için gereken sürenin milisaniye cinsinden değeri. ComputeRouteMatrixRequest.routingPreference değerini TRAFFIC_UNAWARE olarak ayarlarsanız bu değer RouteMatrixItem.staticDurationMillis ile aynı olur. ComputeRouteMatrixRequest.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.
error
Tür:  RouteMatrixItemError optional
Rota hesaplanırken oluşan hata.
fallbackInfo
Tür:  FallbackInfo optional
Sunucunun, belirli bir başlangıç/hedef çifti için belirtilen tercihlerle rotayı hesaplayamadığı bazı durumlarda farklı bir hesaplama moduna geçebilir. Yedek kullanıldığında bu alan, yedek yanıtla ilgili ayrıntılı bilgiler içerir. Aksi takdirde bu alanın değeri belirlenmez.
localizedValues
RouteMatrixItem özelliklerinin metin temsilleri.
staticDurationMillis
Tür:  number optional
Trafik koşulları dikkate alınmadan rota boyunca seyahat 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.
toJSON
toJSON()
Parametreler:  Yok
Dönüş Değeri:  Object
Nesneye dönüştürür.

ComputeRouteMatrixRequest arayüzü

google.maps.routes.ComputeRouteMatrixRequest arayüz

Rota matrisi isteği.
destinations
Yanıt matrisinin sütunlarını belirleyen varış noktaları dizisi. Dize olarak iletilen değer bir adres, Plus Code veya Place kaynak adı olabilir. Rakım değerleri dikkate alınmaz.
fields
Tür:  Iterable<string>
Getirilecek alanlar koleksiyonu. Tüm alanlar için ["*"] değerini belirtin.
origins
Yanıt matrisinin satırlarını belirleyen başlangıç noktaları dizisi. Dize olarak iletilen değer bir adres, Plus Code veya Place kaynak adı olabilir. Rakım değerleri dikkate alınmaz.

Başlangıç ve varış noktalarının kardinalitesiyle ilgili çeşitli boyut kısıtlamaları geçerlidir:
  • string veya Place olarak belirtilen toplam başlangıç ve varış noktası sayısı 50'den fazla olmamalıdır.
  • Başlangıç noktası sayısı ile hedef sayısı çarpımı 625'ten büyük olmamalıdır.
  • ComputeRouteMatrixRequest.routingPreference, TRAFFIC_AWARE_OPTIMAL olarak ayarlanırsa başlangıç ve varış noktası sayılarının çarpımı 100'den büyük olmamalıdır.
  • ComputeRouteMatrixRequest.travelMode, TRANSIT olarak ayarlanırsa başlangıç ve varış noktası sayılarının çarpımı 100'den büyük olmamalıdır.
arrivalTime optional
Tür:  Date optional
Varış saati.

Not: Yalnızca ComputeRouteMatrixRequest.travelMode, TRANSIT olarak ayarlandığında ayarlanabilir. ComputeRouteMatrixRequest.departureTime veya ComputeRouteMatrixRequest.arrivalTime değerlerinden birini belirtebilirsiniz ancak ikisini birden belirtemezsiniz. Toplu taşıma yolculukları, geçmişte en fazla 7 gün veya gelecekte en fazla 100 gün için kullanılabilir.
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 ComputeRouteMatrixRequest.travelMode, TRANSIT olarak ayarlandığında geçmişte bir zaman belirtebilirsiniz. Toplu taşıma yolculukları, geçmişte en fazla 7 gün veya gelecekte en fazla 100 gün için 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ülebilmesi için ComputeRouteMatrixRequest.fields içinde de belirtilmesi gerekir.
language optional
Tür:  string optional
BCP-47 dil kodu (ör. "en-US" veya "sr-Latn"). 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ğlamazsanız dil, Google Maps JavaScript API yerelleştirme ayarlarınızdan tahmin edilir. Aksi takdirde dil, ilk kaynağın konumundan tahmin edilir.
region optional
Tür:  string optional
ccTLD ("üst düzey alan") iki karakterli değeri olarak belirtilen bölge kodu. 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 tahmin edilir. Aksi takdirde bölge, ilk kaynağın konumundan tahmin edilir.
routingPreference optional
Tür:  RoutingPreference optional
Rota matrisinin nasıl hesaplanacağını belirtir. Sunucu, rota matrisini hesaplamak için seçilen rota 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 ComputeRouteMatrixRequest.travelMode, DRIVING veya TWO_WHEELER olduğunda belirtebilirsiniz. Aksi takdirde istek başarısız olur.
trafficModel optional
Tür:  TrafficModel optional
Trafikte geçen süreyi hesaplarken kullanılacak varsayımları belirtir. Bu ayar, geçmiş ortalamalara göre trafikteki tahmini süreyi içeren RouteMatrixItem.durationMillis içinde döndürülen değeri etkiler. ComputeRouteMatrixRequest.trafficModel yalnızca ComputeRouteMatrixRequest.routingPreference değerini TRAFFIC_AWARE_OPTIMAL ve ComputeRouteMatrixRequest.travelMode değerini DRIVING olarak ayarlayan istekler için kullanılabilir. Varsayılan değer: BEST_GUESS.
transitPreference optional
Tür:  TransitPreference optional
TRANSIT rotaları için döndürülen rotayı etkileyen tercihleri belirtir.

Not: Yalnızca ComputeRouteMatrixRequest.travelMode, TRANSIT olarak ayarlandığında belirtilebilir.
travelMode optional
Tür:  TravelMode optional
Ulaşım şeklini belirtir.
units optional
Tür:  UnitSystem optional
Görüntüleme alanlarının ölçü birimlerini belirtir. Bu değeri sağlamazsanız görüntüleme birimleri ilk başlangıç noktasının konumundan tahmin edilir.

ComputeRouteMatrixExtraComputation sabitleri

google.maps.routes.ComputeRouteMatrixExtraComputation sabitler

RouteMatrix.computeRouteMatrix isteği için gerçekleştirilecek ek hesaplamalar.

const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes") numarasını arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
TOLLS Matris öğeleri için ücret bilgileri.

RouteMatrixItemCondition sabitleri

google.maps.routes.RouteMatrixItemCondition sabitler

Belirli bir başlangıç/varış noktası çifti için rotanın durumu.

const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes") numarasını arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
ROUTE_EXISTS Bir rota bulundu.
ROUTE_NOT_FOUND Rota bulunamadı.

RouteMatrixItemError sınıfı

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

Belirli bir kaynak/hedef çifti için RouteMatrix.computeRouteMatrix sırasında oluşan hata.

Bu sınıf, Error sınıfını genişletir.

const {RouteMatrixItemError} = await google.maps.importLibrary("routes") numarasını arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
toJSON
toJSON()
Parametreler:  Yok
Dönüş Değeri:  Object
Nesneye dönüştürür.

RouteMatrixItemLocalizedValues sınıfı

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

RouteMatrixItem için metin temsilleri.

const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes") numarasını arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
distance
Tür:  string optional
Rota matrisi öğesinin metin biçimindeki seyahat mesafesi.
distanceLanguage
Tür:  string optional
Mesafe metninin BCP-47 dil kodu (ör. "en-US" veya "sr-Latn").

Daha fazla bilgi için http://www.unicode.org/reports/tr35/#Unicode_locale_identifier adresini ziyaret edin.
duration
Tür:  string optional
Metin biçiminde gösterilen ve sorgunun bölgesine göre yerelleştirilen süre. Trafik koşullarını dikkate alır.

Not: Trafik bilgisi istemediyseniz bu değer, RouteMatrixItemLocalizedValues.staticDuration ile aynıdır.
durationLanguage
Tür:  string optional
Süre metninin BCP-47 dil kodu (ör. "en-US" veya "sr-Latn").

Daha fazla bilgi için http://www.unicode.org/reports/tr35/#Unicode_locale_identifier adresini ziyaret edin.
staticDuration
Tür:  string optional
Trafik koşulları dikkate alınmadan hesaplanan sürenin metin biçiminde gösterimi.
staticDurationLanguage
Tür:  string optional
Statik süre metninin BCP-47 dil kodu (ör. "en-US" veya "sr-Latn").
transitFare
Tür:  string optional
Metin biçiminde gösterilen toplu taşıma ücreti.
transitFareLanguage
Tür:  string optional
Toplu taşıma ücreti metninin BCP-47 dil kodu (ör. "en-US" veya "sr-Latn").

Daha fazla bilgi için http://www.unicode.org/reports/tr35/#Unicode_locale_identifier adresini ziyaret edin.
toJSON
toJSON()
Parametreler:  Yok
Dönüş Değeri:  Object
Nesneye dönüştürür.

RouteMatrixOrigin arayüzü

google.maps.routes.RouteMatrixOrigin arayüz

ComputeRouteMatrixRequest için tek bir kaynak.
waypoint
Başlangıç noktasının konumu. Dize olarak iletilen değer bir adres veya Plus Code olabilir. Rakım değerleri dikkate alınmaz.
routeModifiers optional
Tür:  RouteModifiers optional
Bu konumu başlangıç noktası olarak kullanan her rota için değiştiriciler.