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.
Başlamadan önce
Maps JavaScript API'yi kullanmaya başlamadan önce faturalandırma hesabı olan bir projenize ve Maps JavaScript API etkin. Daha fazla bilgi için Cloud Console'da ayarlama bölümüne bakın.
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
-
Google Haritalar Platformu'na gidin > Credentials (Kimlik Bilgileri) sayfasını ziyaret edin.
-
Credentials sayfasında Create credentials >'ı (Kimlik bilgileri oluştur) tıklayın. API anahtarı.
API anahtarı oluşturuldu iletişim kutusunda yeni oluşturulan API anahtarınız gösterilir. -
Kapat'ı tıklayın.
. Yeni API anahtarı, Kimlik bilgileri sayfasında API anahtarları altı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
-
Google Haritalar Platformu'na gidin > Credentials (Kimlik Bilgileri) sayfasını ziyaret edin.
- Kısıtlama ayarlamak istediğiniz API anahtarını seçin. API anahtarı mülkü sayfası görüntülenir.
- 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 siteleri listesinden gelen istekleri kabul etmek için HTTP'yi seçin Uygulama listesinden yönlendirenler (web siteleri) kısıtlamalar hakkında daha fazla bilgi edinin.
- Bir veya daha fazla yönlendiren web sitesi belirtin. Joker karakter kullanabilirsiniz
karakterleri (örneğin,
https://*.google.com
ile biten tüm siteler kabul edilir HTTPS üzerinden erişildiğinde.google.com
). Belirli bir süre için www.alanadi.com ise, www.alanadi.com/* joker karakteri gibi çalışır ve söz konusu ana makine adındaki tüm alt yolları yetkilendirir.https://
vehttp://
yönlendiren şemalarını olduğu gibi belirtin. Diğer URL protokolleri için özel bir gösterim kullanmanız gerekir. Örneğin, örnek,file:///path/to/
biçimini şu şekilde biçimlendirin:__file_url__//path/to/*
. Web sitelerini etkinleştirdikten sonra, web sitenizin ziyaret edilmeden önce uyumlu olduğundan emin olmaktır. Şu protokoller desteklenir:about://
,app://
,applewebdata://
,asset://
,chrome://
,content://
,file://
,ftp://
,ionic://
,local://
,ms-appx://
,ms-appx-web://
,ms-local-stream://
,prism://
,qrc://
,res://
,saphtmlp://
. - API kısıtlamaları:
- Anahtarı kısıtla'yı tıklayın.
- API'leri seç açılır listesinden Haritalar JavaScript API'yi seçin. Maps JavaScript API listede yoksa etkinleştirin.
- Projeniz Yerler Kitaplığı kullanıyorsa Places API'yi seçin. Benzer şekilde, projeniz JavaScript API'deki başka hizmetler kullanıyorsa (Yol Tarifi Hizmeti, Mesafe Matrisi Hizmeti, Yükseltme Hizmeti ve/veya Coğrafi Kodlama Hizmeti) bu listeden ilgili API'yi de etkinleştirmeniz ve seçmeniz gerekir.
- Değişikliklerinizi tamamlamak için Kaydet'i tıklayın.
Google Cloud SDK
Mevcut anahtarları listeleme.
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="maps-backend.googleapis.com" --allowed-referrers="referer"
Şu konu hakkında daha fazla bilgi edinin: Google Cloud SDK'sı , Google Cloud SDK kurulumu ve aşağıdaki komutları içerir:
İsteğinize API anahtarını ekleme
Her Maps JavaScript API isteğine bir API anahtarı eklemeniz gerekir.
Aşağıdaki örnekte YOUR_API_KEY
değerini
API anahtarı.
<script> (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({ key: "YOUR_API_KEY", v: "weekly", // Use the 'v' parameter to indicate the version to use (weekly, beta, alpha, etc.). // Add other bootstrap parameters as needed, using camel case. }); </script>