Route Matrix

RouteMatrix sınıfı

sınıf google.maps.routes.RouteMatrix
kitaplık "routes"

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

const {RouteMatrix} = await google.maps.importLibrary("routes");
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
readonly
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.
Devralındı: toJSON

RouteMatrixRow sınıfı

sınıf google.maps.routes.RouteMatrixRow
kitaplık "routes"

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");
items
readonly
Her bir varış noktası için rota bilgileri.
Devralındı: toJSON

RouteMatrixItem sınıfı

sınıf google.maps.routes.RouteMatrixItem
kitaplık "routes"

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");
condition
readonly
Rotanın bulunup bulunmadığını gösterir.
distanceMeters
readonly
Tür: number optional
Rotanın metre cinsinden seyahat mesafesi.
durationMillis
readonly
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
readonly
Tür: RouteMatrixItemError optional
Rota hesaplanırken oluşan hata.
fallbackInfo
readonly
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
readonly
RouteMatrixItem özelliklerinin metin temsilleri.
staticDurationMillis
readonly
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
readonly
Tür: RouteTravelAdvisory optional
Rota hakkında ek bilgiler.

ComputeRouteMatrixRequest arayüzü

arayüz google.maps.routes.ComputeRouteMatrixRequest

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
isteğe bağlı
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
isteğe bağlı
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
isteğ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ülebilmesi için ComputeRouteMatrixRequest.fields içinde de belirtilmesi gerekir.
internalUsageAttributionIds
isteğe bağlı
Tür: Iterable<string> optional
Çağrıları belirli paketlerle veya OSS kitaplıklarıyla ilişkilendirmek için kullanılan tanımlayıcılar.
language
isteğe bağlı
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
isteğe bağlı
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
isteğe bağlı
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
isteğe bağlı
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
isteğe bağlı
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
isteğe bağlı
Tür: TravelMode optional
Ulaşım şeklini belirtir.
units
isteğe bağlı
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

sabitler google.maps.routes.ComputeRouteMatrixExtraComputation
kitaplık "routes"

İstek tamamlanırken gerçekleştirilecek ek hesaplamalar. Daha fazla bilgi için web hizmeti belgelerini inceleyin.

Bu sabitler dize olarak da kullanılabilir. TypeScript'te dize sabit değerleri ComputeRouteMatrixExtraComputationString türüyle tanımlanır.

const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes");
TOLLS Matris öğeleri için ücret bilgileri. Daha fazla bilgi için web hizmeti belgelerini inceleyin.

RouteMatrixItemCondition sabitleri

sabitler google.maps.routes.RouteMatrixItemCondition
kitaplık "routes"

Döndürülen rotanın durumu. Daha fazla bilgi için web hizmeti belgelerini inceleyin.

Bu sabitler dize olarak da kullanılabilir. TypeScript'te dize sabit değerleri RouteMatrixItemConditionString türüyle tanımlanır.

const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes");
ROUTE_EXISTS Bir rota bulundu ve öğe için ilgili bilgiler dolduruldu. Daha fazla bilgi için web hizmeti belgelerini inceleyin.
ROUTE_NOT_FOUND Rota bulunamadı. Daha fazla bilgi için web hizmeti belgelerini inceleyin.

RouteMatrixItemError sınıfı

class google.maps.routes.RouteMatrixItemError extends Error
library "routes"

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

const {RouteMatrixItemError} = await google.maps.importLibrary("routes");
Devralındı: toJSON

RouteMatrixItemLocalizedValues sınıfı

sınıf google.maps.routes.RouteMatrixItemLocalizedValues
kitaplık "routes"

RouteMatrixItem için metin temsilleri.

const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes");
distance
readonly
Tür: string optional
Rota matrisi öğesinin metin biçimindeki seyahat mesafesi.
distanceLanguage
readonly
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
readonly
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
readonly
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
readonly
Tür: string optional
Trafik koşulları dikkate alınmadan hesaplanan sürenin metin biçiminde gösterimi.
staticDurationLanguage
readonly
Tür: string optional
Statik süre metninin BCP-47 dil kodu (ör. "en-US" veya "sr-Latn").
transitFare
readonly
Tür: string optional
Metin biçiminde gösterilen toplu taşıma ücreti.
transitFareLanguage
readonly
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.
Devralındı: toJSON

RouteMatrixOrigin arayüzü

arayüz google.maps.routes.RouteMatrixOrigin

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
isteğe bağlı
Tür: RouteModifiers optional
Bu konumu başlangıç noktası olarak kullanan her rota için değiştiriciler.