Places API'yi neden kullanmalısınız? (Yeni)
Kullanıcılarınıza ayrıntılı konum verilerini sunmak için konuma duyarlı özellikler oluşturun. Places API (Yeni) üzerinden sunulan veriler, gerçek dünyanın en doğru, güncel ve kapsamlı yer modellerinden birine dayanır. Uygulamalar için örnek kullanım alanları:
- Özellikle şehirleri hedefleyen sonuçlarla büyük metropol alanlarındaki kiralık daireleri gösterin.
- Aktarımı veya teslimatı yapan yerle ilgili ayrıntıları ekleyin.
- Kullanıcılar tarafından gönderilen fotoğraf ve yorumlarla birlikte bir bölgedeki parkların listesini gösterin.
- Seyahat planlayan kullanıcılara, yol üzerindeki tesislerin iletişim bilgilerini, yorumlarını ve fiyat seviyelerini sağlayın.
Places API (Yeni) ile neler yapabilirsiniz?
Uygulamalarınıza aşağıdaki özellikleri eklemek için Places API'yi (yeni) kullanabilirsiniz:
- Metin girişi, yakın 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 yerle ilgili çalışma saatleri, özet, kullanıcı yorumları ve fotoğraf gibi döndürülen ayrıntıların türünü hassaslaştırın.
- Uygulamanızın sunduğu konumlara yüksek kaliteli fotoğraflar ekleyin.
Birçok Google Haritalar Platformu API'si yer kimliklerini destekler. Yer kimliği, Google Rehber veritabanında ve Google Haritalar'da bir yeri benzersiz şekilde tanımlar. Yer kimliği elde etmenin birçok yolu vardır. Örneğin, Places API (Yeni)'nin yanı sıra Geocoding API, Routes API ve Address Validation API'den de yer kimliği alabilirsiniz.
Yer kimliğiniz olduktan sonra, belirli bir tesis veya önemli yer hakkında daha fazla ayrıntı (ör. tam adres, telefon numarası, kullanıcı puanı ve yorumlar) istemek için Places API'yi (Yeni) kullanabilirsiniz.
Places API'nin (Yeni) işleyiş şekli
Places API (Yeni), isteklerini /places veya places:searchText gibi belirli bir hizmet uç noktasına sahip standart bir URL olarak kabul eder ve JSON yanıtı döndürür.
Places API (Yeni), API anahtarı ve OAuth jetonu ile yetkilendirmeyi destekler.
Aşağıdaki örnekte, API anahtarı kullanılarak bir yer kimliğinin adres bileşenlerini döndürmek için Yer Ayrıntıları (Yeni) isteği gönderilmektedir:
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
Places API'yi kullanma (Yeni)
Aşağıdaki adımlar, Places API hizmetinin kullanımıyla ilgili tipik bir kullanım alanı senaryosudur. Çözümünüzü geliştirirken Yakındakiler Arama (Yeni) ve Yer Fotoğrafları (Yeni) gibi ek uç noktalar kullanabilirsiniz.| 1 | Kurulum | Google Cloud projenizi oluşturma ile başlayın ve ardından gelen kurulum talimatlarını tamamlayın. Ardından API anahtarınızı nasıl kullanacağınızı öğrenin. |
| 2 | Temel metin aramayı deneyin | Metin Arama (Yeni)'yi kullanarak metin araması yapın. |
| 3 | Daha fazla bilgi için yer kimliğini kullanın | Birçok Google Haritalar Platformu API'si, yanıtın bir parçası olarak yer kimliği döndürür. Yer Ayrıntıları (Yeni)'nı almak için yer kimliklerini kullanın. |
| 4 | Bir yer için fotoğraf alma | Yer Fotoğrafları (Yeni), Yerler veritabanında depolanan milyonlarca fotoğrafa erişmenizi sağlar. Bir yerin fotoğraflarına erişmek için Yer Fotoğrafları (Yeni)'ni kullanın. |