API Anahtarlarını Kullanma

Platform seçin: Android iOS JavaScript Web Hizmeti

Başlamadan önce

Android için Yerler SDK'sını kullanmaya başlamadan önce, faturalandırma hesabı olan ve Android için Yerler SDK'sının etkinleştirilmiş olduğu bir projeye ihtiyacınız vardır. Daha fazla bilgi edinmek için Cloud Console'da ayarlama 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örüntülenir.
  3. 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"

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ımını yalnızca uygulamanız için gereken API'lerle sınırlandırarak API anahtarlarınızı kısıtlamanızı önemle tavsiye eder. API anahtarlarını kısıtlamak, uygulamanızı istenmeyen isteklere karşı koruyarak güvenliği artırır. Daha fazla bilgi için API güvenliği en iyi uygulamalarına bakın.

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:

  • Hata ayıklama sertifikası: Bu sertifika türünü yalnızca test ettiğiniz uygulamalarla ve üretim dışı diğer kodlarla kullanın. Hata ayıklama sertifikasıyla imzalanmış bir uygulama yayınlamayı denemeyin. Android SDK araçları, bir 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ı, bir 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:

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ı özellik sayfası görünür.
  3. Anahtar 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. Paket adınızı ve SHA-1 sertifika 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 Places API'yi veya Places API'yi (Yeni) seçin. İki seçeneği birden seçmeyin. Places API listede yoksa enable gerekir.
  4. Değişikliklerinizi tamamlamak için Kaydet'i tıklayın.

Google Cloud SDK

Android için Yerler SDK'sı (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-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:

Android için Yerler SDK'sı

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

Sonraki adımlar

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