Giriş
Places API, çeşitli yöntemlerle konum verileri için HTTP isteklerini kabul eden bir hizmettir. İşletmeler, coğrafi konumlar veya önemli ilgi çekici yerler hakkında biçimlendirilmiş konum verileri ve görüntüler döndürür.Places API (Yeni) neden kullanılmalı?
Kullanıcılarınıza ayrıntılı konum verileri sunmak için konuma duyarlı özellikler oluşturun. Places API (Yeni) aracılığıyla 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.
- Alım veya teslimat durumu güncellemesine Yer Ayrıntılarını ekleyin.
- Bir bölgedeki parkların listesini, kullanıcılar tarafından gönderilen fotoğraflar ve yorumlarla birlikte gösterin.
- Seyahat planlayan kullanıcılara yol üzerindeki tesislerin iletişim bilgilerini, yorumlarını ve fiyat seviyelerini gösterir.
Places API (Yeni) ile yapabilecekleriniz
Uygulamalarınıza aşağıdaki özellikleri eklemek için Places API (New) hizmetini kullanabilirsiniz:
- Metin girişi, yakındaki konumlar ve belirsiz veya kategorik kullanıcı sorguları gibi farklı türlerdeki kullanıcı sorgularından yer arama sonuçları sağlama.
- Farklı arama türleri için otomatik tamamlama özelliklerini etkinleştirin. Bu özellikler, belirli metin sorguları veya kategorik sorgular için kullanılabilir.
- Bir yer hakkında döndürülen ayrıntı türünü (ör. çalışma saatleri, özet, kullanıcı yorumları ve fotoğraf) hassaslaştırın.
- Uygulamanızın hizmet verdiği konumlara yüksek kaliteli fotoğraflar ekleyin.
Birçok Google Haritalar Platformu API'si, yer kimliklerini destekler. Yer kimliği, Google Places veritabanında ve Google Haritalar'da bir yeri benzersiz şekilde tanımlar. Yer kodu edinmenin birçok yolu vardır. Örneğin, Places API (Yeni)'nin yanı sıra Routes API ve Address Validation API'den de yer kodu edinebilirsiniz.
Yer kimliğiniz olduğunda, belirli bir tesis veya ilgi çekici nokta hakkında daha fazla ayrıntı (ör. tam adresi, telefon numarası, kullanıcı puanı ve yorumları) istemek için Places API (Yeni) kullanabilirsiniz.
Places API (Yeni) işleyiş şekli
Places API (Yeni), istekleri /places veya places:searchText gibi belirli bir hizmet uç noktası içeren 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, bir API anahtarı kullanarak yer kimliğinin adres bileşenlerini döndürmek için Yer Ayrıntıları (Yeni) isteği gönderilir:
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
Places API (Yeni) nasıl kullanılır?
Aşağıdaki adımlarda, Places API hizmetinin kullanımına ilişkin tipik bir kullanım alanı senaryosu ele alınmaktadır. Çözümünüzü geliştirirken Yakında Arama (Yeni) ve Yer Fotoğrafları (Yeni) gibi ek uç noktaları kullanabilirsiniz.| 1 | Kurulum | Faturalandırmayı ayarlayın, Places API (Yeni)'yi etkinleştirin ve ilk isteğinizi gönderin. |
| 2 | Temel bir metin araması yapmayı deneyin | Metin Arama (Yeni)'yı kullanarak metin araması yapın. |
| 3 | Daha fazla bilgi için yer kimliğini kullanma | 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) almak için yer kimliklerini kullanın. |
| 4 | Bir yerin fotoğrafını 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)'nı kullanın. |