Google Maps API Nedir?
API Key Nasıl Alınır?
İnternet sitene veya mobil uygulamana dinamik bir harita eklemek istiyorsun ama nereden başlayacağını bilmiyorsun. Bu rehberde Google harita servislerini sıfırdan adım adım kuruyoruz.
Harita API Anahtarınız Hazır
Aşağıdaki özel dijital anahtar, internet sitenizin Google sunucularıyla doğrudan konuşmasını ve haritayı ekranda çizmesini sağlar.
Bu Rehberde Ne Öğreneceksin?
Bu rehberin sonunda Google Maps API hakkında sıfırdan çalışan bir harita anahtarı (API Key) üretmeyi, kredi kartı gereksinimini güvenle yönetmeyi ve sitene hatasız bir harita eklemeyi öğrenmiş olacaksın. Hazırsan başlayalım.
Google Maps API Nedir?
İnternet sitendeki iletişim sayfasına bir harita eklemek istediğinde neden karmaşık kodlar ve gizli şifrelerle uğraşmak zorunda kalıyorsun?
İnternette gezinirken çoğu kurumsal sitede etkileşimli bir Google haritası görürsün. Bu harita üzerinde ziyaretçiler fareyle gezinebilir, yakınlaşabilir veya ofisine yol tarifi alabilir. İşte bu sistemin arka planda çalışabilmesi için sitenin Google ile konuşması gerekir. Google Maps API, Google’ın devasa harita veritabanı ile senin internet siten arasında köprü kuran resmi iletişim aracıdır.
API terimini bir restorandaki garsona benzetebilirsin. Sen masada oturup menüden bir yemek seçersin. Garson bu siparişi mutfağa iletir ve hazırlanan yemeği masana getirir. İnternet dünyasında da senin web siten müşteridir, Google mutfaktır, API ise garson görevi görür. Siten Google'a "bana Kadıköy haritasını getir" der, API de bu görüntüyü anında getirip sayfana yerleştirir.
Google Maps API (uygulamaların harita verilerini çekmesini sağlayan arayüz), web siteleri ve mobil uygulamaların Google haritalarını, konum aramalarını ve yol tariflerini kendi sayfalarında dinamik olarak görüntülemesini sağlayan resmi yazılım bağlantısıdır.
Eski Yöntem vs. Güncel Yaklaşım
- ❌ Korumasız İframe: Basit gömme koduyla harita ekleyip marka renklerine göre özelleştirememek.
- ❌ Kısıtlanmamış API Anahtarı: API kodunu internette herkese açık bırakıp başkalarının faturayı şişirmesine yol açmak.
- ❌ Statik Ekran Görüntüsü: Haritanın resmini yükleyip kullanıcının tıklamasına ya da yol tarifi almasına izin vermemek.
- ❌ Gereksiz Faturalar: Hangi API servislerinin açıldığını bilmeden rastgele tüm modülleri aktif etmek.
- ✅ Domain Kısıtlamalı API: Anahtarın sadece senin alan adında çalışmasını sağlayarak hırsızlığı önlemek.
- ✅ Ücretsiz Kredi Takibi: Google’ın her ay sunduğu 200 dolarlık ücretsiz kullanım kotasını aşmadan sistemi kurmak.
- ✅ Hızlı Yükleme & Performans: Sayfa açılış hızını düşürmeden harita scriptini gerektiğinde çalıştırmak.
- ✅ Mobil Uyumlu Arayüz: Hem telefonda hem masaüstünde kusursuz çalışan etkileşimli harita sunmak.
Bilmen Gereken Temel Terimler
Korkmana gerek yok; bu kavramları günlük dille özetliyoruz.
İki farklı yazılımın birbiriyle anlaşmasını sağlayan dijital tercüman.
Google sistemlerine giriş yapmanı sağlayan sana özel dijital anahtar (şifre).
Google'ın tüm kurumsal araçlarını ve harita servislerini yönettiği dev kontrol merkezi.
Hesabının aktif olması için sisteme kredi kartı bağlanan ödeme profili.
Haritanın web tarayıcısında renkli ve hareketli görünmesini sağlayan ana servis.
Konum arama kutusuna yazarken adreslerin otomatik çıkmasını sağlayan modül.
Anahtarının yalnızca senin sitende çalışmasını sağlayan güvenlik kilidi.
Yazılı bir açık adresi harita koordinatlarına (enlem ve boylam) dönüştüren işlem.
Google Maps API Hakkında Merak Edilen Her Şey
Google API Key Nedir ve Neden Gereklidir?
Google API Key (uygulama programlama arayüzü anahtarı), harita servislerini kullanırken Google'a kim olduğunu kanıtlayan özel bir güvenlik şifresidir. Tıpkı otel odasının kapısını açan manyetik kart gibidir. Kartın yoksa kapı açılmaz, odadaki eşyalara ulaşamazsın.
Geçmiş yıllarda Google bu haritaları herkese şifresiz ve sınırsız veriyordu. Fakat milyonlarca web sitesi aynı anda istek yapınca sunucu yükü arttı. Artık her sitenin bir kimlik kartı taşıması şart koşuldu. Bir web sitesine girdiğinde harita yerine gri bir kutu ve üzerinde "For development purposes only" (Yalnızca geliştirme amaçlıdır) uyarısı görüyorsan, bil ki o sitenin API anahtarı hatalıdır veya faturalandırma hesabı bağlanmamıştır.
⚠️ Dikkat: API Anahtarını Asla Açıkta Bırakma
API anahtarını aldığında ona bir güvenlik kuralı (HTTP Referrer kısıtlaması) koymazsan, kötü niyetli biri sitenin kaynak koduna bakıp anahtarını çalabilir. Kendi sitesine yapıştırıp binlerce harita çağrısı yaparsa fatura senin kartına yansır. Aşağıdaki adımlarda bu kilidi nasıl kuracağını göstereceğiz.
Google Maps API Ücretli mi? (Kredi Kartı Şart mı?)
Google Maps API temel kullanım için pratikte tamamen ücretsizdir, ancak sisteme kayıt olurken geçerli bir kredi kartı tanımlamak zorunludur. Google, her ay her kullanıcı hesabına koşulsuz şartsız 200 dolar değerinde ücretsiz kullanım kredisi tanımlar.
Bu 200 dolarlık hediye bakiye, internet sitende her ay yaklaşık 28.500 adet dinamik harita yüklemesine denk gelir. Küçük veya orta ölçekli bir yerel işletmenin, avukatlık bürosunun veya kliniğin iletişim sayfası ayda 28 bin kez harita görüntülemesine neredeyse hiç ulaşmaz. Dolayısıyla kartından para çekilmez. Google bu kartı sadece gerçek bir insan olduğunu teyit etmek ve botları engellemek için talep eder.
💡 İpucu: Yerel SEO ve Harita Bağlantısı
Sitenize Google Haritası eklemek, müşterilerin dükkanınızı kolayca bulmasını sağlarken arama motorlarına da fiziksel varlığınızı kanıtlar. Eğer işletmenizin Google Haritalar'da resmi kaydı yoksa, öncelikle Google adres ekleme adımlarını tamamlamalısın. Ayrıca daha fazla müşteri çekmek için yerel SEO rehberi ilkelerini uygulaman büyük fayda sağlar.
Basit Harita Gömme (Embed) ile API Arasındaki Fark Nedir?
Birçok kişi basit bir iframe (başka bir sitenin sayfasını kendi sitende gösteren pencere) koduyla API kullanımını birbirine karıştırır. İkisi tamamen farklı ihtiyaçlara hizmet eder.
| Özellik | Basit İframe (Gömülü Harita) | Google Maps API (Resmi Anahtar) |
|---|---|---|
| Kurulum Kolaylığı | Çok basit (Kopyala-yapıştır) | Orta düzey (Google Cloud hesabı gerekir) |
| Kredi Kartı Şartı | Kart gerekmez | Kart tanımlamak şarttır |
| Özelleştirme (Renk, Tema) | Yapılamaz (Standart Google görünümü) | Tam kontrol (Gece modu, marka renkleri, özel pin) |
| Dinamik İşlemler | Sadece sabit bir noktayı gösterir | Canlı kurye takibi, mesafe hesaplama, rota çizimi |
| Kullanım Amacı | Temel iletişim sayfaları | E-ticaret, ilan siteleri, rezervasyon sistemleri |
Google Cloud üzerinde harcama limiti (bütçe uyarısı) kurabilirsin. Örneğin bütçeni "1 TL" olarak ayarlarsan, ücretsiz limitin bitmesine yakın Google sana anında e-posta ile uyarı gönderir ve sürpriz bir faturayla karşılaşmanı önler.
Google Maps API Key Nasıl Alınır?
Adım adım, hiçbir teknik detayı atlamadan harita anahtarını üretiyoruz.
Google Cloud Console Hesabı Aç
İlk olarak Google Cloud Console (Google’ın bulut servisleri kontrol merkezi) sayfasına gitmen gerekir. Normal bir Gmail hesabın olması yeterlidir.
Yeni Bir Proje Oluştur
Google Cloud içerisinde yaptığın her işlem bir "Proje" altında toplanır. Bu, bilgisayarında masaüstüne yeni bir klasör açmak gibidir; her şeyi düzenli tutar.
Faturalandırma (Billing) Hesabını Bağla
En çok korkulan ama zorunlu olan adım burasıdır. Sol menüden "Billing" (Faturalandırma) sekmesine tıkla ve geçerli bir banka ya da kredi kartı ekle.
Maps API Kütüphanesine (Library) Gir
Google’ın yüzlerce farklı API servisi vardır. Haritanın çalışması için doğru servisi seçip aktif etmemiz gerekir.
Maps JavaScript API'yi Etkinleştir (Enable)
Arama sonucunda çıkan "Maps JavaScript API" seçeneğine tıkla. Mavi renkli büyük "ENABLE" (Etkinleştir) butonuna bas.
Kimlik Bilgileri (Credentials) Bölümüne Git
API servisini açtık; şimdi sıra anahtarımızı (şifremizi) üretmeye geldi. Sol menüden "APIs & Services" > "Credentials" (Kimlik Bilgileri) sekmesine tıkla.
API Anahtarını Kopyala ve Güvenlik Kilidi Koy
Ekrana "API key created" penceresi gelecek ve AIzaSy... ile başlayan uzun bir kod göreceksin. Bu kodu kopyala ama hemen sayfayı kapatma!
Buraya kadar geldiysen temel mantığı kavradın. Ama bu noktadan sonra güvenlik ve kısıtlama adımları devreye giriyor — burada çoğu kişi hata yapar ve anahtarını savunmasız bırakır.
HTTP Referrers (Web Sitesi) Kısıtlamasını Ayarla
Açılan kısıtlama ekranında "Set application restrictions" başlığı altında "Web sites" (veya HTTP referrers) seçeneğini işaretle.
https://*.siteniz.com/* ve https://siteniz.com/*. Bu sayede bu kod başka hiçbir sitede çalışamaz.API Restrictions (Servis Kısıtlaması) Belirle
Sayfanın biraz aşağısında "API restrictions" bölümünü göreceksin. "Don't restrict key" yerine "Restrict key" seçeneğini seç.
Anahtarı Sitenize veya Eklentinize Ekleyin
Artık elinde korumalı, güvenli ve aktif bir Google Maps API Key var. Bu kodu WordPress kullanıyorsan tema ayarlarına veya harita eklentine (örneğin WP Go Maps) yapıştır.
"Sitenize eklediğiniz her harita scripti, sayfanızın açılış hızına ortalama 400 ile 800 milisaniye ek yük bindirebilir. Eğer akıllıca yüklenmezse Google sıralamalarınızı olumsuz etkiler."
Sık Sorulan Sorular
Google Maps API Key almak tamamen ücretsiz mi? ↓
Evet, Google her ay her hesaba 200 dolarlık ücretsiz kredi tanımlar. Çoğu standart işletme sitesi ayda 28.500 harita görüntülemesine ulaşamadığı için hiçbir ücret ödemez.
Kredi kartı eklemeden Google Maps API Key alabilir miyim? ↓
Hayır. Google Cloud politikaları gereği faturalandırma hesabı (Billing) açmadan API anahtarı üretilmesine izin verilmez. Kartınızdan harcama limiti aşılmadığı sürece para çekilmez.
Harita üzerinde "This page can't load Google Maps correctly" hatası neden çıkar? ↓
Bu hata üç sebepten kaynaklanır: Ya API anahtarı hatalı girilmiştir, ya Maps JavaScript API kütüphanesi etkinleştirilmemiştir ya da Google Cloud hesabına bir faturalandırma (Billing) hesabı bağlanmamıştır.
Bir API Key kodunu birden fazla sitede kullanabilir miyim? ↓
Teknik olarak kullanabilirsin. Ancak güvenlik ve kota takibi açısından her farklı web sitesi veya müşteri için ayrı bir proje ve ayrı bir API anahtarı açmak her zaman daha sağlıklıdır.
Google Maps API kotası biterse ne olur? ↓
200 dolarlık ücretsiz aylık kullanım sınırını geçersen, sistem ek kullanımları tarife üzerinden kartına yansıtır. Bunu engellemek için Google Cloud Console üzerinden günlük kullanım kotası koyabilirsin.
WordPress siteme API Key olmadan harita ekleyebilir miyim? ↓
Evet. Google Haritalar web sitesine girip konumunu bulduktan sonra "Paylaş" > "Haritayı Yerleştir" seçeneğindeki iframe kodunu kopyalayarak sitene yapıştırabilirsin. Bu yöntemde API key gerekmez.
HTTP Referrer kısıtlaması tam olarak nedir? ↓
Bu kısıtlama, API anahtarının yalnızca senin belirlediğin alan adında (örneğin gokhanvatanci.com) çalışmasını sağlar. Başka birisi anahtar kodunu kopyalayıp kendi sitesine koysa bile harita açılmaz.
API Key'imi yanlışlıkla internette paylaştım, ne yapmalıyım? ↓
Hemen Google Cloud Console > Credentials sayfasına gir. Açıkta kalan anahtarın yanındaki çöp kutusu simgesine basarak sil ve saniyeler içinde yeni bir anahtar üretip sitene ekle.
Places API ile Maps JavaScript API arasındaki fark nedir? ↓
Maps JavaScript API ekranda görsel haritayı çizer. Places API ise kullanıcının bir arama kutusuna "Eczane" veya "Kadıköy" yazdığında mekanların otomatik olarak listelenmesini ve ayrıntılı adres bilgilerini çeker.
Google Maps API site hızını (SEO) yavaşlatır mı? ↓
Evet, doğrudan çağrıldığında çok sayıda harici JavaScript dosyası yükler. Bu nedenle haritanın sayfa ilk açıldığında değil, ziyaretçi harita alanına yaklaştığında yüklenmesi (lazy loading) teknik SEO açısından oldukça kritiktir.
Desteğe mi İhtiyacın Var? Buradayım.
Buraya kadar okuduysan Google Maps API sisteminin nasıl işlediğini artık biliyorsun. Uygulamaya geçerken konsol ayarlarında, güvenlik kısıtlamalarında veya site hız optimizasyonunda takılırsan, birlikte hızlandıralım.
Gökhan Vatancı ile Görüş →
