Google Place ID nedir? Nasıl bulunur, ne zaman değişir?

Google Place ID nedir?

Google Place ID, Google Maps veritabanında bir mekânı benzersiz biçimde tanımlayan metin tabanlı bir kimliktir. İşletmeler, parklar, kavşaklar ve simge yapılar için bulunur. Google'ın API'leri bu kimlikle mekân ayrıntısı getirir ve haritada doğru yere bağlantı verir. Müşteri listelerinde ise aynı işletmenin iki kez kaydedilmesini önleyen ana anahtar görevi görür.

Place ID'yi bir isimden çok bir sicil numarası gibi düşünün. Türkiye'de "Merkez Eczanesi" ya da "Yeni Berber" adını taşıyan onlarca işletme vardır, bir adres de beş farklı biçimde yazılabilir. Place ID ise Google'ın verisindeki tek bir kaydı gösterir. Geliştiricilerin ve liste hazırlayanların ona bağlanmasının nedeni budur. Bu sayfadaki teknik bilgilerin tamamı Google Maps Platform'un Place ID belgesine dayanır.

Place ID bir işletmeyi değil, bir mekânı tanımlar. Google, aynı mekânın birden fazla kimliğe sahip olabileceğini ve kimliklerin zamanla değişebileceğini yazar; çoğu rehber bunu atlıyor.

Google Place ID nasıl görünür ve kaç karakterdir?

Place ID; harf, rakam, tire ve alt çizgiden oluşan, anlamı okunamayan bir karakter dizisidir. Birçok işletme kimliği ChIJ ile başlar, ama bu yalnızca yaygın bir kalıptır, kural değildir. Google'ın belgesinde GhIJ ve Eic ile başlayan örnekler de yer alır. Belge ayrıca kimlik uzunluğunun değişebildiğini ve üst sınır olmadığını açıkça belirtir.

Birçok rehberde "27 karakterlik Place ID" diye bir kural dolaşır, oysa böyle bir kural yoktur. Veritabanı sütununuz ya da form doğrulamanız sabit bir uzunluk varsayarsa, bir gün geçerli bir kimliği reddeder. Uzunluk sınırı olmayan bir metin alanı kullanın ve değeri olduğu gibi saklayın.

Place ID bir telefon numarası, koordinat çifti ya da okunabilir bir bağlantı da değildir. Adresten tahmin edemezsiniz, Google'dan almanız gerekir.

Bir işletmenin Google Place ID'si nasıl bulunur?

Tek bir Place ID'yi bulmanın en hızlı yolu Google'ın Place ID Finder örnek sayfasıdır: adresi ya da işletme adını yazar, öneriyi seçer ve kimliği okursunuz. Çok sayıda işletme için Places API veya bir Google Maps veri çekme eklentisi gerekir.

Elle bulmak için dört adım yeterli:

1. Place ID Finder örnek sayfasını açın.
2. İşletmenin adını ya da adresini yazın, ör. "Kadıköy, İstanbul", ve önerilerden doğru sonucu seçin.
3. Haritadaki bilgi penceresinde görünen Place ID'yi kopyalayın.
4. Yakaladığınız tarihle birlikte tablonuza ya da CRM'inize yapıştırın.

Geliştiriciler için ikinci yol API'dir. Google'ın belgesindeki örnekte, Sidney'de "Spicy Vegetarian Food" için gönderilen bir Text Search (New) isteği her eşleşmeyi, kimliği taşıyan bir id alanıyla döndürür. Place Details (New) belgesi kimliği almanın diğer yollarını da sayar: Nearby Search, Geocoding API, Routes API, Address Validation API ve Autocomplete.

Finder ve API, tek bir mekânı ya da tek bir sorguyu aramak için tasarlanmıştır. Müşteri listesi hazırlıyorsanız kimlikleri tek tek aramak istemezsiniz, kimliğin işletme kaydıyla birlikte gelmesini istersiniz. Google Maps'ten ücretsiz veri çekme rehberimizde anlattığımız yaklaşım bunu yapar. API yolunun maliyeti için de Google Maps API fiyatı yazımıza bakabilirsiniz.

