Mesafe Matrisi API'sini neden kullanmalısınız?
Birden fazla olası başlangıç ve varış noktası arasındaki en verimli seyahat rotalarını belirlemenize yardımcı olması için Uzaklık Matrisi API'sini kullanabilirsiniz. Örneğin, hangi çalışanların iş sahalarına veya hangi depolardan paket gönderileceği gibi.
Mesafe Matrisi API'si ile neler yapabilirsiniz?
Mesafe Matrisi API'si ile kalkış ve varış noktaları matrisi için seyahat mesafesi ve süresi sağlayabilirsiniz. Araba, bisiklet, toplu taşıma veya yürüyüş gibi ulaşım şeklinin yanı sıra otobüs, metro, tren, tramvay veya demiryolu gibi toplu taşıma modlarını da 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çili 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 herhangi bir sayıda kalkış noktası (başlangıç noktası) ve varış noktası kullanır. İstekteki ilk başlangıç noktasından başlayıp sonrakine adım adım devam ederek her kalkış noktası ile istenen tüm hedefler arasındaki mesafe ve seyahat süresini döndürür.
Örneğin, isteğiniz başlangıç noktası 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 istek gösterilmektedir: Washington, DC ve Boston, tek hedef olarak New York City, NY ve JSON biçimindedir:
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 aracılığıyla kullanılabilen kaynaklar, döndürdüğü verilerle birlikte özetlenmiştir.
Veri kaynakları | Döndürülen veriler | Dönüş 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 ile başlayın ve aşağıdaki kurulum talimatlarını tamamlayın. |
2 | Mesafe matrisi isteğini deneme | API anahtarınız hazır olduğunda, Distance Matrix API'yi 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şturma | Birden fazla başlangıç noktası ve hedef sağlayan bir isteği deneyin. Belirtilen kalkış saati veya rota kısıtlamaları gibi hesaplamaları sınırlandırmak için kullanılan isteğe bağlı parametreler hakkında bilgi edinin. Mesafe Matrisi istek ve yanıt kılavuzundaki İsteğe bağlı parametreler'e bakın. |
4 | Yanıtlarla ilgili temel bilgileri anlama | Uygulamanız için mesafe matrisi verilerini kullanmaya hazırlanmak amacıyla veri yanıtlarını inceleyin. Ayrıntılar için Mesafe matrisi yanıtları bölümüne bakın. |
5 | Mesafe matrisi verilerini kendi uygulamanıza ekleyin! | Bu verileri, seyahat mesafesini ve süresini hesaplamak için kullanabilirsiniz. |
Kullanılabilir istemci kitaplıkları
Aşağıdaki istemci kitaplıklarından biri aracılığıyla 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 Go İstemcisi
- Google Haritalar Hizmetleri için Node.js İstemcisi
Google Haritalar Hizmetleri için Java İstemcisi, Python İstemcisi, Go İstemcisi ve Node.js İstemcisi, Apache 2.0 Lisansı altında açık kaynaklı, topluluk tarafından desteklenen istemci kitaplıklarıdır. Bunları, kurulum talimatlarını ve örnek kodu da bulabileceğiniz GitHub'dan indirin.
Sırada ne var?
- Mesafe Matrisi'ni kullanmaya başlama: Başlarken bölümüne gidin.
- Örnek istekler ve yanıtlar kullanmaya başlama: Mesafe Matrisi istek ve yanıtı bölümüne gidin
- En iyi uygulamaları takip edin: Web Hizmeti En İyi Uygulamaları'na gidin.