Google Places API’yi Nasıl Kullanırsınız ve API Anahtarını Nasıl Edinebilirsiniz

Google Places API nedir?

API’da beş tür istek mevcut. Bunlar şunlardır:

• Mekan Arama kullanıcı konumuna veya arama metnine göre mekanların bir listesini döndürür.
• Mekan ayrıntıları belirli bir yer hakkında ayrıntılı bilgiler ve kullanıcı yorumları içerir.
• Yer Fotoğrafları Google’ın Place veritabanında saklanan milyonlarca mekanla ilgili fotoğrafa erişim sağlar.
• Yer İncelemeleri ile platformdan Google yorumlarına ulaşabilir ve Google yorumlarını sitenize gömebilirsiniz.
• Yer Otomatik Tamamlama kullanıcılar yazarken bir yerin adını veya adresini otomatik olarak doldurmak için vardır.
• Arama Önerisi Tamamlama metin tabanlı coğrafi aramalar için sorgu tahmini hizmeti sunar; kullanıcı yazarken önerilen sorgular görüntülenir.

Google Places API Anahtarı Nasıl Oluşturulur

API anahtarı, kullanım ve faturalandırma amacıyla projeyle ilişkilendirilmiş istekleri kimlik doğrulamak için kullanılan benzersiz bir tanımlayıcıdır. API anahtarını kullanarak istekleri doğrularken şu avantajları elde edersiniz:

• Google Cloud Console’daki API’lerinizi yönetin.
• Google Cloud Platform Konsolu’ndan gerçek zamanlı kullanım verilerine ve son 30 günlük tarihsel kullanım verilerine erişin.
• Google Cloud Destek Portalı’nda 30 günden daha uzun bilgileri içeren kullanım raporlarını inceleyin.

Web sitenize müşteri yorumları eklemenin alternatif bir yolunu her zaman deneyebilirsiniz. Örneğin Elfsight’in Google Yorumlar widget’ı var — API anahtarları edinmek veya kod yazmayı öğrenmek zorunda değilsiniz.

Yerler API anahtarınızı alın ve isteğinize ekleyin

API anahtarınızı almak için şu adımları uygulamanız gerekir:

• Google Cloud Platform Konsolu’nu açın.
• Projeyi açılır menüden seçin ve sizin için oluşturulan projeyi seçin. Adı Google Maps APIs for Business veya Google Maps for Work ya da Google Maps ile başlamalıdır.
• Menü düğmesine tıklayın ve API’ler ve Hizmetler > Kimlik Bilgileri’ni seçin.
• Kimlik Bilgileri sayfasında Oluştur > API anahtarı’nı seçin. Burada yeni oluşturulan anahtarınızın gösterildiği bir API anahtarı oluşturuldu iletişim kutusunu göreceksiniz.
• Sekmeyi kapatın. Yeni API anahtarınız, API anahtarları bölümündeki kimlik bilgileri sayfasında listeleniyor.

Ardından tüm Places API isteklerine API anahtarını eklemeniz gerekir. Aşağıdaki örnekte, sadece YOUR_API_KEY’i anahtarınızla değiştirin:

https://maps.googleapis.com/maps/api/place/nearbysearch/json
  ?location=-33.8670522,151.1957362
  &radius=500
  &types=food
  &name=harbour
  &key=YOUR_API_KEY

Google’ın API anahtarınızı kısıtlamanızı şiddetle önerdiğini unutmayın. Kısıtlamalar güvenliği artırır ve API anahtarınızla yalnızca yetkili isteklerin yapılmasını sağlar.

Google Places API anahtarınızı nasıl kısıtlayabilirsiniz

• Uygulama kısıtlaması. Bu özellik, API anahtarının kullanımını yalnızca web sitelerine, web sunucularına veya mobil uygulamalara sınırlamanıza olanak tanır. Bu kategoriden seçilebilecek tek bir kısıtlama vardır.
• API Kısıtlaması. Bu tür bir kısıtlama, API anahtarının kullanımını bir veya daha fazla API veya SDK ile sınırlar.

API anahtarınızı sınırlamak için şu adımları izlemeniz gerekir:

