Mesafe Matrisi API'sini neden kullanmalısınız?
Birden çok olası başlangıç ve varış noktası arasındaki en verimli seyahat rotalarını belirlemenize yardımcı olması için Mesafe Matrisi API'sini kullanabilirsiniz. Örneğin, hangi çalışanların iş sahalarına gönderileceği veya hangi depolardan paket gönderileceği gibi.
Mesafe Matrisi API'si ile neler yapabilirsiniz?
Mesafe Matrisi API'sini kullanarak kalkış ve varış noktaları için seyahat mesafesi ve süresi sağlayabilirsiniz. Araba, bisiklet, toplu taşıma veya yürüyüş gibi ulaşım şekillerinin yanı sıra otobüs, metro, tren, tramvay veya demiryolu gibi toplu taşıma modları da dahil olmak üzere çeşitli seçenekleri belirtebilirsiniz.
Mesafe Matrisi API'si, başlangıç ve varış noktaları arasındaki önerilen rotaya göre bilgi sağlar. Aşağıdaki tür mesafe verilerini isteyebilirsiniz:
- Seçilen ulaşım şekli için mesafe
- Kilometre veya mil cinsinden mesafe
- Trafikteki tahmini seyahat süresi
Mesafe Matrisi API'sinin işleyiş şekli
Mesafe Matrisi API'si istediğiniz sayıda kalkış (başlangıç noktası) ve varış noktası kullanır. İstekteki ilk kalkış noktasından başlayıp sonrakine adım adım devam ederek her bir kalkış noktası ile istenen tüm hedefler arasındaki mesafe ve seyahat süresini döndürür.
Örneğin, isteğiniz kaynak olarak A ve B, varış noktası olarak C ve D'yi belirtiyorsa mesafeleri ve seyahat süresini şu sırayla döndürür:
- A'dan C'ye
- A'dan D'ye
- B'den C'ye
- B'den D'ye
Aşağıdaki örnekte iki kaynak için bir istek gösterilmektedir: Tek hedefli Washington, DC ve Boston, JSON biçiminde New York City, NY:
https://maps.googleapis.com/maps/api/distancematrix/json ?destinations=New%20York%20City%2C%20NY &origins=Washington%2C%20DC%7CBoston &units=imperial &key=YOUR_API_KEY
Kaynaklar
Aşağıdaki tabloda, Mesafe Matrisi API'si üzerinden kullanılabilen kaynaklar, döndürdüğü verilerle birlikte özetlenmektedir.
|Veri kaynakları||Döndürülen veriler||İade biçimi|
|Mesafe matrisi


Başlangıç ve varış noktalarını yer kimlikleri, adresler veya enlem/boylam koordinatları biçiminde sağlayın.


Mesafe Matrisi API'sini kullanma
|1||Hazırlanın.||Google Cloud projenizi oluşturma işlemiyle başlayın ve aşağıdaki kurulum talimatlarını tamamlayın.|
|2||Mesafe matrisi isteğini deneyin||API anahtarınızı oluşturduktan sonra Mesafe Matrisi API'sini doğrudan tarayıcınızdan test etmeye başlayabilirsiniz. Örnekler için Başlangıç kılavuzundaki Örnek istekler bölümüne bakın.|
|3||Daha karmaşık bir istek oluşturun||Birden fazla kalkış ve hedef sağlayan bir isteği deneyin. Hesaplamaları sınırlandırmak için kullanılan, belirtilen kalkış saati veya rota kısıtlamaları gibi isteğe bağlı parametreler hakkında bilgi edinin. Mesafe Matrisi istek ve yanıtı kılavuzundaki İsteğe bağlı parametreler bölümüne bakın.|
|4||Yanıtlarla ilgili temel bilgileri anlama||Uygulamanız için mesafe matrisi verilerini kullanmaya hazırlanmak üzere veri yanıtlarını inceleyin. Ayrıntılı bilgi için Mesafe matrisi yanıtları bölümüne bakın.|
|5||Mesafe matrisi verilerini kendi uygulamanıza dahil edin!||Bu verileri kullanarak seyahat mesafesini ve süresini hesaplayabilirsiniz.|
Kullanılabilir istemci kitaplıkları
Aşağıdaki istemci kitaplıklarından birini kullanarak bu API'yi istediğiniz dilde çağırın:
- Google Haritalar Hizmetleri için Java İstemcisi
- Google Haritalar Hizmetleri için Python İstemcisi
- Google Haritalar Hizmetleri için İstemciye Git
- Google Haritalar Hizmetleri için Node.js İstemcisi
Java İstemcisi, Python İstemcisi, Go İstemcisi ve Google Haritalar Hizmetleri için Node.js İstemcisi, Apache 2.0 Lisansı altında açık kaynaklı, topluluk tarafından desteklenen istemci kitaplıklarıdır. Bunları GitHub'dan indirin. Burada kurulum talimatlarını ve örnek kodu da bulabilirsiniz.