Yerler API'sini neden kullanmalısınız?
Ayrıntılı konum verilerine kullanıcılarınızın kolayca erişebilmesi için konuma duyarlı özellikler oluşturun. Yerler API'si aracılığıyla sunulan veriler, gerçek dünyanın en doğru, güncel ve kapsamlı yer modellerinden biri temel alınarak oluşturulur. Aşağıda, uygulamalara ilişkin örnek kullanım alanları verilmiştir:
- Büyükşehir bölgelerindeki kiralık daireleri özel olarak şehirleri hedefleyen sonuçlarla birlikte görüntüleyin.
- Teslim alma veya teslimat durumu güncellemesine yer ayrıntılarını ekleyin.
- Kullanıcıların gönderdiği fotoğraflar ve yorumlarla birlikte bir bölgedeki parkların listesini görüntüleyin.
- Seyahat planlayan kullanıcılara yol boyunca işletmelerinin iletişim bilgilerini, yorumlarını ve fiyat düzeylerini sağlayın.
Places API ile neler yapabilirsiniz?
Yerler API'sini uygulamalarınıza aşağıdaki özellikleri eklemek için kullanabilirsiniz:
- Metin girişi, yakındaki konumlar ve belirsiz veya kategorik kullanıcı sorguları gibi farklı türde 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.
- Bir yer hakkında verilen çalışma saatleri, özet, kullanıcı yorumları ve fotoğraf gibi ayrıntıları daha hassas hale getirin.
- Uygulamanız tarafından sunulan 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 bir şekilde tanımladığı yer kimliklerini destekler. Yer kimliğini almanın Places API'sinin yanı sıra Geocoding API, Routes API ve Address Validation API gibi birçok yolu vardır.
Yer kimliğine sahip olduktan sonra, belirli bir kuruluş veya önemli yer hakkında tam adres, telefon numarası, kullanıcı puanı ve yorumlar gibi daha fazla ayrıntı talep etmek 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'lerdir ve Places API (Yeni) 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üşteriyseniz veya API'leri halihazırda kullanan mevcut bir müşteriyseniz geçerlidir. İki API arasındaki temel farkları öğrenmek için bu kılavuzu 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 URL olarak kabul eder ve bir JSON yanıtı döndürür. Places API (Yeni), API anahtarı ve OAuth jetonuyla yetkilendirmeyi destekler.
Aşağıdaki örnekte, API anahtarı kullanarak bir yer kimliğine ilişkin adres bileşenlerini döndürmek için bir Yer Ayrıntısı isteği kullanılmaktadır:
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
Places API
Places API, /place veya /photo gibi belirli bir hizmet uç noktasına sahip olan istekleri standart URL olarak kabul eder. Uç noktalar da istekte belirtilen biçim türünü (JSON veya XML) kabul eder. Hizmet isteği, döndürülen verileri hassaslaştırmak için söz konusu uç noktayla ilgili parametreleri kullanır.
Aşağıdaki örnekte bir yer kimliğine ilişkin adres bileşenlerini JSON biçiminde döndürmek için bir Yer Ayrıntısı isteği kullanılmaktadır:
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 aracılığıyla kullanılabilen kaynaklar özetlenmektedir.
| Places API | Places API (Yeni) | Not |
|---|---|---|
| Yer Bulma | Metin Arama (Yeni) | Yer Bulma uygulamasının yeni sürümü mevcut değil. Yerini Metin Arama (Yeni) aldı. |
| Yakındakileri Arama | Yakındakilerle Arama (Yeni) | Yakındaki Arama (Yeni) metin girişini desteklemediğinden metin sorgusu içeren mevcut API'yi kullanan tüm istekler Metin Arama (Yeni) yöntemini 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 | Places API (Yeni) sürümü yok | |
| Sorgu Otomatik Tamamlama | Places API (Yeni) sürümü yok |
Places API'yi kullanma
Aşağıdaki adımlar, Places API hizmetinin kullanımına ilişkin tipik bir kullanım 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şturma ile başlayın, aşağıdaki kurulum talimatlarını tamamlayın ve ardından API anahtarınızı nasıl kullanacağınızı öğrenin. Places API (Yeni) için OAuth jetonları da kullanabilirsiniz. |
| 2 | Temel metin araması yapmayı 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 kullanma | Birçok Google Haritalar Platformu API'si, yanıtın parçası olarak bir yer kimliği döndürür. Bir yerle ilgili ayrıntıları almak için yer kimliğini kullanın. Yer Ayrıntıları (Yeni) ve Yer Ayrıntıları konularına bakın. |
| 4 | Bir yerin fotoğrafını çekme | 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. |