API Anahtarlarını Kullanma

Platform seçin: Android iOS JavaScript

Başlamadan önce

Android için Haritalar SDK'sını kullanmaya başlamadan önce faturalandırma hesabı ve Android için Haritalar SDK'sı etkinleştirilmiş 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:

• gcloud alpha services api-keys create

Not: Android için Haritalar SDK'sı ve Android için Yerler SDK'sı uygulamalarınızda aynı API anahtarını kullanabilirsiniz.

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.

Cloud Console'da bir API anahtarı kısıtlanırken Uygulama kısıtlamaları, API kısıtlamaları kapsamında etkinleştirilen tüm API'leri geçersiz kılar. Her uygulama ve uygulamanın kullanılabildiği her platform için ayrı bir API anahtarı oluşturarak en iyi uygulamaları izleyin.

API anahtarınızı kısıtladığınızda uygulamayı imzalamak için kullanılan imzalama anahtarının SHA-1 sertifika parmak izini sağlamanız gerekir. İki sertifika türü vardır:

• Sertifikada hata ayıkla: Bu sertifika türünü yalnızca test ettiğiniz uygulamalar ve üretim dışı diğer kodlarla kullanın. Hata ayıklama sertifikasıyla imzalanmış bir uygulamayı yayınlamayı denemeyin. Android SDK araçları, hata ayıklama derlemesi çalıştırdığınızda bu sertifikayı otomatik olarak oluşturur.
• Sürüm sertifikası: Uygulamanızı bir uygulama mağazasında yayınlamaya hazır olduğunuzda bu sertifikayı kullanın. Android SDK araçları, sürüm derlemesi çalıştırdığınızda bu sertifikayı oluşturur.

Android uygulama imzalama ve sertifikaları hakkında daha fazla bilgi için Uygulamanızı imzalama kılavuzuna bakın.

İmza sertifikası parmak izinizi nasıl bulacağınızla ilgili talimatlar için aşağıdaki referanslara bakın:

• Play Uygulama İmzalama kullanıyorsanız API Sağlayıcılarıyla Çalışma bölümüne bakın.
• Kendi imzalama anahtarınızı yönetiyorsanız Uygulamanızı kendi kendine imzalama konusuna bakın veya derleme ortamınızın talimatlarına bakı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. Android uygulamaları'nı seçin.
2. + Paket adı ve parmak izi ekle'yi tıklayın.
3. Paketinizin adını ve SHA-1 sertifikası parmak izini girin. Örneğin:

   com.example.android.mapexample

   BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75

• API kısıtlamaları:
1. Anahtarı kısıtla'yı tıklayın.
2. API'leri seçin açılır menüsünden Android için Haritalar SDK'sı seçeneğini belirleyin. Android için Haritalar SDK'sı listede yoksa bu SDK'yı etkinleştirmeniz 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-android-backend.googleapis.com"
    --allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"

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

• gcloud alpha services api-keys update
• gcloud alpha services api-keys lookup
• gcloud services api-keys list

Sonraki adımlar

Artık bir API anahtarınız var. Şimdi de Android Studio Projesi Oluşturma bölümünde açıklandığı şekilde proje oluşturup yapılandırın.