Genel bakış

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

Yerler API'sini neden kullanmalısınız?

Ayrıntılı konum verilerini kullanıcılarınıza kolayca sunmak için konuma duyarlı özellikler oluşturun. Yerler API'si üzerinden sağlanan veriler, gerçek dünyanın en doğru, güncel ve kapsamlı yer modellerinden birine dayanır. Aşağıda uygulamaların kullanım örnekleri verilmiştir:

  • Büyük şehirlerdeki apartman dairelerini özel olarak şehirleri hedefleyerek gösterin.
  • 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 yorumları gösterir.
  • Seyahat planlaması yapan kişilere, iletişim bilgileri, yorumlar ve yol üzerindeki tesisler için fiyat seviyeleri sağlayın.

Yerler API'si ile yapabilecekleriniz

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

  • Metin girişi, yakındaki konumlar ve belirsiz ya da kategorik kullanıcı sorguları gibi farklı kullanıcı sorguları türlerinden yer arama sonuçları sağlayın.
  • Belirli metin sorguları veya kategorik sorgular için farklı arama türlerinde otomatik tamamlama özelliklerini etkinleştirin.
  • Çalışma saatleri, özet, kullanıcı yorumları ve bir fotoğraf gibi bir yer hakkında döndürülen ayrıntı türünü hassaslaştırın.
  • Uygulamanızın sunduğu konumlara yüksek kaliteli fotoğraflar ekleyin.

Yerler API'si nasıl çalışır?

Yerler API'si, istekleri /place veya /photo gibi belirli bir hizmet uç noktası içeren standart URL olarak kabul eder. Uç noktalar, istekte belirtilen biçim türünü de (JSON veya XML) kabul eder. Son olarak, hizmet isteği döndürülen verileri hassaslaştırmak için bu uç noktayla ilgili parametreleri kullanır. Örneğin, adres bileşenleri için aşağıdaki Yer Ayrıntıları isteği aşağıdaki biçimde çalışır: JSON biçiminde bir getiri: 

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 için adres kimliğini kullanır ve adres bileşenlerini JSON biçiminde döndürür.

Kaynaklar

Aşağıdaki tabloda, Yerler API'si aracılığıyla kullanılabilen kaynaklar ve döndürdüğü veriler özetlenmektedir.

Veri kaynakları Veri döndürüldü Dönüş biçimi
Yer arama Cihaz konumuna veya arama dizesine göre yer listesi döndürür.

Yer arama yanıtları, Yakındaki arama yanıtları ve Metin arama yanıtları ile ilgili ayrıntıları görün.

  • JSON
  • XML
Yer ayrıntıları Kullanıcı yorumları da dahil olmak üzere belirli bir yer hakkında daha ayrıntılı bilgiler döndürür.

Ayrıntılar için Yer ayrıntıları yanıtları bölümüne bakın.

  • JSON
  • XML
Yer fotoğrafları Google'ın Yer veritabanında depolanan milyonlarca alakalı fotoğrafa erişim sağlar.

Yer fotoğraflarıyla ilgili ayrıntılara göz atın.

  • JSON
  • XML
Otomatik tamamlama Kullanıcı yazarken bir yerin adını ve/veya adresini otomatik olarak doldurur.

Otomatik tamamlama yanıtları ile ilgili ayrıntıları inceleyin.

  • JSON
  • XML
Otomatik sorgu tamamlama Metin tabanlı coğrafi aramalar için, kullanıcılar yazarken önerilen sorguları döndüren bir sorgu tahmin hizmeti sağlar.

Sorgu otomatik tamamlama yanıtları ile ilgili ayrıntıları inceleyin.

  • JSON
  • XML

Yerler API'sini kullanma

Aşağıdaki adımlarda, Yerler API'si hizmetindeki uç noktalardan üçünün kullanımıyla ilgili tipik bir kullanım alanı senaryosu ele alınmaktadır. Çözümünüzü oluştururken Yakındaki Arama, Yer Fotoğrafları ve Sorgu Otomatik Tamamlama gibi ek uç noktalar kullanabilirsiniz.
1 Kurulumu gerçekleştirme İlk olarak Google Cloud projenizi oluşturun ve aşağıdaki kurulum talimatlarını tamamlayıp API anahtarınızı nasıl kullanacağınızı öğrenin.
2 Temel metin araması deneme Bir API anahtarınız olduktan sonra Metin arama kılavuzundaki Temel metin arama örneklerinde belirtildiği gibi basit bir metin araması yapın.
3 Yer Bulma isteği kullanma Yer Bulma istekleri; çalışma saatleri, adres ve fotoğraflar gibi istediğiniz veri alanlarının yanı sıra bir yer kimliği döndürür. Yer örneklerini bulma konusunu inceleyin ve kullanım alanınızla daha alakalı bir örnek deneyin.
4 Yer Bulma yanıtı ile ilgili temel bilgileri anlama Yer Bulma yanıtından döndürülen verileri keşfedin. Ayrıntılı bilgi için Yer yanıtlarını bulma başlıklı makaleye bakın.
5 Daha fazla ayrıntı için yer kimliğini kullanın Yer Bulma yanıtları, belirli bir yer için mevcut olan tüm verileri sağlamaz. Bir yer hakkında daha da fazla bilgi almak için Yer Bulma yanıtından döndürülen yer kimliğini kullanabilirsiniz. Yer Ayrıntıları bölümünü inceleyin.

Kullanılabilir istemci kitaplıkları

Aşağıdaki istemci kitaplıklarından birini kullanarak bu API'yi istediğiniz dilde çağırın:

Google Haritalar Hizmetleri için Java İstemcisi, Python İstemcisi, Go İstemcisi ve Node.js İstemcisi, Apache 2.0 Lisansı ile açık kaynaklı, topluluk tarafından desteklenen istemci kitaplıklarıdır. Kurulum talimatlarını ve örnek kodu da bulabileceğiniz GitHub'dan indirin.

Sırada ne var?