Genel bakış

Platform seçin: Android iOS JavaScript Web Hizmeti
Places API, çeşitli yöntemler aracılığıyla konum verileri için HTTP isteklerini kabul eden bir hizmettir. Tesisler, coğrafi konumlar veya önemli turistik yerler hakkında biçimlendirilmiş konum verileri ve görüntüler döndürür.

Places API'yi neden kullanmalısınız?

Kullanıcılarınızın ayrıntılı konum verilerine erişebilmesi için konuma duyarlı özellikler oluşturun. Places API üzerinden sunulan veriler, gerçek dünyadaki en doğru, güncel ve kapsamlı yer modellerinden birine dayanır. Uygulamalar için örnek kullanım alanları:

  • Büyük metropol bölgelerindeki kiralık daireleri, özellikle şehirleri hedefleyen sonuçlarla gösterin.
  • Aktarımı veya teslimatı gerçekleştiren yerle ilgili ayrıntıları ekleyin.
  • Kullanıcıların gönderdiği 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 ile neler yapabilirsiniz?

Uygulamalarınıza aşağıdaki özellikleri eklemek için Places API'yi 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 döndürülen ayrıntıların türünü (ör. çalışma saatleri, özet, kullanıcı yorumları ve fotoğraf) 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'nin yanı sıra Geocoding API, Routes API ve Address Validation API'den de yer kimliği alabilirsiniz.

Bir yer kimliğiniz olduğunda, 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 Yerler API'yi kullanabilirsiniz.

Places API'nin (Yeni) işleyiş şekli

Places API (Yeni), isteklerini /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, 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

Aşağıdaki adımlar, Places API hizmetinin kullanılmasıyla ilgili tipik bir kullanım alanı senaryosudur. Çözümünüzü geliştirirken Yakındakiler Arama (Yeni) ve Yer Fotoğrafı (Yeni) gibi ek uç noktalar kullanabilirsiniz.
1 Kurulum Google Cloud projenizi oluşturma ile başlayın ve sonraki 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 bir yer kimliği döndürür. Yer Ayrıntıları (Yeni)'ni almak için yer kimliklerini kullanın.
4 Bir yer için fotoğraf alma Yer Fotoğrafı (Yeni) 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)'yi kullanın.