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ı ve Android için Yerler SDK'sı etkinleştirilmiş bir projeye ihtiyacınız vardır. Daha fazla bilgi için Cloud Console'da ayarlama başlıklı makaleyi inceleyin.

API anahtarları oluşturma

Not: Hem mevcut Android için Yerler SDK'sını hem de Android için Yerler SDK'sını (Yeni) kullanıyorsanız ikisini de aynı API anahtarında etkinleştirebilirsiniz.

API anahtarı, kullanım ve faturalandırma amacıyla 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.
   Oluşturulan API anahtarı iletişim kutusunda yeni oluşturulan API anahtarınız gösterilir.
3. Kapat'ı tıklayın.
   Yeni API anahtarı, API anahtarları bölümündeki Kimlik bilgileri sayfasında listelenir.
   (API anahtarını üretimde kullanmadan önce kısıtlamayı unutmayın.)

Google Cloud SDK

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Google Cloud SDK, 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ı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ı gereksiz isteklerden koruyarak uygulamanızın güvenliğini artırır. Daha fazla bilgi için API güvenliğiyle ilgili en iyi uygulamalar başlıklı makaleyi inceleyin.

Cloud Console'da bir API anahtarını kısıtlarken 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ı uygulayın.

API anahtarınızı kısıtlarken, 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 uygulamalarda ve üretim dışı diğer kodlarda kullanın. Hata ayıklama sertifikasıyla imzalanan bir uygulamayı yayınlamaya çalışmayın. 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ı, 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ılavuzunu inceleyin.

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

• Play Uygulama İmzalama'yı kullanıyorsanız API Sağlayıcılarla Çalışma başlıklı makaleyi inceleyin.
• Kendi imzalama anahtarınızı yönetiyorsanız Uygulamanızı kendiniz imzalama başlıklı makaleyi inceleyin veya derleme ortamınızla ilgili talimatları inceleyin.

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 uygulamak istediğiniz API anahtarını seçin. API anahtarı mülkü 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. Paketinizin adını 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ç açılır listesinden Places API'yi veya Places API (Yeni)'yi seçin. Places API listede yoksa etkinleştirmeniz gerekir.
   Not: Hem mevcut Places API'yi hem de Places API'yi (Yeni) kullanıyorsanız her API sürümü için ayrı bir API anahtarı oluşturmanızı öneririz.
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 anahtar için yeni kısıtlamalar belirleyin.

gcloud alpha services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \
    --api-target=service=places.googleapis.com
    --allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"

Google Cloud SDK, 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

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 anahtar için yeni kısıtlamalar belirleyin.

gcloud alpha services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \
    --api-target=service=places-backend.googleapis.com
    --allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"

Google Cloud SDK, 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

Sırada ne var?

API anahtarınız olduğuna göre, Android Studio Projesi Oluşturma bölümünde açıklandığı gibi bir proje oluşturup yapılandırın.