Google Haritalar Yorumlar API’si ile Çalışma

Bu makalede, Google API yardımıyla incelemeleri nasıl elde edeceğinizi öğreneceğiz. Burada bunları kendi uygulamanızda nasıl kullanacağınıza dair talimatlar bulacaksınız.
ChatGPT’in ne düşündüğünü gör Canlı Widget Düzenleyicisini Aç
Tarafından
Working with Google Maps Reviews API

Adım 1. Google Maps Platformu ile Çalışmaya Başlayın

Web siteniz için uygulamanızı kurmaya başlayalım. Öncelikle, Google Yorumlar projenize daha sonra bağlayacağınız bir faturalandırma hesabı oluşturmanız gerekiyor.

  1. Şuraya gidin: Google Cloud Platform Console
  2. Menü düğmesine tıklayın ve Faturalandırma seçin
  3. Tıklayarak devam edin Faturalandırma hesabı oluşturun
  4. Kaydolun ve faturalandırma bilgilerinizi girin

  1. Farklı projeler için farklı kartlarla ödeme yapmak istersen birden çok faturalama hesabı ekle.
  2. İlk projenizi oluşturun: Menü > Ana Sayfa > Oluştur

İşte bu kadar! İlk Yorumlar projenize başlamayı başardığınız için Google Maps platformunu kullanmaya geçiyoruz.

API ile çalışmak sizin için çok karmaşık görünüyorsa endişelenmeyin ve basitçe bir Google Yorumlar widget’ı kullanın – web sitenizde sıfır kodlama ile istediğiniz sayıda Google yorumu göstermenize yardımcı olur.

Adım 2. Google Haritalar API’sini Etkinleştir

Google Maps JavaScript API’sini kullanmaya başlayınca kurulumunu yapacağız.

Her iki Places kütüphanesi, Google Maps JavaScript API için ve Places API bu tür yer bilgilerini elde etmenizi sağlar: ad, adres, açık çalışma saatleri, puan ve incelemeler (bunlara ihtiyacımız var). Ancak bu projede JS API’yi kullanacağız.

  1. Google Cloud Platform Konsolu’na gidin Google Cloud Platform Konsolu
  2. Veri almak istediğiniz projeyi seçin.
  3. En alttaki bölümden Menu üzerinden Google Maps seçin > APIsyi seçin
  4. Bu, API kütüphanesini açacak ve orada Google Maps JavaScript API seçmeniz gerekecek.
  5. Etkinleştir

İşte bu kadar! Artık Yorumlar uygulamanızda kullanmaya başlamaya hazırsınız. Bir sonraki adım API anahtarını oluşturmaktır.

3. Adım. API Anahtarı Al

Google Maps Platform temelinde İncelemeler projenizi başlatmak için bir API anahtarı üretmelisiniz. Hangi API veya SDK kullandığınız fark etmez; bu adım zorunludur.

Google Maps API anahtarı Google platformuna erişim talep eden kişinin benzersiz bir tanımlayıcısıdır ve bunun iznine sahip olduğunu doğrular. Anahtar ayrıca bağlı olduğu proje ve kota hakkında bilgi verir.

Bir API anahtarı aldıktan sonra, rastgele kullanımları önlemek ve hesabınıza üçüncü tarafların erişimini engellemek için anahtarı daha da kısıtlayın.

  1. Go to the Google Cloud Platform Kontrol Paneli
  2. Çalışacağınız projeyi seçin
  3. Bir menü düğmesine tıklayın > API’ler ve Hizmetler üzerinde fareyi bekletin > Kimlik Bilgileri öğesini seçin
  4. Tıkla Kimlik bilgileri Oluştur > açılır listeden API anahtarı seç.
  5. Buna tıkladığınızda benzersiz API anahtarınızı içeren bir açılır pencere göreceksiniz.

Şimdi bir inceleme uygulamasında bunu kopyalayıp kullanabilirsiniz. Ancak daha önce de konuştuğumuz gibi, anahtarı daha da kısıtlamalısınız. Bu adım zorunlu olmasa da, son derece önerilir. Bir açılır pencerede karşılık gelen bir düğme göreceksiniz ya da Google Maps API anahtarının önündeki ‘Düzenle’ düğmesini tıklayabilirsiniz.

API Anahtar Kısıtlamalarının İki Ana Türü

