Route Matrix (beta)

RouteMatrix sınıfı

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

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

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

Not: Bu yöntemde, ComputeRouteMatrixRequest.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 ve mesafe alan maskesi: fields: ['durationMillis', 'distanceMeters']

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.
rows
Matrisin satırları. Her satır bir kaynağa karşılık gelir ve her biri bir hedefe giden rotayı temsil eden bir RouteMatrixItem dizisi içerir.
toJSON
toJSON()
Parametreler: Yok
İade Değeri:  Object
Nesneye dönüştürür.

RouteMatrixRow sınıfı

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

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

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

RouteMatrixItem sınıfı

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

RouteMatrix.computeRouteMatrix'ya iletilen bir başlangıç/varış çifti için hesaplanan rota bilgilerini içerir.

const {RouteMatrixItem} = await google.maps.importLibrary("routes") numaralı telefonu 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üre (milisaniye). ComputeRouteMatrixRequest.routingPreference öğesini 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ıç/varış noktası çifti için rotayı verilen tercihlerle hesaplayamadığı bazı durumlarda farklı bir hesaplama modu kullanmaya geri dönebilir. Yedek yanıt kullanıldığında bu alanda yedek yanıtla ilgili ayrıntılı bilgiler yer alır. Aksi takdirde bu alanın değeri belirlenmez.
localizedValues
RouteMatrixItem özelliklerinin metin gösterimleri.
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.

ComputeRouteMatrixRequest arayüzü

google.maps.routes.ComputeRouteMatrixRequest arayüz

Rota matrisi isteği.
destinations
Yanıt matrisinin sütunlarını belirleyen hedef dizisi. Dize olarak iletilen değer bir adres, artı kodu veya yer kaynağı adı olabilir. Yükseklik değerleri dikkate alınmaz.
fields
Tür:  Iterable<string>
Getirilecek alanların koleksiyonu. Tüm alanlar için ["*"] değerini belirtin.
origins
Yanıt matrisinin satırlarını belirleyen kaynak dizisi. Dize olarak iletilen değer bir adres, artı kodu veya yer kaynağı adı olabilir. Yükseklik değerleri dikkate alınmaz.

Başlangıç ve varış noktalarının kardinalitesiyle ilgili çeşitli boyut kısıtlamaları vardır:
  • string veya Place olarak belirtilen toplam başlangıç ve hedef sayısı 50'den fazla olmamalıdır.
  • Kaynak sayısı ile hedef sayısının çarpımı 625'ten büyük olmamalıdır.
  • ComputeRouteMatrixRequest.routingPreference, TRAFFIC_AWARE_OPTIMAL olarak ayarlanmışsa kaynak ve hedef sayısının çarpımı 100'den büyük olmamalıdır.
  • ComputeRouteMatrixRequest.travelMode, TRANSIT olarak ayarlanmışsa kaynak ve hedef sayısı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 belirlenebilir. ComputeRouteMatrixRequest.departureTime veya ComputeRouteMatrixRequest.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.
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ş 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 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 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, ilk kaynağın konumundan çıkarılır.
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, ilk kaynağın konumundan çıkarılır.
routingPreference optional
Tür:  RoutingPreference optional
Rota matrisinin nasıl hesaplanacağını belirtir. Sunucu, rota matrisini 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 ComputeRouteMatrixRequest.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 dayalı olarak trafikteki tahmini süreyi içeren RouteMatrixItem.durationMillis içinde döndürülen değeri etkiler. ComputeRouteMatrixRequest.trafficModel yalnızca ComputeRouteMatrixRequest.routingPreference değerinin TRAFFIC_AWARE_OPTIMAL, ComputeRouteMatrixRequest.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 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 kaynağın konumundan çıkarılır.

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") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
TOLLS Matris öğeleri için ücretli yol bilgileri.

RouteMatrixItemCondition sabitleri

google.maps.routes.RouteMatrixItemCondition sabitler

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

const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes") numaralı telefonu 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 bir hata.

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

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

RouteMatrixItemLocalizedValues sınıfı

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

RouteMatrixItem ile ilgili metin temsilleri.

const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes") numaralı telefonu 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
Süre, metin biçiminde gösterilir ve sorgunun bölgesine göre yerelleştirilir. Trafik koşullarını dikkate alır.

Not: Trafik bilgisi istemediyseniz bu değer, RouteMatrixItemLocalizedValues.staticDuration ile aynı değerdir.
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 ve metin biçiminde gösterilen süre.
staticDurationLanguage
Tür:  string optional
Statik süre metninin BCP-47 dil kodu (ör. "en-US" veya "sr-Latn").
transitFare
Tür:  string optional
Toplu taşıma ücreti (metin biçiminde gösterilir).
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
İade 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. Yükseklik değerleri dikkate alınmaz.
routeModifiers optional
Tür:  RouteModifiers optional
Bunu başlangıç noktası olarak alan her rota için değiştiriciler.