Directions API (Eski) ile API anahtarlarını kullanma

Google Haritalar Platformu ürünleri, API çağrılarını uygun kimlik doğrulama bilgilerini sağlayanlarla kısıtlayarak yetkisiz kullanıma karşı güvenlik sağlar. 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.

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

Başlamadan önce

Directions API'yi (Eski) kullanmaya başlamadan önce faturalandırma hesabı olan ve Directions API'nin (Eski) etkinleştirildiği bir projeniz olmalıdır. Daha fazla bilgi için Cloud Console'da kurulum başlıklı makaleyi inceleyin.

API anahtarı 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şkili en az bir API anahtarınız olmalıdır. Yeni bir anahtar oluşturmak veya mevcut bir anahtara API ya da SDK eklemek için bu talimatları uygulayın.

Konsol

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

    Anahtarlar ve Kimlik Bilgileri sayfasına gidin

  2. İstenirse projenizi seçin.

  3. Aşağıdakilerden birini yapın:

    • Yeni anahtar oluşturma:

      1. Kimlik bilgileri oluştur > API anahtarı'nı tıklayın.
      2. API anahtarı oluştur panelinde API kısıtlamalarını seçin listesini açın.
      3. Bu anahtarın ihtiyaç duymadığı API'leri temizleyin ve Directions API'nin seçili kaldığından emin olun.
      4. Oluştur'u tıklayın. Panelde yeni API anahtarınız gösterilir.

    • Mevcut bir anahtarı kullanma:

      1. Anahtarın adını tıklayın.
      2. API kısıtlamalarını seçin listesinde Directions API'yi seçin.
      3. Kaydet'i tıklayın.

    Burada bir API seçmek, API'yi etkinleştirmez. Directions API'nin API Kitaplığı sayfasında etkinleştirildiğinden emin olun.

  4. Anahtar dizesini daha sonra görmek için Anahtarlar ve Kimlik Bilgileri sayfasına gidip anahtar için Anahtarı göster'i tıklayın.

Konsol bu adımlardan farklı görünüyorsa Google Cloud belgelerindeki API anahtarı oluşturma ve API kısıtlamaları ekleme bölümlerine bakın.

gcloud

Aşağıdaki komutlarda PROJECT_ID ifadesini proje kimliğinizle değiştirin.

  • Yeni anahtar oluşturma: Aşağıdaki komutu çalıştırın ve DISPLAY_NAME yerine anahtarın adını yazın. 

    gcloud services api-keys create \
    --project="PROJECT_ID" \
    --display-name="DISPLAY_NAME" \
    --api-target=service=directions-backend.googleapis.com

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

  • Mevcut bir anahtarı kullanma: Aşağıdaki komutu çalıştırın ve KEY_ID değerini anahtarın kimliğiyle değiştirin. --append işareti, anahtarın halihazırda izin verdiği API'leri korur. Bu parametre kullanılmadığında komut, mevcut etiketleri değiştirir.

    gcloud services api-keys update KEY_ID \
    --project="PROJECT_ID" \
    --append \
    --api-target=service=directions-backend.googleapis.com

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

    Anahtar kimliği, anahtar dizesi veya görünen ad değildir. Bunu bulmak için gcloud services api-keys list --project="PROJECT_ID" komutunu çalıştırın. Kimlik, name alanının son kısmıdır: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.

Anahtar dizesini görmek için gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID" komutunu çalıştırın.

API anahtarlarını kısıtlama

Google, API anahtarlarınızı 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ı istenmeyen isteklere karşı koruyarak güvenliğini artırır. Kısıtlanmamış API anahtarlarının kötüye kullanımından kaynaklanan ücretlerden mali olarak siz sorumlu olursunuz. Daha fazla bilgi için API güvenliğiyle ilgili en iyi uygulamalar başlıklı makaleyi inceleyin.

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

Konsol

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

    Anahtarlar ve Kimlik Bilgileri sayfasına gidin

  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ı bölümünde IP adresleri'ni seçin. 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 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. API kısıtlamalarını seçin bölümünde Directions API'nin seçili olduğundan emin olun. Listede yoksa etkinleştirmeniz gerekir.
  4. Değişikliklerinizi tamamlamak için Kaydet'i tıklayın.

gcloud

Aşağıdaki komutu çalıştırın. KEY_ID yerine anahtarın kimliğini, PROJECT_ID yerine ise proje kimliğinizi yazın. Anahtar kimliğini bulmak için gcloud services api-keys list --project="PROJECT_ID" komutunu çalıştırın. Kimlik, name alanının son kısmıdır.

gcloud services api-keys update KEY_ID \
    --project="PROJECT_ID" \
    --append \
    --api-target=service=directions-backend.googleapis.com \
    --allowed-ips="IP_ADDRESS"

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

API anahtarını isteğinize ekleme

Her Directions API (Eski) 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 kullanmanız gerekir.