Mesafe Matrisi API'sini neden kullanmalısınız?
Mesafe Matrisi API'sini kullanarak birden fazla olası kalkış ve varış noktası arasındaki en verimli seyahat rotalarını belirleyebilirsiniz. Örneğin, hangi çalışanların iş sitelerine veya hangi depolardan paket gönderileceğini belirleyebilirsiniz.
Mesafe Matrisi API'si ile neler yapabilirsiniz?
Mesafe Matrisi API'si ile başlangıç noktaları ve varış noktaları için seyahat mesafesi ve süresi bilgilerini sağlayabilirsiniz. Ulaşım modunun (araba, bisiklet, toplu taşıma veya yaya gibi) yanı sıra otobüs, metro, tren, tramvay veya demiryolu gibi toplu taşıma modları gibi çeşitli seçenekler belirtebilirsiniz.
Mesafe Matrisi API'si, başlangıç ve bitiş noktaları arasında önerilen rotaya göre bilgi sağlar. Aşağıdaki tür mesafe verileri isteyebilirsiniz:
- Seçilen ulaşım şekli için mesafe
- Kilometre veya mil cinsinden mesafe
- Trafikte tahmini seyahat süresi
Mesafe Matrisi API'sinin işleyiş şekli
Mesafe Matrisi API'si, herhangi bir sayıda kaynak (başlangıç noktaları) ve hedef kullanır ve her bir başlangıç noktası ile talep edilen tüm hedefler arasındaki mesafe ve seyahat süresini döndürür. İstekteki ilk başlangıç noktasından başlayıp sonrakine adım adım devam eder.
Örneğin, isteğiniz kaynak olarak A ve B ve hedefler 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 bir hedef olacak şekilde Washington, DC ve Boston, New York City, NY, JSON biçiminde:
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 ve döndürdüğü verilerle birlikte özetlenmiştir.
Veri kaynakları | Döndürülen veriler | İade biçimi |
---|---|---|
Mesafe matrisi
Kalkış ve varış noktalarını yer kimlikleri, adresler veya enlem/boylam koordinatları biçiminde sağlayın. |
|
|
Mesafe Matrisi API'si nasıl kullanılır?
1 | Kurulumu tamamlayın. | Google Cloud projenizi oluşturun bölümüne geçin ve sonraki kurulum talimatlarını tamamlayın. |
2 | Mesafe matrisi isteğini deneme | API anahtarınız olduğunda DISTANCE Matris API'sini doğrudan tarayıcınızdan test etmeye başlayabilirsiniz. Örnekler için Başlarken kılavuzundaki Örnek istekler bölümüne bakın. |
3 | Daha karmaşık bir istek oluşturma | Birden fazla kaynak ve hedef sağlayan bir isteği deneyin. Hesaplamaları kısıtlamak için 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ızda mesafe matrisi verilerini kullanmaya hazırlanmak için veri yanıtlarını keşfedin. Ayrıntılar için Mesafe matrisi yanıtları konusuna bakın. |
5 | Mesafe matrisi verilerini kendi uygulamanıza dahil edin | 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
Java İstemcisi, Python İstemcisi, Go İstemcisi ve Google Haritalar Hizmetleri için Node.js İstemcisi, Apache 2.0 Lisansı kapsamında açık kaynaklı, topluluk tarafından desteklenen istemci kitaplıklarıdır. Bu uygulamaları GitHub'dan indirin. Burada yükleme talimatlarını ve örnek kodu da bulabilirsiniz.
Sırada ne var?
- Mesafe Matrisini kullanmaya başlayın: Başlayın’a gidin.
- Örnek istekleri 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'a gidin.