API Anahtarlarını Kullan

Google Haritalar Platformu ürünleri, API çağrılarının uygun kimlik doğrulama kimlik bilgilerini sağlayan ürünlerle kısıtlanmasıyla yetkisiz kullanıma karşı korunur. Bu kimlik bilgileri API anahtarı biçimindedir. API anahtarı, Google faturalandırma hesabınızı projenizle ve belirli 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

Maps JavaScript API'yi kullanmaya başlamadan önce, faturalandırma hesabı bulunan ve Maps JavaScript API'nin etkinleştirildiği 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

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

    Kimlik bilgileri sayfasına gidin

  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ı altı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"

Google Cloud SDK, Google 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ımlarını yalnızca uygulamanız için gereken API'lerle sınırlandırarak bunları kısıtlamanızı önemle önerir. 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 göz atın.

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

Konsol

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

    Kimlik bilgileri sayfasına gidin

  2. Kısıtlama ayarlamak istediğiniz API anahtarını seçin. API anahtarı özelliği sayfası görünür.
  3. Temel 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 siteleri listesinden gelen istekleri kabul etmek için Uygulama kısıtlamaları listesinden HTTP yönlendirenleri (web siteleri) seçeneğini belirleyin.
      2. Bir veya daha fazla yönlendiren web sitesi belirtin. Tüm alt alan adlarını yetkilendirmek için joker karakterler kullanabilirsiniz (örneğin, https://*.google.com, HTTPS üzerinden erişildiğinde .google.com ile biten tüm siteleri kabul eder). www.domain.com alanını belirtirseniz bunun bir www.domain.com/* joker karakteri gibi davranacağını ve bu ana makine adındaki tüm alt yolları yetkilendireceğini unutmayın. https:// ve http:// yönlendiren şemalarını olduğu gibi belirtin. Diğer URL protokolleri için özel bir temsil kullanmanız gerekir. Örneğin, file:///path/to/ öğesini __file_url__//path/to/* olarak biçimlendirin. Web sitelerini etkinleştirdikten sonra, beklentilerinizi karşılayıp karşılamadığını kontrol etmek için kullanımınızı izlediğinizden emin olun. Ş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ı:
      1. Anahtarı kısıtla'yı tıklayın.
      2. API'leri seçin açılır menüsünden Haritalar JavaScript API'si seçeneğini belirleyin. Maps JavaScript API listede yoksa etkinleştirmeniz gerekir.
      3. Projeniz Yerler Kitaplığı'nı kullanıyorsa Places API'yi de seçin. Benzer şekilde, projenizde JavaScript API'deki diğer hizmetler (Yol Tarifi Hizmeti, Mesafe Matrisi Hizmeti, Elevation Hizmeti ve/veya Coğrafi Kodlama Hizmeti) kullanılıyorsa bu listeden ilgili API'yi de etkinleştirip seçmeniz 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 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"

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

İsteğinize API anahtarı ekleme

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

<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>