Google Haritalar Platformu'nu kullanmaya başlama

Bu sayfada, Google Haritalar Platformu'ndaki API'leri ve SDK'ları kullanmaya başlamak için gereken temel adımlar açıklanmaktadır.

Hızlı başlangıç kılavuzu

Faturalandırma hesabı veya proje oluşturmak için Google Cloud Console'u hiç kullanmadıysanız yeni kullanıcılar için Cloud Console'da etkileşimli bir kurulum deneyimine bağlantı veren Başlayın düğmesini tıklayın:

Başlayın

Alternatif olarak, aşağıdaki gerekli kurulum adımlarını tamamlayabilirsiniz:

1. adım: Projenizi oluşturun

Konsol

  1. Google Cloud Console'daki proje seçici sayfasında, yeni bir Cloud projesi oluşturmaya başlamak için Proje Oluştur'u tıklayın.

    Proje seçici sayfasına gidin.

  2. Cloud projeniz için faturalandırmanın etkinleştirildiğinden emin olun. Projeniz için faturalandırmanın etkinleştirildiğini onaylayın.

    Google Cloud, ücretsiz deneme sürümü sunar. Deneme süresi, 90 günün sonunda veya hesapta 300 ABD doları tutarında ücret tahakkuk ettikten sonra (hangisi önce gerçekleşirse) sona erer. İstediğiniz zaman iptal edebilirsiniz. Daha fazla bilgi için Faturalandırma hesabı kredileri ve Faturalandırma başlıklı makaleleri inceleyin.

Google Cloud SDK

gcloud projects create "PROJECT"

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

2. adım: API'leri veya SDK'ları etkinleştirin

Google Haritalar Platformu'nu kullanmak için projenizde kullanmayı planladığınız API'leri veya SDK'ları etkinleştirmeniz gerekir.

Bazı entegrasyonlar için birden fazla API/SDK etkinleştirmeniz gerektiğini unutmayın. Hangi API'leri veya SDK'ları etkinleştirmeniz gerektiğinden emin değilseniz Özellikler Gezgini'ni kullanmayı deneyin veya kullanmak istediğiniz API/SDK ile ilgili belgelere bakın.

Bir veya daha fazla API ya da SDK'yı etkinleştirmek için:

Konsol

  1. Cloud Console'da Maps API Kitaplığı sayfasına giderek etkinleştirebileceğiniz Google Haritalar Platformu API'lerini ve SDK'larını görebilirsiniz:

    Maps API Kitaplığı sayfasına gidin.

  2. Etkinleştirmek istediğiniz API'yi veya SDK'yı tıklayın.
    • Düğmede ETKİNLEŞTİR yazıyorsa API'yi veya SDK'yı etkinleştirmek için düğmeyi tıklayın.
    • Düğmede YÖNET yazıyorsa API veya SDK zaten etkindir ve başka bir işlem yapmanız gerekmez.
    • Bu düğmelerden birini tıkladığınızda API veya SDK'nın kontrol paneli gösterilir. (API veya SDK'yı bu projeden kaldırmak için DEVRE DIŞI BIRAK düğmesini tıklayın.)

Google Cloud SDK

Aşağıdaki komut tüm Maps, Routes ve Places API'lerini etkinleştirir:

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

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

Environment API'leri etkinleştirmek için şu komutu kullanın:

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.googleapis.com"

3. adım: API anahtarı alın

Bu adımda yalnızca API anahtarı oluşturma işlemi açıklanmaktadır. API anahtarınızı üretimde kullanıyorsanız API anahtarınızı kısıtlamanızı önemle tavsiye ederiz. Ürüne özel API anahtarlarını kullanma sayfasında daha fazla bilgi bulabilirsiniz.

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şkili en az bir API anahtarınız olmalıdır. 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 kullanmayı planladığınız API'lerin 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. Select API restrictions (API kısıtlamalarını seçin) listesinde kullanmayı planladığınız API'leri seçin.
      3. Kaydet'i tıklayın.

    Burada bir API seçmek, API'yi etkinleştirmez. Seçtiğiniz her API'nin API Kitaplığı'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.

Google Cloud SDK

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. SERVICE_NAME kısmını, kullanmayı planladığınız bir API'nin hizmet adıyla (ör. places.googleapis.com) değiştirin. Daha fazla API'ye izin vermek için --api-target işaretini tekrarlayın.

    gcloud services api-keys create \
    --project="PROJECT_ID" \
    --display-name="DISPLAY_NAME" \
    --api-target=service=SERVICE_NAME

    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. SERVICE_NAME kısmını, eklenecek API'nin hizmet adıyla 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=SERVICE_NAME

    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.

Faturalandırma Hesabı Kredileri

Sonraki adımlar

Kurulumu tamamladıktan sonra Google Haritalar Platformu API'lerini ve SDK'larını kullanmaya başlayabilirsiniz. Daha fazla bilgi edinmek için ilgilendiğiniz API veya SDK'nın Genel Bakış, Geliştirici ve Başlangıç kılavuzlarına bakın. API'ler ve SDK'lar, Google Haritalar Platformu Belgeleri (ürüne göre) ve Google Haritalar Platformu API'leri (platforma göre) sayfalarında listelenir.