Place ID, CID, Plus Code ya da koordinat: hangisi ana anahtar olmalı?

Bir mekân için ana anahtar Place ID olmalı, diğer tanımlayıcılar destekleyici veri olarak kalmalı. Google Maps bir konumu birkaç farklı yolla adlandırır ve her biri başka bir soruya cevap verir: bu hangi profil, nerede duruyor, insanlar ona ne diyor?

Izgara kodları sizin için yeniyse Plus Code nedir yazımıza göz atın. Enlem ve boylamın nasıl çalıştığı için koordinat ve geocoding rehberimiz var.

Google Place ID değişir mi, saklayabilir miyim?

Evet, bir Place ID değişebilir ve evet, onu saklayabilirsiniz. Google, Google Maps veritabanı güncellendiği için kimliklerin değişebileceğini yazar ve 12 aydan eski kimliklerin yenilenmesini önerir. Place ID'ler normal önbellekleme kısıtlamasından muaftır, bu nedenle kendi veritabanınızda tutabilirsiniz.

Belgeye göre izlemeniz gereken sıra şöyle:

1. Kimliği, yakaladığınız tarihle birlikte kaydedin.
2. 12 ay sonra Place Details isteği atın ve fields parametresine yalnızca kimlik alanını yazın. Google bu yenilemenin ücretsiz olduğunu belirtir.
3. İstek INVALID_REQUEST ya da NOT_FOUND dönerse kimlik hatalı ya da eskimiş olabilir. İşletme kapanmış veya taşınmış olabilir, yeniden arayıp yeni kimliği alın.
4. Web sitesi alan adı ya da telefon gibi yedek bir eşleştirme anahtarı tutun. Kimlik değişse de aynı işletme için ikinci bir kayıt açılmaz.

Bu istisna, Place ID sayfasında belirtildiği gibi, Google Maps Platform Hizmet Şartları'nın 3.2.3(b) maddesinden gelir ve yalnızca kimliği kapsar. Diğer mekân verilerini süresiz önbelleğe alma hakkı vermez, bu yüzden API üzerine bir ürün kurmadan önce şartları okuyun.

Place ID ile neler yapılır?

Place ID ile mekân ayrıntısı alır, doğru yere bağlantı verir ve kimliği Google Maps Platform'un farklı API'lerinde yeniden kullanırsınız. Başlıca kullanımlar şunlar, hepsi Google'ın belgelerinde yer alıyor:

• Mekân ayrıntısı almak. Place Details isteği kimliği alır ve istediğiniz alanları döndürür: adres, telefon, puan gibi. Ayrıntılar için Place Details (New) sayfasına bakın.
• Doğru yere bağlantı vermek. Maps URL'lerinde query_place_id parametresi bağlantıyı belirli bir işletmeye yöneltir. Google, doğru yere bağlandığınızdan emin olmanın en iyi yolunun Place ID olduğunu söyler. Maps URL'leri kılavuzunda ayrıntısı var.
• Kimliği farklı API'lerde kullanmak. Aynı kimlik Places API'de, Maps JavaScript API'de, Geocoding API'de, Maps Embed API'de ve Roads API'de geçerlidir.
• Kalıcı bir anahtar kurmak. Tabloda ya da CRM'de iki dışa aktarım çakıştığında eşleştirdiğiniz değer kimliktir.

Bir mekânı kimliğiyle gösteren Maps bağlantısı şu kalıba uyar: https://www.google.com/maps/search/?api=1&query=Isletme+Adi&query_place_id=PLACE_ID_BURAYA. Google kimliği bulamazsa metin sorgusuna döner.

Müşteri listenizi Place ID ile nasıl tekrarsız tutarsınız?