• Google Cloud Console’ı açın.
• Projeyi açılır menüden tıklayın ve güvenliğini sağlamak istediğiniz API anahtarını içeren projeyi seçin.
• Menü düğmesine tıklayın ve API’ler ve Hizmetler > Kimlik Bilgileri’ni seçin.
• Güvence altına almanız gereken API anahtarının adına Kimlik Bilgileri sayfasında tıklayın.
• API anahtarını kısıtla ve yeniden adlandır sayfasında kısıtlamaları ayarla.

Google Places API Kullanımı: Örnekler

Google Places API’yi kullanmanın birkaç yolu vardır. Bazılarını görelim.

Mekan Arama

Yukarıda belirtildiği gibi, Places API çok sayıda kategori kullanarak yer bilgisi aramanıza olanak tanır. Aşağıdaki Google Places API örneği, “Museum of Contemporary Art Australia” için Find Place isteğini göstermektedir:

https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=photos,formatted_address,name,rating,opening_hours,geometry&key=YOUR_API_KEY

Yer Detayları

Google Places Araması’ndan place_id aldığınızda, belirli bir işletme veya ilgi noktası hakkında daha fazla bilgi edinmek için Place Details isteği başlatabilirsiniz. Burada place_id ile bir yerin ayrıntılarını gösteren bir istek görüyoruz:

https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name,rating,formatted_phone_number&key=YOUR_API_KEY

Yer Fotoğrafları

Bu hizmet, uygulamalarınıza fotoğraf içeriği eklemenize olanak tanır. Places veritabanında depolanan milyonlarca fotoğrafa erişim sağlar. İşte bir örnek istek:

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photoreference=CnRtAAAATLZNl354RwP_9UKbQ_5Psy40texXePv4oAlgP4qNEkdIrkyse7rPXYGd9D_Uj1rVsQdWT4oRz4QrYAJNpFX7rzqqMlZw2h2E2y5IKMUZ7ouD_SlcHxYq1yL4KbKUv3qtWgTK0A6QbGh87GB3sscrHRIQiG2RrmU_jF4tENr9wGS_YxoUSSDrYjWmrNfeEHSGSc3FyhNLlBU&key=YOUR_API_KEY

Yer Otomatik Tamamlama

HTTP isteğine yanıt olarak yer tahminleri döndüren bir web hizmetidir. Metin tabanlı coğrafi aramalarda otomatik tamamlama işlevi sunabilir. İşletmeler için bir istek örneği aşağıdadır:

https://maps.googleapis.com/maps/api/place/autocomplete/xml?input=Amoeba&types=establishment&location=37.76999,-122.44696&radius=500&key=YOUR_API_KEY

Sorgu Tamamlama

Bu tür hizmet, kullanıcı yazarken metin tabanlı coğrafi aramalar için sorgu öngörüleri sunmak amacıyla kullanılır. Örnek bir istek şu şekildedir:

https://maps.googleapis.com/maps/api/place/queryautocomplete/json?key=YOUR_API_KEY&input=pizza+near%20par

Google Places API fiyatlandırması ve sınırları

Burada Google, kullanım başına ödeme (pay-as-you-go) bir fiyatlandırma modeli kullanır. Bu, Google Maps Platform API’lerinin SKU başına faturalandırıldığı anlamına gelir. Kullanım, her Ürün SKU için izlenir ve bir API birden fazla Ürün SKU’ya sahip olabilir.

Günlük 24 saat içinde 1.000 ücretsiz Places API sorgusu bulunur; ancak Google Cloud Console’da Faturalandırmayı Etkinleştirerek 24 saat için bu miktarı 150.000 ücretsiz sorguya çıkarabilirsiniz.

Google Places API belgelerini inceleyerek tüm fiyatlandırma ve sınırlar hakkında daha fazla ayrıntıya ulaşabilirsiniz. dokümantasyon

SSS (Sık Sorulan Sorular)

Sonuç

Makale tarafından

Valeriya Polyakova

İçerik Yöneticisi

Elfsight’te İçerik Yöneticisi olarak, hem pratik hem de ilham veren içerikler üretmeye odaklanıyorum. Karmaşık olanları basitleştirmeyi ve okunabilirliği keyifli kılmayı seviyorum.

Facebook’ta takip edin

X’te Takip Et

LinkedIn’de Takip Et

Reddit’te takip edin