Places Insights API ile API Anahtarlarını Kullanma

Google Haritalar Platformu ürünleri, API çağrıları kısıtlanarak yetkisiz kullanıma karşı korunur kimlik doğrulama bilgilerini sağlayan kişilere veri feed'i ekleyin. Bu kimlik bilgileri şu biçimdedir: Bir API anahtarı – Google faturalandırma hesabınızı ve belirli bir API ya da SDK ile yapabilirsiniz.

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.

API anahtarları oluşturma

API anahtarı, şunun için projenizle ilişkili isteklerin kimliğini doğrulayan benzersiz bir tanımlayıcıdır: yalnızca kullanım ve faturalandırma için değil. Projenizle ilişkilendirilmiş en az bir API anahtarınız olmalıdır.

API anahtarı oluşturmak için:

Konsol

  1. Google Haritalar Platformu'na gidin > Credentials (Kimlik Bilgileri) sayfasını ziyaret edin.

    Kimlik Bilgileri sayfasına gidin

  2. Credentials sayfasında Create credentials >'ı (Kimlik bilgisi oluştur) tıklayın. API anahtarı.
    API anahtarı oluşturuldu iletişim kutusunda yeni oluşturulan API anahtarınız gösterilir.
  3. Kapat'ı tıklayın.
    Yeni API anahtarı, API anahtarları bölümündeki Kimlik bilgileri sayfasında listelenir.
    (API'yi kısıtlamayı unutmayın. anahtarının doğru şekilde yüklenmesini sağlayın.)

Google Cloud SDK

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

Şu konu hakkında daha fazla bilgi edinin: Google Cloud SDK'sı , Google Cloud SDK kurulumu ve aşağıdaki komutları içerir:

API anahtarlarını kısıtlama

Google, API anahtarlarınızın kullanımını yalnızca bu anahtarlarla sınırlamanızı önerir. Uygulamanız için gereken API'ler. API anahtarlarını kısıtlamak, aşağıdakileri yaparak uygulamanızın güvenliğini artırır: haksız taleplere karşı koruyabilir. Daha fazla bilgi için bkz. API güvenliği en iyi uygulamaları.

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

Konsol

  1. Google Haritalar Platformu'na gidin > Credentials (Kimlik Bilgileri) sayfasını ziyaret edin.

    Kimlik Bilgileri sayfasına gidin

  2. Kısıtlama ayarlamak istediğiniz API anahtarını seçin. API anahtarı mülkü sayfası görüntülenir.
  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ı gözlem yapar. 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 Places Insights API'yi seçin. Places Insights API listede yoksa şunu yapmanız gerekir: etkinleştirin.
  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 alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

Mevcut anahtarda yeni kısıtlamalar belirleyin. 

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --api-target="areainsights.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 Places Insights API isteğine bir API anahtarı eklemeniz gerekir. Aşağıdaki örnekte, YOUR_API_KEY ifadesini API anahtarınızla değiştirin.

https://areainsights.googleapis.com/v1:computeInsights?key=YOUR_API_KEY

API anahtarı kullanan istekler için HTTPS gereklidir.