Maps Static API ile API Anahtarlarını Kullanma

Google Haritalar Platformu ürünleri, API çağrılarının yalnızca uygun kimlik doğrulama kimlik bilgilerini sağlayanlar tarafından yapılmasını kısıtlayarak yetkisiz kullanıma karşı korunur. Bu kimlik bilgileri, Google faturalandırma hesabınızı projenizle ve belirli API veya SDK ile ilişkilendiren benzersiz bir alfanümerik dize olan API anahtarı biçimindedir.

Bu kılavuzda, Google Haritalar Platformu için API anahtarınızı nasıl oluşturacağınız, kısıtlayacağınız ve kullanacağınız gösterilmektedir.

Başlamadan önce

Maps Static API'yi kullanmaya başlamadan önce, faturalandırma hesabı ve Maps Static API'nin etkin olduğu bir projeye ihtiyacınız vardır. Daha fazla bilgi için Cloud Console'da ayarlama başlıklı makaleyi inceleyin.

API anahtarları oluşturma

API anahtarı, kullanım ve faturalandırma amacıyla projenizle ilişkili isteklerin kimliğini doğrulayan benzersiz bir tanımlayıcıdır. Projenizle ilişkilendirilmiş en az bir API anahtarınız olmalıdır.

API anahtarı oluşturmak için:

Konsol

1. Google Haritalar Platformu > Kimlik Bilgileri sayfasına gidin.

   Kimlik Bilgileri sayfasına gidin

2. Kimlik bilgileri sayfasında Kimlik bilgileri oluştur > API anahtarı'nı tıklayın.
   Oluşturulan API anahtarı iletişim kutusunda yeni oluşturulan API anahtarınız gösterilir.
3. Kapat'ı tıklayın.
   Yeni API anahtarı, Kimlik bilgileri sayfasındaki API anahtarları bölümünde listelenir.
   (API anahtarını üretimde kullanmadan önce kısıtlamayı unutmayın.)

Google Cloud SDK

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Google Cloud SDK, Cloud SDK yükleme ve aşağıdaki komutlar hakkında daha fazla bilgi edinin:

• gcloud services api-keys create

API anahtarlarını kısıtlama

Google, API anahtarlarınızın kullanımını yalnızca uygulamanız için gereken API'lerle sınırlandırarak kısıtlamanızı önemle tavsiye eder. API anahtarlarını kısıtlamak, uygulamanızı gereksiz isteklerden koruyarak uygulamanızın güvenliğini artırır. Kısıtlanmamış API anahtarlarının kötüye kullanılmasından kaynaklanan ödemelerden mali olarak sorumlu olursunuz. Daha fazla bilgi için API güvenliğiyle ilgili en iyi uygulamalar başlıklı makaleyi inceleyin.

Cloud Console'da bir API anahtarını kısıtlarken uygulama kısıtlamaları, API kısıtlamaları kapsamında etkinleştirilen tüm API'leri geçersiz kılar. Her uygulama ve uygulamanın kullanılabildiği her platform için ayrı bir API anahtarı oluşturarak en iyi uygulamaları uygulayın.

API anahtarlarınızı kısıtlamanın yanı sıra bu API'ye yönelik istekleri de imzalamanız gerekir. Daha fazla bilgi için API güvenliğiyle ilgili en iyi uygulamalar başlıklı makaleyi inceleyin.

Bir API anahtarını kısıtlamak için:

Konsol

1. Google Haritalar Platformu > Kimlik Bilgileri sayfasına gidin.

   Kimlik Bilgileri sayfasına gidin

2. Kısıtlama ayarlamak istediğiniz API anahtarını seçin. API anahtarı mülkü sayfası görünür.
3. Anahtar kısıtlamaları bölümünde aşağıdaki kısıtlamaları ayarlayın:
• Uygulama kısıtlamaları:
1. Sağladığınız web sunucusu IP adresleri listesinden gelen istekleri kabul etmek için Uygulama kısıtlamaları listesinden IP adresleri (web sunucuları, cron işleri vb.)'ni seçin. CIDR gösterimini kullanarak bir veya daha fazla IPv4 ya da IPv6 adresi ya da alt ağ belirtin. IP adresleri, Google Haritalar Platformu sunucularının gözlemlediği kaynak adresle eşleşmelidir. Ağ adresi çevirisi (NAT) kullanıyorsanız bu genellikle makinenizin herkese açık IP adresine karşılık gelir.
• API kısıtlamaları:
1. Anahtarı kısıtla'yı tıklayın.
2. API'leri seç açılır listesinden Maps Static API'yi seçin. Maps Static API listede yoksa etkinleştirmeniz gerekir.
4. Değişikliklerinizi tamamlamak için Kaydet'i tıklayın.
   

Google Cloud SDK

Mevcut anahtarları listeleyin.

gcloud services api-keys list --project="PROJECT"

Mevcut anahtardaki mevcut kısıtlamaları temizleyin.

gcloud services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

Mevcut anahtar için yeni kısıtlamalar belirleyin.

gcloud services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \
    --api-target=service=static-maps-backend.googleapis.com
    --allowed-ips="IP_ADDRESS"

Google Cloud SDK, Cloud SDK yükleme ve aşağıdaki komutlar hakkında daha fazla bilgi edinin:

• gcloud services api-keys update
• gcloud services api-keys lookup
• gcloud services api-keys list

API anahtarını isteğinize ekleme

Her Maps Static API isteğine bir API anahtarı eklemeniz gerekir. Aşağıdaki örnekte, YOUR_API_KEY ifadesini API anahtarınızla değiştirin.

https://maps.googleapis.com/maps/api/staticmap?center=Z%C3%BCrich&zoom=12&size=400x400&key=YOUR_API_KEY

API anahtarı kullanan istekler için HTTPS gereklidir.

Not: Web Hizmetleri kullanılırken parametrelerdeki tüm özel karakterler URL olarak kodlanmış olmalıdır. URL'lerin geçerli olması için doğru şekilde kodlanması gerekir ve tüm web hizmetleri için 2.048 karakterle sınırlıdır. URL'lerinizi oluştururken bu sınırı göz önünde bulundurun. Farklı tarayıcılar, proxy'ler ve sunucuların farklı URL karakter sınırlamaları da olabilir.

Sırada ne var?

Maps Static API isteklerinde dijital imza da kullanılmalıdır.