Distance Matrix

DistanceMatrixService sınıfı

google.maps.DistanceMatrixService sınıf

Birden fazla başlangıç noktası ve varış noktası arasındaki mesafelerin hesaplanmasına yönelik bir hizmet.

const {DistanceMatrixService} = await google.maps.importLibrary("routes") numaralı telefonu arayarak erişin. Haritalar JavaScript API'sindeki Kitaplıklar konusuna bakın.

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 yayınlar.

DistanceMatrixRequest arayüzü

google.maps.DistanceMatrixRequest arayüz

DistanceMatrixService tarafından gönderilen mesafe matrisi sorgusu, başlangıç ve hedef konum dizilerini ve metrikleri hesaplamaya yönelik çeşitli seçenekleri içerir.

destinations
Mesafe ve sürenin hesaplanacağı hedef adres dizeleri veya LatLng ya da Place nesnelerini içeren bir dizi. Zorunlu.
origins
Mesafe ve sürenin hesaplanacağı kaynak adres dizeleri 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çınmak için talimat verir. İsteğe bağlı.
avoidHighways optional
Tür:  boolean optional
true ise Mesafe Matrisi hizmetine mümkün olduğunda otoyollardan kaçınması için talimat verir. İsteğe bağlı.
avoidTolls optional
Tür:  boolean optional
true ise Mesafe Matrisi hizmetine mümkün olduğunda paralı 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 nesnenin diğer ulaşım şekilleri üzerinde etkisi olmayacak.
language optional
Tür:  string optional
Mümkün olduğunda sonuçların döndürüleceği dil için dil tanımlayıcısı. Desteklenen dillerin listesine bakın.
region optional
Tür:  string optional
Coğrafi kodlama isteklerinde ağırlık olarak kullanılan bölge kodu. Bölge kodu, iki karakterden oluşan 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) ve ISO 3166-1 kodu "gb"dir (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallık'ı" için kullanılır).
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 ulaşım şekilleri üzerinde etkisi olmayacak.
unitSystem optional
Tür:  UnitSystem optional
Mesafe görüntülenirken kullanılması tercih edilen birim sistemi. İsteğe bağlıdır; varsayılan olarak metriktir.

DistanceMatrixResponse arayüzü

google.maps.DistanceMatrixResponse arayüz

Biçimlendirilmiş kaynak ile hedef adresleri ve ilgili her bir kaynak adresi için bir DistanceMatrixResponseRow dizisinden oluşan DistanceMatrixService isteğine verilen yanıt.

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

DistanceMatrixResponseRow arayüzü

google.maps.DistanceMatrixResponseRow arayüz

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

elements
Hedef adreslere karşılık gelen satır öğeleri.

DistanceMatrixResponseElement arayüzü

google.maps.DistanceMatrixResponseElement arayüz

DistanceMatrixService isteğine verilen yanıtın tek bir öğesi. Bu öğe, bir kaynaktan bir hedefe olan mesafeyi ve süreyi içerir.

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

DistanceMatrixStatus sabit değerleri

google.maps.DistanceMatrixStatus sabit değer

Bir mesafe matrisi isteğinin tamamlanmasının ardından DistanceMatrixService tarafından döndürülen, genel olarak istekle ilgili üst düzey durum. Bunları değere göre veya sabit değerin adını kullanarak belirtin. Örneğin, 'OK' veya google.maps.DistanceMatrixStatus.OK

const {DistanceMatrixStatus} = await google.maps.importLibrary("routes") numaralı telefonu arayarak erişin. Haritalar JavaScript API'sindeki Kitaplıklar konusuna bakın.

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 Kaynak ve hedefler ç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, Mesafe Matrisi hizmetinin web sayfanız tarafından kullanılmasını engelledi.
UNKNOWN_ERROR Sunucu hatası nedeniyle Mesafe Matrisi isteği işlenemedi. Tekrar denerseniz istek başarılı olabilir.

DistanceMatrixElementStatus sabit değerleri

google.maps.DistanceMatrixElementStatus sabit değer

Bir mesafe matrisi isteği tamamlandıktan sonra DistanceMatrixService tarafından döndürülen belirli bir kalkış-varış eşleştirmesiyle ilgili öğe düzeyindeki durum. Bu değerler dize olarak belirtilir (örneğin, 'OK').

const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes") numaralı telefonu arayarak erişin. Haritalar JavaScript API'sindeki Kitaplıklar konusuna bakın.

NOT_FOUND Bu eşlemenin başlangıç ve/veya varış noktalarının coğrafi kodu belirlenemedi.
OK Yanıt geçerli bir sonuç içeriyor.
ZERO_RESULTS Kalkış ve varış noktaları arasında rota bulunamadı.