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 kullanmanın avantajları

Kullanıcılarınızın ayrıntılı konum verilerini kullanabilmesi için konum bilincine sahip ö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 durumunu güncellerken yer ayrıntılarını 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.
  • Çalışma saatleri, özet, kullanıcı yorumları ve fotoğraf gibi bir yerle ilgili döndürülen ayrıntıların türünü hassaslaştırın.
  • Uygulamanızın yayınladığı 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. Yerler API'si'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 sürümünüzü seçme

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, kullanılacak API grubuna karar vermektir. Bu durum, yeni bir müşteriyseniz veya API'leri zaten kullanıyorsanız 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), 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ı isteği gönderilmektedir:

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 bir URL olarak kabul eder. Bitiş noktaları, istekte belirtilen JSON veya XML biçimini 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ğinin adres bileşenlerini JSON biçiminde döndürmek için bir Yer Ayrıntıları isteği gönderilmektedir:

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 özetlenmiştir.

Places API Places API (Yeni) Not
Yer Bulma Metin Arama (Yeni) Yer Bul'un yeni bir sürümü yoktur. Bunun yerine Metin Arama (Yeni) özelliği kullanıma sunuldu.
Yakında Arama Yakında Arama (Yeni) Mevcut API'yi kullanan ve metin sorgusu içeren tüm istekler, metin girişini desteklemediği için Yakınımda Arama (Yeni) yerine Metin Arama (Yeni)'yi 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)
Otomatik Sorgu Tamamlama Otomatik tamamlama (Yeni) Otomatik Tamamlama'ya eklenen özellikler (Yeni)

Places API'yi kullanma

Aşağıdaki adımlar, Places API hizmetini kullanmayla ilgili tipik bir kullanım alanı senaryosudur. Çözümünüzü geliştirirken Yakındaki Arama ve Yer Fotoğrafları 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. Places API (Yeni) için OAuth jetonlarını da kullanabilirsiniz.
2 Temel metin aramayı deneyin Metin Arama (Yeni) veya Metin Arama'yı 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. Bir yer hakkında ayrıntılı bilgi edinmek için yer kimliğini kullanın. Yer Ayrıntıları (Yeni) ve Yer Ayrıntıları başlıklı makaleleri inceleyin.
4 Bir yer için fotoğraf alma Yer Fotoğrafları hizmeti, Yerler veritabanında depolanan milyonlarca fotoğrafa erişim sağlar. Bir yerin fotoğraflarına erişmek için Yer Fotoğrafı (Yeni) veya Yer Ayrıntıları'nı kullanın.