DistanceMatrixService sınıfı
google.maps.DistanceMatrixService
sınıf
kitaplık "routes"
const {DistanceMatrixService} = await google.maps.importLibrary("routes");
Marka | |
|---|---|
DistanceMatrixService |
DistanceMatrixService()Parametreler: Yok
Google sunucularına mesafe matrisi sorguları gönderen yeni bir DistanceMatrixService örneği oluşturur. |
Yöntemler | |
|---|---|
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.
Özellikler | |
|---|---|
destinations |
Tür:
Array<string|LatLng|LatLngLiteral|Place>Mesafe ve sürenin hesaplanacağı hedef adres dizelerini veya LatLng ya da Place nesnelerini içeren bir dizi. Zorunlu. |
origins |
Tür:
Array<string|LatLng|LatLngLiteral|Place>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
isteğe bağlı |
Tür:
boolean optionaltrue 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 optionaltrue 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 optionaltrue 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 optionalYalnı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 optionalMü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 optionalCoğ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 optionalYalnı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 optionalMesafe 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.
Özellikler | |
|---|---|
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.
Özellikler | |
|---|---|
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.
Özellikler | |
|---|---|
distance |
Tür:
DistanceBu kalkış-varış noktası eşlemesinin mesafesi. Mesafe bilinmeyebileceğinden bu özellik tanımlanmamış olabilir. |
duration |
Tür:
DurationBu başlangıç-hedef eşlemesinin süresi. Süre bilinmeyebileceğinden bu özellik tanımlanmamış olabilir. |
duration_in_traffic |
Tür:
DurationtrafficModel ö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 |
Tür:
TransitFareBu 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");
Sabitler | |
|---|---|
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");
Sabitler | |
|---|---|
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ı. |