Android için Yerler SDK'sını ayarlama

Bu belgede, Android için Yerler SDK'sını kullanmaya başlamak için gereken adımlar açıklanmaktadır.

Ön koşullar

Bu prosedür, faturalandırmanın etkin olduğu bir Google Cloud Hesabı ve Google Cloud projesi oluşturma konusunda size yol gösterir. Ayrıca, Android için Yerler SDK'sını kullanırken nasıl ücretlendirildiğinizi de bilmeniz gerekir.

  1. Android için Yerler SDK'sı Kullanımı ve Faturalandırması bölümünde faturalandırmayı ve kullanım maliyetini inceleyin.

  2. Google Cloud Hesabınız olduğunu doğrulayın.

    Google Cloud Console'da oturum açın

  3. Faturalandırmanın etkin olduğu bir Google Cloud projeniz olduğunu doğrulayın.

    Faturalandırma sayfasına gidin
    1. Faturalandırma sayfasını açmak için projenizi seçin.

    2. Faturalandırma sayfasında:

      • Seçilen proje için faturalandırma zaten etkinleştirilmişse ve yalnızca tek bir faturalandırma hesabınız varsa Faturalandırma sayfası açılır.
      • Birden fazla faturalandırma hesabınız varsa projeyle ilişkili faturalandırma hesabı hakkındaki ayrıntıları görmek için Bağlı faturalandırma hesabına git'i seçin.
      • Bir faturalandırma hesabı varsa ancak projeyle ilişkilendirilmemişse bir faturalandırma hesabını projeye bağlamanız istenir.
      • Faturalandırma hesabı yoksa veya yeni bir faturalandırma hesabı oluşturmak istiyorsanız yeni bir faturalandırma hesabı oluşturmak için Faturalandırma Hesaplarını Yönet'i seçin. Daha fazla bilgi için Yeni bir self servis Cloud Faturalandırma Hesabı oluşturma başlıklı makaleyi inceleyin.

SDK'yı etkinleştirme

Places SDK for Android'i kullanabilmek için Google Cloud Console'u veya gcloud komutunu kullanarak Google Cloud projenizde etkinleştirmeniz gerekir.

Android için Yerler SDK'sı, Places API'ye (yeni) bağlıdır. Places API'yi (Yeni) etkinleştirmek için:

Konsol

  1. Google Cloud Console'da ürün sayfasını açın:

    Places API'yi (yeni) etkinleştirme

  2. Etkinleştir düğmesini tıklayın.

gcloud

gcloud services enable \
    --project "PROJECT" \
    "places.googleapis.com"

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

API anahtarını yapılandırma

Google Haritalar Platformu ürünleri, API çağrılarının bir API anahtarı içermesini zorunlu kılarak yetkisiz kullanıma karşı korunur.

Places API (Yeni) ile kullanmak için API anahtarı alma

API anahtarı, Cloud Faturalandırma Hesabınızı ve Google Cloud projenizi, uygulamanızın bir Google Haritalar Platformu API'sine veya SDK'sına yaptığı istekle ilişkilendiren benzersiz bir alfanümerik dizedir. Yeni bir anahtar oluşturmak veya mevcut bir anahtara API ya da SDK eklemek için bu talimatları uygulayın.

Konsol

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

    Anahtarlar ve Kimlik Bilgileri sayfasına gidin

  2. İstenirse projenizi seçin.

  3. Aşağıdakilerden birini yapın:

    • Yeni anahtar oluşturma:

      1. Kimlik bilgileri oluştur > API anahtarı'nı tıklayın.
      2. API anahtarı oluştur panelinde API kısıtlamalarını seçin listesini açın.
      3. Bu anahtarın ihtiyaç duymadığı API'leri temizleyin ve Places API (New)'in seçili kaldığından emin olun.
      4. Oluştur'u tıklayın. Panelde yeni API anahtarınız gösterilir.

    • Mevcut bir anahtarı kullanma:

      1. Anahtarın adını tıklayın.
      2. API kısıtlamalarını seçin listesinde Places API (New)'i seçin.
      3. Kaydet'i tıklayın.

    Burada bir API seçmek, API'yi etkinleştirmez. Places API'nin (Yeni) API Kitaplığı sayfasında etkinleştirildiğinden emin olun.

  4. Anahtar dizesini daha sonra görmek için Anahtarlar ve Kimlik Bilgileri sayfasına gidip anahtar için Anahtarı göster'i tıklayın.

Konsol bu adımlardan farklı görünüyorsa Google Cloud belgelerindeki API anahtarı oluşturma ve API kısıtlamaları ekleme bölümlerine bakın.

gcloud

Aşağıdaki komutlarda PROJECT_ID ifadesini proje kimliğinizle değiştirin.

  • Yeni anahtar oluşturma: Aşağıdaki komutu çalıştırın ve DISPLAY_NAME yerine anahtarın adını yazın. 

    gcloud services api-keys create \
    --project="PROJECT_ID" \
    --display-name="DISPLAY_NAME" \
    --api-target=service=places.googleapis.com

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

  • Mevcut bir anahtarı kullanma: Aşağıdaki komutu çalıştırın ve KEY_ID değerini anahtarın kimliğiyle değiştirin. --append işareti, anahtarın halihazırda izin verdiği API'leri korur. Bu parametre kullanılmadığında komut, mevcut etiketleri değiştirir.

    gcloud services api-keys update KEY_ID \
    --project="PROJECT_ID" \
    --append \
    --api-target=service=places.googleapis.com

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

    Anahtar kimliği, anahtar dizesi veya görünen ad değildir. Bunu bulmak için gcloud services api-keys list --project="PROJECT_ID" komutunu çalıştırın. Kimlik, name alanının son kısmıdır: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.

Anahtar dizesini görmek için gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID" komutunu çalıştırın.

API anahtarı kısıtlamaları uygulama

Google, API anahtarlarınızı yalnızca ihtiyaç duyan API'ler ve uygulamalarla sınırlayarak kısıtlamanızı önemle tavsiye eder. API anahtarlarını kısıtlamak, uygulamanızı haksız isteklere karşı koruyarak güvenliğini artırır. API anahtarları iki tür kısıtlamayı destekler:

  • API kısıtlamaları, API anahtarı kullanılarak hangi SDK'ların ve API'lerin çağrılabileceğini belirtir. Konsol ve gcloud CLI, anahtar oluştururken en az bir API kısıtlaması gerektirir.
  • Uygulama kısıtlamaları, bir API anahtarını hangi web sitelerinin, IP adreslerinin veya uygulamaların kullanabileceğini belirtir.

Kısıtlama uygulama hakkında daha fazla bilgi için API anahtarlarınızı kısıtlama başlıklı makaleyi inceleyin.

Sırada ne var?

Android için Yerler SDK'sını etkinleştirip bir API anahtarı yapılandırdığınıza göre, Xcode'u nasıl yapılandıracağınız ve API anahtarını uygulamanıza nasıl ileteceğiniz hakkında daha fazla bilgi edinmek için Android Studio projesi oluşturma başlıklı makaleyi inceleyin.