Genel bakış

Platform seçin: Android iOS JavaScript Web Hizmeti
Places API, konum verilerine yönelik HTTP isteklerini çeşitli yöntemlerle kabul eden bir hizmettir. Tesisler, coğrafi konumlar veya önemli yerlerle ilgili biçimlendirilmiş konum verilerini ve görüntüleri döndürür.

Places API'yi 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. Places API aracılığıyla kullanılabilen veriler, gerçek dünyanın en doğru, güncel ve kapsamlı yer modellerinden biri üzerine kurulmuştur. Aşağıda, uygulamalara ilişkin örnek kullanım alanları verilmiştir:

  • Özellikle şehirleri hedefleyen sonuçlarla büyük metropol bölgelerdeki kiralık apartman dairelerini görüntüleyin.
  • Teslim alma veya teslimat durumu güncellemesine yer ayrıntılarını ekleyin.
  • Bir bölgedeki parkların listesini, kullanıcıların gönderdiği fotoğraflar ve yorumlarla birlikte 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?

Aşağıdaki özellikleri uygulamalarınıza dahil etmek için Places API'yi kullanabilirsiniz:

  • Metin girişi, yakındaki konumlar ve belirsiz veya kategorik kullanıcı sorguları gibi farklı kullanıcı sorgusu türlerinden elde edilen 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 döndürülen çalışma saatleri, özet, kullanıcı yorumları ve fotoğraf gibi ayrıntıların türünü hassaslaştırın.
  • Uygulamanız tarafından hizmet verilen konumlara yüksek kaliteli fotoğraflar ekleyin.

Birçok Google Haritalar Platformu API'si, yer kimliğinin Google Rehber veritabanındaki ve Google Haritalar'daki bir yeri benzersiz şekilde tanımladığı yer kimliklerini destekler. Yer kimliğini edinmek için Places API'nin yanı sıra Geocoding API, Routes API ve Address Validation API gibi birçok yöntemden yararlanabilirsiniz.

Yer kimliğiniz olduğunda, belirli bir işletme veya önemli yer hakkında tam adres, telefon numarası, kullanıcı puanı ve yorumlar gibi daha fazla ayrıntı istemek 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. Places API (Yeni) ise API'lerin yeni nesil sürümleridir.

Places API'nin (Yeni) kullanıma sunulmasıyla birlikte ilk göreviniz, hangi API kümesinin kullanılacağına karar vermektir. Bu, yeni bir müşteriyseniz veya halihazırda API'leri 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 bir 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, istekleri /place veya /photo gibi belirli bir hizmet uç noktasına sahip 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 alakalı 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 yapılmaktadır:

https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJrTLr-GyuEmsRBfy61i59si0&fields=address_components&key=YOUR_API_KEY

Bu durumda 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 bir sürümü bulunmamaktadır. Yerini Metin Arama (Yeni) aldı.
Yakındakiler Arama Yakındakilerde 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) özelliğini 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) Önizlemede
Sorgu Otomatik Tamamlama Otomatik tamamlama (Yeni) Otomatik Tamamlama'nın Önizleme sürümüne eklenen özellikler (Yeni)

Places API nasıl kullanılır?

Aşağıdaki adımlar, Places API hizmetinin kullanımına ilişkin genel bir kullanım senaryosunu içerir. Çözümünüzü geliştirirken Yakındaki Arama ve Yer Fotoğrafları gibi ek uç noktaları kullanabilirsiniz.
1 Kurulumu yapın İlk olarak Google Cloud projenizi oluşturma başlıklı makaleyi inceleyin. Ardından, aşağıdaki kurulum talimatlarını uygulayın ve ardından API anahtarınızı nasıl kullanacağınızı öğrenin. Places API (Yeni) için OAuth jetonları da kullanabilirsiniz.
2 Basit bir 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 kullanın Birçok Google Haritalar Platformu API'si, yanıtın bir parçası olarak 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ı 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.