Listeleri birleştirirken ilk eşleştirme anahtarı olarak Place ID'yi, kimlik eksikse yedek anahtarları kullanın. Google Maps'ten liste çıkaran herkes çakışan dışa aktarımlarla karşılaşır. Bir serbest çalışan İstanbul'da Kadıköy ve Üsküdar'ı ayrı ayrı tarar, bir ajans aynı aramayı bir sonraki ay yeniler, bir işletme sahibi eski bir listeye Ankara'yı ekler. Aynı işletme listeye iki kez girer.

Ad ile eşleştirmek de çözüm değildir. Türkçe karakterler burada ayrı bir tuzaktır: aynı işletme bir yerde "Çiçek Pastanesi", başka bir yerde "Cicek Pastanesi" olarak görünebilir, bir şubenin adına semt eklenmiş olabilir. Place ID bu farkların hiçbirinden etkilenmez. Şu rutin hem tabloda hem CRM'de işe yarar:

1. Her işletme için Place ID'yi kaydedin. Dışa aktarımınızda kimlik yoksa isimle eşleştirmek zorunda kalırsınız.
2. Önce Place ID'ye göre birleştirin. Aynı kimliği taşıyan iki satır aynı mekândır. İletişim bilgisi en eksiksiz olanı tutun.
3. Kalanları yedek anahtarla eşleştirin. Önce web sitesi alan adını, sonra telefonu, en sonda ad ve koordinatı karşılaştırın. Google'ın bir mekâna yeni kimlik verdiği durumu da bu adım yakalar.
4. Eski satırları yenileyin. Büyük bir kampanyadan önce 12 aydan eski kimlikleri kontrol edin, artık sonuç vermeyen işletmeleri listeden çıkarın.
5. İlk yakalama tarihini saklayın. Hangi satıra güveneceğinizi, hangisini doğrulayacağınızı bu tarih söyler.

Listeyi Excel ya da Sheets'e taşıyacaksanız CSV, XLSX ve JSON dışa aktarma seçeneklerini karşılaştıran yazımız hangi alanların saklanması gerektiğini gösterir. Alanların CRM tarafında nasıl düzenleneceği için müşteri veritabanı şablonu rehberine de bakabilirsiniz.

Vonsel Chrome eklentisi Google Maps'teki işletmeleri yakalar, her işletmenin web sitesini ziyaret ederek yayımlanmış e-postaları, telefonları ve sosyal medya profillerini arar. Dışa aktarma alanları arasında Place ID, CID, FID ve KGMID listelenir. Dolu gelen alanlar her işletmenin yayımladığı bilgiye bağlıdır. Yakalanan işletmeler haritalı bir CRM'e kaydedilir ve önceki bir işi yeniden açarak daha fazlasını ekleyebilirsiniz. Planların kapsamını fiyatlandırma sayfasında görebilir, akışı hızlıca görmek için video eğitimini izleyebilirsiniz.

İletişime geçmeden önce bir uyarı: Place ID yalnızca bir mekân anahtarıdır, ama listenize eklediğiniz bazı iletişim bilgileri kişisel veri olabilir. KVKK'nın tanımına göre kişisel veri, kimliği belirli ya da belirlenebilir gerçek kişiye ilişkin her türlü bilgidir. Adı soyadı geçen bir e-posta adresi buna örnektir. Ulaşmadan önce Google Maps verisi çekmek ve kişisel verilerin korunması rehberimizi okuyun.

Kaynaklar

• Place IDs | Places API (New): Google'ın Place ID tanımı, örnek biçimler, uzunluk üst sınırı olmaması, 12 aylık yenileme önerisi ve önbellekleme muafiyeti.
• Place ID Finder | Maps JavaScript API: Bir mekânı arattıktan sonra kimliğini bilgi penceresinde gösteren Google örneği.
• Place Details (New) | Places API: Place ID ile mekân ayrıntısı isteme ve kimliği döndürebilen API'lerin listesi.
• Get Started | Maps URLs: query_place_id parametresinin bir bağlantıyı belirli bir işletmeye yönlendirmesi.
• Kişisel Veriler | Kişisel Verileri Koruma Kurumu: Kişisel verinin resmi tanımı ve işlenme şartları.