Places API'yi neden kullanmalısınız?
Kullanıcılarınızın ayrıntılı konum verilerine kolayca ulaşmasını sağlamak için konuma duyarlı özellikler oluşturun. Places API aracılığıyla kullanılabilen veriler, gerçek dünyadaki en doğru, güncel ve kapsamlı yer modellerinden biri temel alınarak oluşturulmuştur. Aşağıda, uygulamalara ilişkin örnek kullanım alanları verilmiştir:
- Özel olarak şehirleri hedefleyen sonuçlarla birlikte büyük metropol bölgelerdeki kiralık daireleri görüntüleyin.
- Teslim alma veya teslimat durumu güncellemesine yer ayrıntılarını ekleyin.
- Bir bölgedeki parkların listesini, kullanıcı tarafından gönderilen fotoğraflar ve yorumlarla birlikte görüntüleyin.
- Seyahat planlayan kullanıcılara, seyahat eden kuruluşlarla ilgili iletişim bilgileri, yorumlar ve fiyat seviyeleri sağlayın.
Places API ile yapabilecekleriniz
Uygulamalarınıza aşağıdaki özellikleri eklemek için Places API'yi kullanabilirsiniz:
- Metin girişi, yakındaki konumlar ve belirsiz veya kategoriye dayalı kullanıcı sorguları gibi farklı kullanıcı sorgularından yer arama sonuçları sağlayın.
- Belirli metin sorguları veya kategorik sorgular gibi farklı arama türleri için otomatik tamamlama özelliklerini etkinleştirin.
- Çalışma saatleri, özet, kullanıcı yorumları ve fotoğraf gibi, bir yer hakkında döndürülen ayrıntıların türünü daraltın.
- Uygulamanızın sunduğu konumlara yüksek kaliteli fotoğraflar ekleyin.
Birçok Google Haritalar Platformu API'si, yer kimliğinin Google Rehber veritabanında ve Google Haritalar'da bir yeri benzersiz şekilde tanımladığı yer kimliklerini destekler. Yer kimliği edinmenin birçok yolu vardır. Bunun için Places API'nin yanı sıra Geocoding API, Routes API ve Address Validation API'yi de kullanabilirsiniz.
Bir yer kimliğiniz olduğunda, belirli bir tesis veya önemli yer hakkında tam adres, telefon numarası, kullanıcı puanı ve yorumlar gibi daha ayrıntılı bilgi istemek için Places API'yi kullanabilirsiniz.
Places API sürümünüzü seçin
Places API iki API sürümünü destekler: Places API, mevcut API'ler, Places API (Yeni) ise API'lerin yeni nesil sürümleridir.
Places API'nin (Yeni) kullanıma sunulmasıyla birlikte ilk göreviniz, hangi API grubunun kullanılacağına karar vermektir. Bu durum, yeni bir müşteri veya zaten API'leri kullanan mevcut bir müşteriyseniz geçerlidir. İki API arasındaki temel farkları öğrenmek için bu rehberi kullanın.
Places API'nin işleyiş şekli
Places API (Yeni)
Places API (Yeni), istekleri /places veya places:searchText gibi belirli bir hizmet uç noktasına sahip standart bir URL olarak kabul eder ve bir JSON yanıtı döndürür. Places API (Yeni) API anahtarı ve OAuth jetonu ile yetkilendirmeyi destekler.
Aşağıdaki örnekte API anahtarı kullanarak bir yer kimliğinin adres bileşenlerini döndürmek için Yer Ayrıntısı isteğinde bulunulur:
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
Places API
Places API, istekleri /place veya /photo gibi belirli bir hizmet uç noktasına sahip standart URL'ler olarak kabul eder. Uç noktalar, istekte belirtilen biçimi (JSON veya XML) de kabul eder. Hizmet isteği, döndürülen verileri hassaslaştırmak için söz konusu uç noktayla alakalı parametreleri kullanır.
Aşağıdaki örnekte, bir yer kimliğine ilişkin adres bileşenlerini JSON biçiminde döndürmek için Yer Ayrıntısı isteğinde bulunulur:
https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJrTLr-GyuEmsRBfy61i59si0 &fields=address_components &key=YOUR_API_KEY
Bu örnekte, hizmet istenen yeri bulmak ve adres bileşenlerini JSON biçiminde döndürmek için sağlanan yer kimliğini kullanır.
Kaynaklar
Aşağıdaki tabloda, Places API üzerinden kullanılabilen kaynaklar özetlenmiştir.
| Places API | Places API (Yeni) | Not |
|---|---|---|
| Yer Bulma | Metin Arama (Yeni) | Yer Bulma uygulamasının yeni bir sürümü yok. Bunun yerini Metin Arama (Yeni) aldı. |
| Yakında Arama | Yakında Arama (Yeni) | Yakınlarda Arama (Yeni) metin girişini desteklemediğinden metin sorgusu içeren mevcut API'yi kullanan tüm istekler Metin Arama (Yeni) özelliğini kullanmalıdır. |
| Metin Arama | Metin Arama (Yeni) | |
| Yer Ayrıntıları | Yer Ayrıntıları (Yeni) | |
| Yer Fotoğrafı | Yer Fotoğrafı (Yeni) | |
| Otomatik Yer Tamamlama | Otomatik tamamlama (Yeni) | |
| Sorgu Otomatik Tamamlama | Otomatik tamamlama (Yeni) | Otomatik tamamlamaya özellikler eklendi (Yeni) |
Places API'yi kullanma
Aşağıdaki adımlar, Places API hizmetinin kullanımına ilişkin tipik bir kullanım alanı senaryosunu kapsamaktadır. Çözümünüzü geliştirirken Yakındaki Arama ve Yer Fotoğrafları gibi ek uç noktalar kullanabilirsiniz.| 1 | Kurulumu yapın | Google Cloud projenizi oluşturun bölümünü inceleyin, sonraki kurulum talimatlarını uygulayın ve API anahtarınızı nasıl kullanacağınızı öğrenin. Places API (Yeni) için OAuth jetonlarını da kullanabilirsiniz. |
| 2 | Temel metin aramasını deneyin | Metin Arama (Yeni) veya Metin Arama özelliğini kullanarak basit bir metin araması yapın. |
| 3 | Daha fazla ayrıntı için yer kimliğini kullanın | Birçok Google Haritalar Platformu API'si yanıt kapsamında bir yer kimliği döndürür. Bir yer hakkındaki ayrıntıları almak için yer kimliğini kullanın. Yer Ayrıntıları (Yeni) ve Yer Ayrıntıları bölümlerine bakın. |
| 4 | Bir yerin fotoğrafını alma | Yer Fotoğrafı hizmeti, Yerler veritabanında depolanan milyonlarca fotoğrafa erişmenizi sağlar. Bir yerin fotoğraflarına erişmek için Yer Fotoğrafı (Yeni) veya Yer Ayrıntıları seçeneğini kullanın. |