Uygulama kısıtlamaları

  • HTTP referrers – web siteleri ve web uygulamaları için kullanılır. Bir web sitesinin adını girerseniz anahtar yalnızca bu siteden gelen istekleri kabul eder.
  • IP adresi (web sunucuları vb.) – belirli sunuculardan veya IP adreslerinden çağrı yapılmasına olanak tanımak isteyen web geliştiricileri için özellikle kullanışlıdır.
  • Android Uygulamaları – Android uygulamaları üzerinden çağrılara izin verir. Yalnızca tek uygulamanızı belirtmek için paket adınızı ve SHA-1 imzalama sertifikanızı tanımlamanız gerekir.
  • iOS uygulamaları – iOS uygulamalarından gelen aramalara olanak tanır. Google Maps uygulamanızı belirtmek için iOS bundle kimliğini tanımlayın.

API Kısıtlamaları

  • Bunlar sayesinde belirli bir anahtar ile hangi API’lerin kullanılacağını özelleştirebilirsiniz.

Gereken kısıtlamaları seçin ve ‘Kaydet’e tıklayın.

4. Yer Kimliğini Al

Bu kolay ama önemli bir adım. Google Place IDs sayfasına gidin ve oradaki etkileşimli haritayı bulun. Gerekli yerin adını veya adresini girin:

Daha sonra benzersiz bir Place ID göreceksiniz; kopyalayın. İşte bu kadar! Yorumlar projemizin kurulumu tamamlandı. Bundan sonra Google Haritalar Platformu üzerinden nihayet yorumları almaya başlayacağız. Hadi başlayalım!

Adım 5. Google Haritalar Yorumlar Projesi Oluştur

Resmi belgelerde sitenize incelemeleri çekmek için Google JS’nin features of Google JS for fetching reviews hakkında daha fazlasını okuyabilirsiniz. Burada, hızlı bir sonuç elde etmek için kısa bir talimat bulacaksınız.

  1. Bu JavaScript koduyla çalışalım:
var axios = require('axios');

var config = {
  method: 'get',
  url: 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name%2Crating&key=YOUR_API_KEY',
  headers: { }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Bu iki alana özellikle dikkat edin:

  1. key=YOUR_API_KEY – replace YOUR API KEY with the Google Maps API key you’ve managed to get and restrict in Step 3.
  2. place_id=ChIJN1t_tDeuEmsRUsoyG83frY4 – harfleri ve sayıları 4. adımda elde ettiğiniz dize ile değiştirin.

Yukarıdaki kodu kullanırken incelemeniz için kısa bir dipnot hazırladık.

  • İade edilecek konum veri türlerini tanımlamak için fields parametresini kullanın. Örneğin, fields: price_level,rating,user_ratings_total,review. Birleşik değerler isterseniz şu şekilde bir eğik çizgi kullanın: opening_hours/open_now.
  • Üç faturalama alanı kategorisi şu şekildedir: Temel, İletişim ve Atmosfer. Temel alanlar için ek ücret yoktur. Atmosfer ve İletişim alanlarının ücretleri Google Haritalar platformunda daha yüksektir. Bu yüzden gereksiz tüm alanları kısıtlamalı ve sadece ihtiyacınız olanları kullanmalısınız.
  • Google Maps API ile inceleme ve derecelendirme almak için, Atmosphere kategorisini kullanmanız gerekir. İçeriğinde şu alanlar bulunur: price_level, rating, reviews, user_ratings_total.

Google Haritalar API’sini kullandıktan sonra alacağınız yanıtların açıklaması şu şekildedir:

  • rating – konumun genel kullanıcı puanını içerir. 1.0 ile 5.0 arasında değişir.
  • reviews – beş incelemeye kadar olan bir JSON dizisi. Bir dil parametresi talep edilirse, hizmet o dilde yayımlanan incelemelere diğer dillerde yazılanlardan üstünlük sağlar.
  • user_ratings_total – bu konum için metin tabanlı ve metin içermeyen tüm değerlendirmelerin toplam sayısı.

Google Yorumlar widget’ını kullanmaktan çekinmeyin

Bu makalede belirli bir çağrıya yanıt almayı başardık. Ancak amacınız çekici ve zarif incelemeler elde etmek ve bunları bir web sitesine yapıştırmaksa, yukarıdaki adımlar yeterli değildir. İşte Google Yorumları widget’ını kolayca oluşturmanıza ve görsel olarak özelleştirmenize olanak veren bir editör. Sıfır kodla bunu yapabilirsiniz. Makalemizde farklı platformlarda Google Yorumları kurulum sürecini daha ayrıntılı olarak bulabilirsiniz. Bu widget, ihtiyaç duyduğunuz kadar yorumu sunan Google API temelinde çalışır. Hemen deneyin.

Makale tarafından
Pazarlama Adayı
Ben Andrei Kozinskiy, Elfsight’ta Pazarlama Lideriyim. İçerik ve çeşitli trafik kanallarıyla kullanıcı tabanını büyütmekten sorumluyum. Başkalarının başarısı için görüşlerimi ve deneyimlerimi paylaşmaktan hoşlanıyorum.

İlgili Yazılar