Google Haritalar Platformu ürünleri, API çağrılarının uygun kimlik doğrulama kimlik bilgilerini sağlayan ürünlerle kısıtlanması sayesinde yetkisiz kullanıma karşı korunur. Bu kimlik bilgileri API anahtarı biçimindedir. API anahtarı, Google faturalandırma hesabınızı projenizle ve ilgili API veya SDK ile ilişkilendiren benzersiz bir alfanümerik dizedir.
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
Places API'yi kullanmaya başlamadan önce faturalandırma hesabı olan ve Places API'nin etkin olduğu bir projeye ihtiyacınız vardır. Daha fazla bilgi edinmek için Cloud Console'da kurma bölümüne bakın.
API anahtarları oluşturma
API anahtarı, kullanım ve faturalandırma amaçları doğrultusunda 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
-
Google Haritalar Platformu > Kimlik bilgileri sayfasına gidin.
-
Kimlik bilgileri sayfasında, Kimlik bilgisi oluştur > API anahtarı'nı tıklayın.
API anahtarı oluşturuldu iletişim kutusunda yeni oluşturulan API anahtarınız gösterilir.
-
Kapat'ı tıklayın.
Yeni API anahtarı, API anahtarları altındaki Kimlik bilgileri sayfasında listelenir.
(Üretimde kullanmadan önce API anahtarını kısıtlamayı unutmayın.)
Google Cloud SDK
gcloud alpha services api-keys create \ --project "PROJECT" \ --display-name "DISPLAY_NAME"
API anahtarlarını kısıtlama
Google, API anahtarlarınızın kullanımları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ı istenmeyen isteklerden koruyarak güvenliği artırır. Daha fazla bilgi için API güvenliği en iyi uygulamalarına bakın.
Bir API anahtarını kısıtlamak için:
Konsol
-
Google Haritalar Platformu > Kimlik bilgileri sayfasına gidin.
- Kısıtlama ayarlamak istediğiniz API anahtarını seçin. API anahtarı özelliği sayfası görünür.
- Anahtar kısıtlamalar bölümünde, aşağıdaki kısıtlamaları ayarlayın:
- Uygulama kısıtlamaları:
- 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 veya 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 genel IP adresine karşılık gelir.
- API kısıtlamaları:
- Anahtarı kısıtla'yı tıklayın.
- API'leri seçin açılır menüsünden Places API'yi veya Places API'yi (Yeni) seçin ancak her ikisini birden seçmeyin. Places API veya Places API (Yeni) listede yoksa enable gerekir.
- Değişikliklerinizi tamamlamak için Kaydet'i tıklayın.
Google Cloud SDK
Places API (Yeni)
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="places.googleapis.com" --allowed-ips="IP_ADDRESS"
Places API
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="places-backend.googleapis.com" --allowed-ips="IP_ADDRESS"
İsteğinize API anahtarı ekleme
Her Places API isteğine bir API anahtarı eklemeniz gerekir. Aşağıdaki örnekte,
YOUR_API_KEY değerini API anahtarınızla değiştirin.
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=YOUR_API_KEY
API anahtarı kullanan istekler için HTTPS gereklidir.