Directions API ile API Anahtarlarını Kullanma

Google Haritalar Platformu ürünleri, API çağrılarını uygun kimlik doğrulama kimlik bilgileri sağlayanlarla 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ın nasıl oluşturulacağı, kısıtlanacağı ve kullanılacağı açıklanmaktadır.

Başlamadan önce

Yol Tarifi API'sini kullanmaya başlamadan önce, faturalandırma hesabı olan ve Yol Tarifi API'nin etkinleştirildiği bir projeye ihtiyacınız vardır. Daha fazla bilgi için Cloud Console'da kurulum 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 gitme

  2. Kimlik bilgileri sayfasında Kimlik bilgileri oluştur > API anahtarı'nı tıklayın.
    API anahtarı oluşturuldu iletişim kutusunda yeni oluşturduğunuz API anahtarı gösterilir.
  3. Kapat'ı tıklayın.
    Yeni API anahtarı, Kimlik bilgileri sayfasındaki API anahtarları bölümünde listelenir.
    (Üretimde kullanmadan önce API anahtarını 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:

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ırlayarak kısıtlamanızı önemle tavsiye eder. API anahtarlarını kısıtlamak, uygulamanızı gereksiz isteklerden koruyarak güvenliğini artırır. Kısıtlanmamış API anahtarlarının kötüye kullanılmasından kaynaklanan ücretlerden mali olarak siz sorumlusunuzdur. Daha fazla bilgi için API güvenliğiyle ilgili en iyi uygulamalar konusuna bakın.

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

Konsol

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

    Kimlik bilgileri sayfasına gitme

  2. Kısıtlama uygulamak istediğiniz API anahtarını seçin. API anahtarı özellik 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.) seçeneğini belirleyin. CIDR gösterimini kullanarak bir veya daha fazla IPv4 ya da IPv6 adresi veya alt ağ belirtin. IP adresleri, Google Haritalar Platformu sunucularının gözlemlediği kaynak adresiyle eşleşmelidir. Ağ adresi çevirisi (NAT) kullanıyorsanız bu adres genellikle makinenizin genel IP adresine karşılık gelir.
    • API kısıtlamaları:
      1. Anahtarı kısıtla'yı tıklayın.
      2. API'leri seçin açılır listesinden Directions API'yi seçin. Directions API listelenmiyorsa 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 anahtarda yeni kısıtlamalar ayarlayın. 

gcloud services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \
    --api-target=service=directions-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:

İsteğinize API anahtarını ekleme

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

https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&key=YOUR_API_KEY

API anahtarı kullanan istekler için HTTPS gereklidir.