Google Maps API nedir?

Google Maps API nedir?​

Google Maps API, web sitelerine ve uygulamalara harita, konum arama, adres çözümleme, rota ve mesafe gibi Google Maps Platform özelliklerini programlama yoluyla eklemeyi sağlayan servisler ve yazılım geliştirme araçlarıdır. Örneğin bir teslimat uygulaması, kullanıcının adresini haritada göstermek, iki nokta arasındaki sürüş rotasını hesaplamak veya işletme araması yaptırmak için ilgili API ya da SDK’yı kullanabilir.

Buradaki “API” tek bir servis anlamına gelmez. İhtiyaca göre farklı Google Maps Platform ürünleri seçilir. Tarayıcıda etkileşimli harita göstermek için genellikle Maps JavaScript API; adresi koordinata çevirmek için Geocoding; yer ve işletme araması için Places; rota ve seyahat süresi hesaplamak için Routes gibi ürünler değerlendirilir. Mobil uygulamalarda ise Android ve iOS için ayrı harita SDK’ları kullanılabilir.

Nasıl çalışır?​

Temel akış şöyledir:

1. Uygulamanın ihtiyacı belirlenir: yalnız harita mı gösterilecek, yoksa adres arama ve rota hesabı da mı yapılacak?
2. Google Cloud üzerinde doğru proje seçilir; üretim için gerekli hesap/faturalandırma ön koşulları kontrol edilir ve kullanılacak Maps Platform hizmetleri etkinleştirilir.
3. İstekleri tanımlamak için bir API anahtarı oluşturulur. Anahtar, uygulamanın hangi projeye ve hizmetlere ait olduğunu belirtir.
4. Web uygulaması için harita kitaplığı sayfaya eklenir veya sunucu tarafında ilgili HTTP isteği gönderilir.
5. API’nin döndürdüğü harita, koordinat, adres, yer veya rota verisi uygulamanın arayüzünde kullanılır.

API anahtarı tek başına her isteğin başarılı olacağını garanti etmez. Kullanılan hizmetin projede etkin olması, anahtar kısıtlamalarının isteğin geldiği ortama uygun olması ve hesabın Google Maps Platform kullanım koşullarını karşılaması gerekir. Tarayıcıda kullanılan anahtar ile sunucuda saklanan anahtarın güvenlik ve kısıtlama yaklaşımı aynı değildir. Tarayıcı anahtarında web sitesi adresi gibi uygulama kısıtlamaları; sunucu anahtarında uygun IP uygulama kısıtlaması kullanılabilir. Bunlara ek olarak her anahtarı yalnız gerekli API'lerle sınırlandırın; uygulama kısıtlaması ile API kısıtlaması birbirinin alternatifi değildir.

Hangi API ne için kullanılır?​

Aşağıdaki ayrım, ilk ürün seçimini kolaylaştırır:


Bu ürünler birbirinin tam yerine geçmez. Haritada bir işaretçi göstermek için rota servisini kullanmak gerekmez; ancak kullanıcıya iki nokta arasındaki yol tarifini vermek istiyorsanız haritaya ek olarak rota hizmetine de ihtiyaç duyabilirsiniz. Hangi ürünün seçileceği, ekranın görsel ihtiyacından çok uygulamanın hangi veriyi üretmek istediğine göre belirlenmelidir.

Somut örnek: teslimat uygulaması​

Kurgu bir teslimat örneğinde kullanıcı önce adresini yazar. Adresin koordinata çevrilmesi için Geocoding veya adres arama akışında uygun Places özellikleri kullanılabilir. Uygulama, elde edilen koordinatı haritadaki teslimat noktası olarak gösterir. Kurye ile teslimat noktası arasındaki tahmini güzergâh ve seyahat bilgisi gerekiyorsa Routes kullanılır. Böylece harita yalnızca görsel bir arka plan değil, adres ve rota verilerinin sunulduğu bir arayüz haline gelir.

Bu örnekte her isteğin tarayıcıdan yapılması zorunlu değildir. Hassas iş mantığı, veri birleştirme veya uygulamanın kendi veritabanına kayıt gibi işlemler sunucu tarafında yürütülebilir. Tarayıcıya gönderilen anahtarın kaynak kodunda görülebileceği unutulmamalı; bu nedenle anahtar kısıtlamaları yapılmadan uygulamanın yayına alınması doğru bir başlangıç değildir.

En sık yapılan hatalar​

Tek bir API her işi yapar sanmak: Harita görüntüleme, yer arama, adres dönüştürme ve rota hesaplama ayrı ihtiyaçlardır. Önce işlevi, sonra ürünü seçin.

API anahtarını kısıtlamadan kullanmak: Anahtarın yalnızca gerekli web sitelerinde, uygulamalarda veya servislerde kullanılmasına izin verin. Gereksiz tüm API erişimlerini açık bırakmayın.

Sadece istemci tarafına güvenmek: Kullanıcıdan gelen adresi veya koordinatı doğrulamadan doğrudan işleme almak hatalı sonuçlara yol açabilir. Uygulamanızın kendi doğrulama ve hata yönetimini ekleyin.

API yanıtını kesin gerçek kabul etmek: Adres yazımları, işletme kayıtları, koordinatlar ve rota sonuçları bağlama göre değişebilir. Kullanıcıya belirsiz veya eksik sonuçlarda yeniden arama, seçim yapma ya da adresi düzeltme imkânı verin.

İlk adım olarak uygulamanızdaki ihtiyacı “harita gösterme”, “yer/adres arama”, “koordinat dönüştürme” veya “rota hesaplama” şeklinde ayırın. Ardından yalnızca gereken ürünleri etkinleştirip anahtarı uygulamanın çalıştığı ortama göre kısıtlayın. Bir istek başarısız olursa önce etkin API, anahtar kısıtlaması, proje ayarı ve istek biçimini kontrol edin; harita görünmesine rağmen arama veya rota çalışmıyorsa bunun nedeni genellikle bu özelliklerin ayrı bir hizmet gerektirmesidir.

Sık sorulan sorular​

Prototipte çalışan anahtar üretimde doğrudan kullanılabilir mi?​

Her zaman değil. Maps JavaScript API'nin demo anahtarı seçili özelliklerle prototip içindir, üretim amacıyla tasarlanmamıştır. Üretimde standart anahtar, gerekli hesap koşulları ve uygun uygulama/API kısıtlamaları ayrı tamamlanmalıdır.

Google Maps API ile kendi haritamı mı oluştururum?​

Genellikle Google’ın harita ve konum hizmetlerini uygulamanızın arayüzüne entegre edersiniz. Haritanın görünümü, işaretçileri ve uygulama akışı özelleştirilebilir; ancak kullanılan veriler ve hizmetler ilgili Google Maps Platform koşullarına tabidir.

Places sonucunu kendi veritabanıma sınırsız kaydedebilir miyim?​

Hayır. Places içeriğinin saklanması ve önbelleğe alınması ürün politikasındaki izin ve istisnalara bağlıdır; place_id için ayrı istisna bulunur. Gösterimde gerekli kaynak/üretici atıflarını da koruyun. API'den veri dönmesi sınırsız yeniden kullanım izni değildir.