Distance Matrix (deprecated)

DistanceMatrixService sınıfı

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

const {DistanceMatrixService} = await google.maps.importLibrary("routes");
DistanceMatrixService
DistanceMatrixService()
Parametreler: Yok
Google sunucularına mesafe matrisi sorguları gönderen yeni bir DistanceMatrixService örneği oluşturur.
getDistanceMatrix
getDistanceMatrix(request[, callback])
Parametreler:
Dönüş Değeri: Promise<DistanceMatrixResponse>
Mesafe matrisi isteği gönderir.

DistanceMatrixRequest arayüzü

google.maps.DistanceMatrixRequest arayüz

DistanceMatrixService tarafından gönderilen, başlangıç ve hedef konum dizileri ile metrikleri hesaplamak için çeşitli seçenekler içeren bir mesafe matrisi sorgusu.

destinations
Mesafe ve sürenin hesaplanacağı hedef adres dizelerini veya LatLng ya da Place nesnelerini içeren bir dizi. Zorunlu.
origins
Mesafe ve sürenin hesaplanacağı kaynak adres dizelerini veya LatLng ya da Place nesnelerini içeren bir dizi. Zorunlu.
travelMode
İstenen yönlendirme türü. Zorunlu.
avoidFerries
isteğe bağlı
Tür: boolean optional
true ise Distance Matrix hizmetine mümkün olduğunda feribotlardan kaçınmasını söyler. İsteğe bağlıdır.
avoidHighways
isteğe bağlı
Tür: boolean optional
true ise Distance Matrix hizmetine mümkün olduğunda otoyollardan kaçınmasını söyler. İsteğe bağlıdır.
avoidTolls
isteğe bağlı
Tür: boolean optional
true ise Distance Matrix hizmetine, mümkün olduğunda paralı yollardan kaçınmasını söyler. İsteğe bağlıdır.
drivingOptions
isteğe bağlı
Tür: DrivingOptions optional
Yalnızca travelMode değerinin DRIVING olduğu istekler için geçerli olan ayarlar. Bu nesnenin diğer seyahat modları üzerinde herhangi bir etkisi olmaz.
language
isteğe bağlı
Tür: string optional
Mümkün olduğunda sonuçların döndürülmesi gereken dil için bir dil tanımlayıcı. Desteklenen dillerin listesine bakın.
region
isteğe bağlı
Tür: string optional
Coğrafi kodlama istekleri için bir önyargı olarak kullanılan bölge kodu. Bölge kodu, iki karakterli bir ccTLD ("üst düzey alan") değerini kabul eder. Çoğu ccTLD kodu, bazı önemli istisnalar dışında ISO 3166-1 kodlarıyla aynıdır. Örneğin, Birleşik Krallık'ın ccTLD'si "uk" (.co.uk) iken ISO 3166-1 kodu "gb"dir (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallığı" tüzel kişiliği için).
transitOptions
isteğe bağlı
Tür: TransitOptions optional
Yalnızca travelMode değerinin TRANSIT olduğu istekler için geçerli olan ayarlar. Bu nesnenin diğer seyahat modları üzerinde herhangi bir etkisi olmaz.
unitSystem
isteğe bağlı
Tür: UnitSystem optional
Mesafe gösterilirken kullanılacak tercih edilen birim sistemi. İsteğe bağlı; varsayılan olarak metrik kullanılır.

DistanceMatrixResponse arayüzü

google.maps.DistanceMatrixResponse arayüz

Biçimlendirilmiş başlangıç ve hedef adreslerinden ve her bir başlangıç adresi için bir tane olmak üzere DistanceMatrixResponseRow dizisinden oluşan DistanceMatrixService isteğine verilen yanıt.

destinationAddresses
Tür: Array<string>
Biçimlendirilmiş hedef adresleri.
originAddresses
Tür: Array<string>
Biçimlendirilmiş kaynak adresleri.
rows
Matrisin başlangıç adreslerine karşılık gelen satırları.

DistanceMatrixResponseRow arayüzü

google.maps.DistanceMatrixResponseRow arayüz

DistanceMatrixService isteğine verilen yanıtın bir satırı. Bu satır, her bir hedef adres için bir tane olmak üzere DistanceMatrixResponseElement dizisinden oluşur.

elements
Satırın hedef adreslere karşılık gelen öğeleri.

DistanceMatrixResponseElement arayüzü

google.maps.DistanceMatrixResponseElement arayüz

Bir başlangıç noktasından bir varış noktasına olan süreyi ve mesafeyi içeren bir DistanceMatrixService isteğine verilen yanıtın tek bir öğesi.

distance
Tür: Distance
Bu kalkış-varış noktası eşlemesinin mesafesi. Mesafe bilinmeyebileceğinden bu özellik tanımlanmamış olabilir.
duration
Tür: Duration
Bu başlangıç-hedef eşlemesinin süresi. Süre bilinmeyebileceğinden bu özellik tanımlanmamış olabilir.
duration_in_traffic
Tür: Duration
trafficModel özelliğiyle belirtilen trafik koşulları dikkate alınarak bu başlangıç-varış noktası eşleşmesinin süresi. Süre bilinmeyebileceğinden bu özellik undefined olabilir. Yalnızca istekte bulunurken drivingOptions tanımlandığında Premium Plan müşterileri tarafından kullanılabilir.
fare
Bu kalkış-varış noktası eşleşmesi için toplam ücret. Yalnızca toplu taşıma istekleri için geçerlidir.
status
Bu belirli kalkış-varış yeri eşlemesinin durumu.

DistanceMatrixStatus sabitleri

google.maps.DistanceMatrixStatus sabitleri
kitaplığı "routes"

Mesafe matrisi isteği tamamlandığında DistanceMatrixService tarafından döndürülen, genel olarak istekle ilgili üst düzey durum. Bunları değere göre veya sabitin adını kullanarak belirtin. Örneğin, 'OK' veya google.maps.DistanceMatrixStatus.OK

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

const {DistanceMatrixStatus} = await google.maps.importLibrary("routes");
INVALID_REQUEST Sağlanan istek geçersiz.
MAX_DIMENSIONS_EXCEEDED İstek, 25'ten fazla başlangıç noktası veya 25'ten fazla hedef içeriyor.
MAX_ELEMENTS_EXCEEDED Başlangıç ve varış noktalarının çarpımı, sorgu başına sınırı aşıyor.
OK Yanıt, geçerli bir sonuç içeriyor.
OVER_QUERY_LIMIT İzin verilen süre içinde çok fazla öğe istendi. Bir süre sonra tekrar denerseniz istek başarılı olacaktır.
REQUEST_DENIED Hizmet, web sayfanızın Distance Matrix hizmetini kullanmasını reddetti.
UNKNOWN_ERROR Sunucu hatası nedeniyle Distance Matrix isteği işlenemedi. Tekrar denerseniz istek başarılı olabilir.

DistanceMatrixElementStatus sabitleri

google.maps.DistanceMatrixElementStatus sabitleri
kitaplığı "routes"

Mesafe matrisi isteği tamamlandıktan sonra DistanceMatrixService tarafından döndürülen belirli bir başlangıç-hedef eşleşmesiyle ilgili öğe düzeyindeki durum. Bu değerler dize olarak belirtilir (ör. 'OK').

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

const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes");
NOT_FOUND Bu eşlemenin kaynağı ve/veya hedefi coğrafi olarak kodlanamadı.
OK Yanıt, geçerli bir sonuç içeriyor.
ZERO_RESULTS Başlangıç ve varış noktası arasında rota bulunamadı.