API Anahtarlarını Kullan

Google Haritalar Platformu ürünleri, API çağrılarını doğru kimlik doğrulama bilgileri sağlayanlarla sınırlandırarak yetkisiz kullanıma karşı korunur. Bu kimlik bilgileri, Google faturalandırma hesabınızı projenizle ve belirli bir API veya SDK ile ilişkilendiren benzersiz bir alfanümerik dize olan API anahtarı biçimindedir.

Bu kılavuz, 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österir.

Başlamadan önce

Maps JavaScript API'yi kullanmaya başlamadan önce faturalandırma hesabı ve Haritalar JavaScript API'si etkinleştirilmiş bir projeye sahip olmanız gerekir. Daha fazla bilgi için Cloud Console'da kurulum bölümünü inceleyin.

API anahtarları oluşturma

API anahtarı, kullanım ve faturalandırma amacıyla projenizle ilişkilendirilen 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 bilgisi sayfasına git

  2. 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ı gösterilir.
  3. Kapat'ı tıklayın.
    Yeni API anahtarı, Kimlik bilgileri sayfasındaki API anahtarları bölümünde listelenir.
    (Üretimde kullanmadan önce API API'sini 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 kurulumu ve aşağıdaki komutlar hakkında daha fazla bilgi edinin:

API anahtarlarını kısıtla

Google, API anahtarlarınızın kullanımı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ı konusuna bakın.

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

Konsol

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

    Kimlik bilgisi sayfasına git

  2. Kısıtlama ayarlamak istediğiniz API anahtarını seçin. API anahtarı özellik sayfası görüntülenir.
  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önlendirenler (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). 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şıladığından emin olmak için kullanımınızı izleyin. Desteklenen protokoller: 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 listesinden 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 projeniz, JavaScript API'deki diğer hizmetleri (Yol Tarifi Hizmeti, Mesafe Matrisi Hizmeti, Yükseklik Hizmeti ve/veya Coğrafi Kodlama Hizmeti'ni kullanıyorsa da bu listede ilgili API'yi 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 anahtar için 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 kurulumu ve aşağıdaki komutlar hakkında daha fazla bilgi edinin:

API anahtarını isteğinize ekleyin

Her Haritalar JavaScript API isteğine bir API anahtarı eklemeniz gerekir. Aşağıdaki örnekte YOUR_API_KEY'yi 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_HERE",
    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>