Distance Matrix

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

DISTANCEMatrixService sınıfı

google.maps.DistanceMatrixService sınıf

Birden fazla başlangıç noktası ile hedef arasındaki mesafeleri hesaplamaya yarayan bir hizmet.

DistanceMatrixService
DistanceMatrixService()
Parametreler: Yok
Google sunucularına mesafe matrisi sorguları gönderen yeni bir DistanceMatrixService örneği oluşturur.
getDistanceMatrix
getDistanceMatrix(request[, callback])
Parametreler:
Mesafe matrisi isteği gönderir.

DISTANCEMatrixRequest arayüzü

google.maps.DistanceMatrixRequest arayüz

DistanceMatrixService tarafından gönderilen başlangıç noktası ve hedef konum dizilerini ve metrik hesaplamaları için çeşitli seçenekleri içeren bir mesafe matrisi sorgusu.

destinations
Varış noktası ve süreyi hesaplamak için hedef adres dizeleri veya LatLng ya da Place nesneleri içeren bir dizi. Zorunlu.
origins
Uzaklık ve süreyi hesaplamak için kaynak adres dizeleri veya LatLng ya da Place nesneleri içeren bir dizi. Zorunlu.
travelMode
İstenen yönlendirme türü. Zorunlu.
avoidFerries optional
Tür: boolean optional
true ise mümkün olduğunda feribotların kullanılmaması için Mesafe Matrisi hizmetine talimat verir. İsteğe bağlı.
avoidHighways optional
Tür: boolean optional
true ise mümkün olduğunda otoyollardan kaçınmak için Mesafe Matrisi hizmetine talimat verin. İsteğe bağlı.
avoidTolls optional
Tür: boolean optional
true ise mümkün olduğunda paralı yollardan kaçınması için Mesafe Matrisi hizmetine talimat verir. İsteğe bağlı.
drivingOptions optional
Tür: DrivingOptions optional
Yalnızca travelMode DRIVING olan istekler için geçerli olan ayarlar. Bu nesnenin diğer ulaşım modları üzerinde hiçbir etkisi olmayacaktır.
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 ön yargı olarak kullanılan bölge kodu. Bölge kodu, iki karakterli 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ığı" içindir).
transitOptions optional
Tür: TransitOptions optional
Yalnızca travelMode TRANSIT olan istekler için geçerli olan ayarlar. Bu nesnenin diğer ulaşım modları üzerinde hiçbir etkisi olmayacaktır.
unitSystem optional
Tür: UnitSystem optional
Mesafe görüntülenirken kullanılacak tercih edilen birim sistemi. İsteğe bağlı; varsayılan olarak metriktir.

DISTANCEMatrixResponse arayüzü

google.maps.DistanceMatrixResponse arayüz

Biçimlendirilmiş kaynak ve hedef adreslerinden oluşan bir DistanceMatrixService isteğine verilen yanıt ve karşılık gelen her bir kaynak adresi için bir dizi DistanceMatrixResponseRow.

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

DISTANCEMatrixResponseRow arayüz

google.maps.DistanceMatrixResponseRow arayüz

Bir DistanceMatrixService isteğine verilen yanıtın, her karşılık gelen hedef adresi için bir DistanceMatrixResponseElement sırası içeren bir satırı.

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

RemoteMatrixResponseElement arayüzü

google.maps.DistanceMatrixResponseElement arayüz

DistanceMatrixService kaynağından gelen yanıtın tek bir öğesi. Bu öğe, bir başlangıç noktasından bir hedefe kadar olan mesafeyi ve mesafeyi içerir.

distance
Tür: Distance
Kalkış noktası eşleme için mesafe. Mesafe bilinmeyebileceği için bu özellik tanımsız olabilir.
duration
Tür: Duration
Bu kalkış noktası-hedef eşlemenin süresi. Süre bilinmiyor olabileceğinden bu özellik tanımsız olabilir.
duration_in_traffic
Tür: Duration
trafficModel mülkü tarafından belirtilen trafik koşulları dikkate alınarak bu kaynak-hedef eşlemenin süresi. Süre bilinmiyor olabileceğinden bu özellik undefined olabilir. Premium Plan müşterileri yalnızca istek sırasında drivingOptions tanımlandığında kullanılabilir.
fare
Kalkış noktası eşleştirme için toplam ücret. Yalnızca toplu taşıma istekleri için geçerlidir.
status
Belirli bir kalkış noktası-hedef eşlemenin durumu.

DISTANCEMatrixStatus sabit değerleri

google.maps.DistanceMatrixStatus sabit değer

İstekle ilgili genel anlamda üst düzey durum, mesafe matrisi isteği tamamlandıktan sonra DistanceMatrixService tarafından döndürülür. Bunları değere göre veya sabit adını kullanarak belirtin. Örneğin, 'OK' veya google.maps.DistanceMatrixStatus.OK.

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 Kaynakların ve hedeflerin ürünü, 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, Mesafe Matrisi hizmetinin web sayfanız tarafından kullanılmasını reddetti.
UNKNOWN_ERROR Sunucu hatası nedeniyle Mesafe Matrisi isteği işlenemedi. Tekrar denemeniz durumunda istek başarılı olabilir.

DISTANCEMatrixElementStatus sabit değerleri

google.maps.DistanceMatrixElementStatus sabit değer

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

NOT_FOUND Bu eşlemenin kaynağı ve/veya hedefi coğrafi olarak kodlanamadı.
OK Yanıt, geçerli bir sonuç içeriyor.
ZERO_RESULTS Kalkış ve varış noktaları arasında rota bulunamadı.