Distance Matrix

DistanceMatrixService sınıfı

google.maps.DistanceMatrixService sınıf

Birden fazla başlangıç ve varış noktası arasındaki mesafeleri hesaplamak için kullanılan bir hizmettir.

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 bir DistanceMatrixService öğesinin yeni bir örneğini oluşturur.
getDistanceMatrix
getDistanceMatrix(request[, callback])
Parametreler: 
İade 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 hesaplamaya yönelik çeşitli seçenekler içeren bir mesafe matrisi sorgusu.
destinations
Uzaklık ve sürenin hesaplanacağı hedef adres dizelerini, LatLng veya Place nesnelerini içeren bir dizi. Zorunlu.
origins
Uzaklık ve sürenin hesaplanacağı, başlangıç adresi 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ı talimatını verir. İsteğe bağlı.
avoidHighways optional
Tür:  boolean optional
true ise Mesafe Matrisi hizmetine mümkün olduğunda otoyollardan kaçınması talimatını verir. İsteğe bağlı.
avoidTolls optional
Tür:  boolean optional
true ise Distance Matrix hizmetine mümkün olduğunda ücretli yollardan kaçınması talimatını verir. İ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 nesne, diğer seyahat modları için geçerli değildir.
language optional
Tür:  string optional
Mümkün olduğunda sonuçların döndürülmesi gereken dilin 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, ccTLD ("üst düzey alan") iki karakterlik değerini kabul eder. Çoğu ccTLD kodu, ISO 3166-1 kodlarıyla aynıdır ancak bazı önemli istisnalar vardır. Örneğin, Birleşik Krallık'ın ccTLD'si "uk" (.co.uk), ISO 3166-1 kodu ise "gb"dir (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallığı" için).
transitOptions optional
Tür:  TransitOptions optional
Yalnızca travelMode değerinin TRANSIT olduğu istekler için geçerli olan ayarlar. Bu nesne, diğer seyahat modları için geçerli değildir.
unitSystem optional
Tür:  UnitSystem optional
Mesafeyi gösterirken kullanılacak tercih edilen birim sistemi. İsteğe bağlıdır. Varsayılan olarak metrik birim kullanılır.

DistanceMatrixResponse arayüzü

google.maps.DistanceMatrixResponse arayüz

Biçimlendirilmiş kaynak ve hedef adreslerden ve her bir karşılık gelen kaynak adresi için bir tane olmak üzere bir dizi DistanceMatrixResponseRow'den oluşan bir DistanceMatrixService isteğine verilen yanıt.
destinationAddresses
Tür:  Array<string>
Biçimlendirilmiş hedef adresler.
originAddresses
Tür:  Array<string>
Biçimlendirilmiş kaynak adresler.
rows
Matrisin, kaynak adreslere karşılık gelen satırları.

DistanceMatrixResponseRow arayüzü

google.maps.DistanceMatrixResponseRow arayüz

Bir DistanceMatrixService isteğine verilen yanıttaki bir satır. Her hedef adres için bir tane olmak üzere bir dizi DistanceMatrixResponseElement'den oluşur.
elements
Hedef adreslere karşılık gelen satır öğeleri.

DistanceMatrixResponseElement arayüzü

google.maps.DistanceMatrixResponseElement arayüz

Bir başlangıç noktasından bir hedef noktaya olan süreyi ve mesafeyi içeren, DistanceMatrixService isteğine verilen yanıtın tek bir öğesi.
distance
Tür:  Distance
Bu başlangıç-hedef eşleşmesinin 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
Bu kaynak-hedef eşlemesinin süresi, trafficModel özelliği tarafından belirtilen trafik koşulları dikkate alınarak hesaplanır. Süre bilinmeyebileceğinden bu özellik undefined olabilir. Yalnızca Premium Plan müşterileri tarafından, istekte bulunurken drivingOptions tanımlandığında kullanılabilir.
fare
Tür:  TransitFare
Bu başlangıç-varış noktası eşleşmesinin toplam ücreti. Yalnızca toplu taşıma istekleri için geçerlidir.
status
Bu belirli başlangıç-varış noktası eşlemesinin durumu.

DistanceMatrixStatus sabitleri

google.maps.DistanceMatrixStatus sabitler

Bir mesafe matrisi isteği tamamlandığında DistanceMatrixService tarafından döndürülen, istekle ilgili genel üst düzey durum. Bunları değerle veya sabitin adını kullanarak belirtebilirsiniz. Ö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 Başlangıç ve varış noktalarının çarpımı, sorgu başına sınırı aşıyor.
OK Yanıtta geçerli bir sonuç var.
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ın Mesafe Matrisi hizmetini kullanması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 sabitler

Bir 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, örneğin 'OK' gibi dizeler olarak belirtilir.

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 olarak kodlanamadı.
OK Yanıtta geçerli bir sonuç var.
ZERO_RESULTS Başlangıç ve varış noktası arasında rota bulunamadı.