Distance Matrix

DistanceMatrixService sınıfı

google.maps.DistanceMatrixService sınıf

Birden fazla başlangıç ve varış noktası arasındaki mesafeleri hesaplayan bir hizmet.

const {DistanceMatrixService} = await google.maps.importLibrary("routes") numaralı telefonu arayarak erişebilirsiniz. Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
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öndürülen Değer:  Promise<DistanceMatrixResponse>
Mesafe matrisi isteği gönderir.

DistanceMatrixRequest sınıf arayüzü

google.maps.DistanceMatrixRequest arayüz

DistanceMatrixService tarafından gönderilen, kaynak ve hedef konum dizileri ve metrikleri hesaplamak için çeşitli seçenekler içeren bir mesafe matrisi sorgusu.
destinations
Hedef adres dizelerini veya LatLng ya da Place nesnelerini içeren ve mesafe ile sürenin hesaplanacağı bir dizi. Zorunlu.
origins
Mesafe ve sürenin hesaplanacağı kaynak adres dizelerini veya LatLng ya da Place nesnelerini içeren bir dizi. Zorunlu.
travelMode
Tür:  TravelMode
İstenen yönlendirme türü. Zorunlu.
avoidFerries optional
Tür:  boolean optional
true ise Mesafe Matrisi hizmetine mümkün olduğunda feribotlardan kaçınmasını söyler. İsteğe bağlı.
avoidHighways optional
Tür:  boolean optional
true ise Mesafe Matrisi hizmetine mümkün olduğunda otoyolları kullanmamasını söyler. İsteğe bağlı.
avoidTolls optional
Tür:  boolean optional
true ise Mesafe Matrisi hizmetine, mümkün olduğunda ücretli yollardan kaçınmasını söyler. İsteğe bağlı.
drivingOptions optional
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 hiçbir etkisi olmaz.
language optional
Tür:  string optional
Mümkün olduğunda sonuçların döndürülmesi gereken dil için dil tanımlayıcısı. Desteklenen dillerin listesine bakın.
region optional
Tür:  string optional
Coğrafi kodlama istekleri için önyargı olarak kullanılan bölge kodu. Bölge kodu, iki karakterli bir ccTLD ("üst düzey alan") değerini kabul eder. Bazı önemli istisnalar dışında, çoğu ccTLD kodu 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 optional
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 hiçbir etkisi olmaz.
unitSystem optional
Tür:  UnitSystem optional
Mesafeyi görüntülerken tercih edilen birim sistemi. İsteğe bağlıdır; varsayılan olarak metrik değerini alır.

DistanceMatrixResponse arabirim

google.maps.DistanceMatrixResponse arayüz

Bir DistanceMatrixService isteğinin yanıtı. Bu yanıt, biçimlendirilmiş kaynak ve hedef adreslerden ve her bir ilgili kaynak adres için birer DistanceMatrixResponseRow dizisinden oluşur.
destinationAddresses
Tür:  Array<string>
Biçimlendirilmiş hedef adresler.
originAddresses
Tür:  Array<string>
Biçimlendirilmiş kaynak adresleri.
rows
Kaynak adreslere karşılık gelen matris satırları.

DistanceMatrixResponseRow arabirim

google.maps.DistanceMatrixResponseRow arayüz

DistanceMatrixService isteğine verilen yanıtın bir satırı. Her karşılık gelen hedef adres için bir DistanceMatrixResponseElement dizisinden oluşur.
elements
Hedef adreslere karşılık gelen satır öğeleri.

DistanceMatrixResponseElement sınıf arayüzü

google.maps.DistanceMatrixResponseElement arayüz

Bir DistanceMatrixService isteğine verilen yanıtın tek bir öğesi. Bu öğe, bir başlangıç noktasından bir hedefe kadar olan süreyi ve mesafeyi içerir.
distance
Tür:  Distance
Bu başlangıç-hedef eşlemesinin mesafesi. Mesafe bilinmediği için bu özellik tanımlanmamış olabilir.
duration
Tür:  Duration
Bu başlangıç-hedef eşlemesinin süresi. Süre bilinmediği için bu mülk tanımlanmamış olabilir.
duration_in_traffic
Tür:  Duration
trafficModel mülkü tarafından belirtilen trafik koşulları dikkate alınarak bu kaynak-hedef eşleştirmenin süresi. Süre bilinmediği için bu özellik undefined olabilir. Yalnızca Premium Plan müşterileri tarafından kullanılabilir. İstekte bulunurken drivingOptions tanımlanmalıdır.
fare
Tür:  TransitFare
Bu kaynak-varış noktası eşleştirmesinin toplam ücreti. Yalnızca toplu taşıma istekleri için geçerlidir.
status
Bu belirli kaynak-hedef eşlemesinin durumu.

DistanceMatrixStatus constants

google.maps.DistanceMatrixStatus constants

Genel olarak, mesafe matrisi isteği tamamlandıktan sonra DistanceMatrixService tarafından döndürülen 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

const {DistanceMatrixStatus} = await google.maps.importLibrary("routes") numaralı telefonu arayarak erişebilirsiniz. Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
INVALID_REQUEST Sağlanan istek geçersizdi.
MAX_DIMENSIONS_EXCEEDED İstek 25'ten fazla kaynak veya 25'ten fazla hedef içeriyor.
MAX_ELEMENTS_EXCEEDED Kalkış 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ı olur.
REQUEST_DENIED Hizmet, web sayfanız tarafından Mesafe Matrisi hizmetinin kullanımını reddetti.
UNKNOWN_ERROR Bir mesafe matrisi isteği, sunucu hatası nedeniyle işlenemedi. Tekrar denerseniz istek başarılı olabilir.

DistanceMatrixElementStatus sabitleri

google.maps.DistanceMatrixElementStatus constants

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

const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes") numaralı telefonu arayarak erişebilirsiniz. Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
NOT_FOUND Bu eşlemenin kaynağı ve/veya hedefi coğrafi kodlanamadı.
OK Yanıt geçerli bir sonuç içeriyor.
ZERO_RESULTS Kalkış ve varış noktası arasında rota bulunamadı.