Roads API'yi ayarlama

Avrupa Ekonomik Alanı'ndaki (AEA) geliştiriciler

Fatura adresiniz Avrupa Ekonomik Alanı'ndaysa 8 Temmuz 2025'ten itibaren Hizmetler'i kullanımınız Google Haritalar Platformu AEA Hizmet Şartları'na tabi olacaktır. İşlevler bölgeye göre değişir. Daha fazla bilgi edinin.

Bu belgede, Roads API kullanmaya başlamak için uygulamanız 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, Roads API kullanımı için nasıl ücretlendirildiğinizi de bilmeniz gerekir.

1. Kullanım için faturalandırmayı ve maliyeti Roads API Kullanım ve Faturalandırma bölümünde inceleyin.

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

   Google Cloud Console'da oturum açın
   Not: Yeni bir kullanıcıysanız ve Google Cloud Hesabınız yoksa (yani konsolda oturum açamıyorsanız) Google Maps Platform'u kullanmaya başlama başlıklı makaleyi inceleyin.

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

   Faturalandırma sayfasına gidin
   Not: Yeni bir kullanıcıysanız ve Google Cloud projeniz yoksa Google Maps Platform'u kullanmaya başlama başlıklı makaleyi inceleyin.
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.

API'yi etkinleştirme

Roads API hizmetini kullanabilmek için Google Cloud Console'u veya gcloud komutunu kullanarak Google Cloud projenizde bu hizmeti etkinleştirmeniz gerekir.

Not: Bir API'yi etkinleştirdikten sonra istek gönderebilmek için birkaç dakika beklemeniz gerekebilir.

API'yi etkinleştirmek için:

Konsol

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

   Roads API özelliğini etkinleştirme

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

   Not: API zaten etkinleştirilmişse Etkinleştir yerine Yönet düğmesini görürsünüz.

gcloud

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

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

• gcloud services enable
• gcloud services disable

Roads API ile kullanmak için API anahtarı alma

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

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 Roads API'nin 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 Roads API'yi seçin.
     3. Kaydet'i tıklayın.

   Burada bir API seçmek, API'yi etkinleştirmez. Roads API API'sinin 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=roads.googleapis.com

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

  • gcloud services api-keys create

• 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=roads.googleapis.com

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

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

  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 isteği gönderme

Belirtilen noktaları yol geometrisine sabitleyen bir JSON yanıtı döndürmek için Roads API isteği gönderin. Her isteğe API anahtarınızın alfanümerik dizesini eklemeniz ve API anahtarını içeren istekler için HTTPS kullanmanız gerekir.

1. Anahtarın alfasayısal dizesini eklemek için aşağıdaki kodda API_KEY simgesini tıklayın:

   curl -L -X GET 'https://roads.googleapis.com/v1/snapToRoads?path=-35.27801%2C149.12958%7C-35.28032%2C149.12907%7C-35.28099%2C149.12929%7C-35.28144%2C149.12984%7C-35.28194%2C149.13003%7C-35.28282%2C149.12956%7C-35.28302%2C149.12881%7C-35.28473%2C149.12836&interpolate=true&key=YOUR_API_KEY'
   

2. curl komutunu kopyalamak için kod örneğindeki kopyalama simgesini () tıklayın.
3. Komutu bir terminal penceresine yapıştırıp çalıştırın.

Yanıt, aşağıdaki biçimde bir JSON nesnesidir:

{
  "snappedPoints": [
    {
      "location": {
        "latitude": -35.278004899930188,
        "longitude": 149.129531998742
      },
      "originalIndex": 0,
      "placeId": "ChIJr_xl0GdNFmsRsUtUbW7qABM"
    },
    {
      "location": {
        "latitude": -35.2784195,
        "longitude": 149.12946589999999
      },
      "placeId": "ChIJr_xl0GdNFmsRsUtUbW7qABM"
    },
    ...
    {
      "location": {
        "latitude": -35.284727644851415,
        "longitude": 149.12833853807396
      },
      "originalIndex": 7,
      "placeId": "ChIJtWxAZmpNFmsRlbUCkc6VtnA"
    }
  ]
}

API anahtarı kısıtlamaları uygulama

Dikkat: Kısıtlanmamış bir API anahtarı, Roads API dahil olmak üzere herhangi bir Google Haritalar Platformu hizmetine istek göndermek için kullanılabilir. Kısıtlanmamış API anahtarlarının kötüye kullanımından kaynaklanan ücretlerden mali olarak siz sorumlu olursunuz.

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?

Roads API hizmetini etkinleştirip başarılı bir istek gönderdiğinize göre API'yi kullanma hakkında daha fazla bilgi edinmek için Yollara Hızlı Geçiş sayfasını inceleyebilirsiniz.