Places API ile API Anahtarlarını Kullanma

Platform seçin: Android iOS JavaScript Web Hizmeti

Google Haritalar Platformu ürünleri, API çağrıları kısıtlanarak yetkisiz kullanıma karşı korunur kimlik doğrulama bilgilerini sağlayan kişilere veri feed'i ekleyin. Bu kimlik bilgileri, Google faturalandırma hesabınızı projenizle ve belirli API veya SDK ile ilişkilendiren benzersiz bir alfanümerik dize olan API anahtarı biçimindedir.

Bu kılavuzda, Google Haritalar Platformu için API anahtarınızı nasıl oluşturacağınız, kısıtlayacağınız ve kullanacağınız gösterilmektedir.

Başlamadan önce

Places API'yi kullanmaya başlamadan önce, faturalandırma hesabı ve Places API'nin etkinleştirildiği 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 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. Alıcı: yanlışlıkla ödeme alınmasını önlemek için diğer tüm API anahtarlarını kontrol edin ve yalnızca Yerler API'sini veya Places API'yi (Yeni) etkinleştirmelidir. gerekir.

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'na gidin > Credentials (Kimlik Bilgileri) sayfasını ziyaret edin.

   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ı, Kimlik bilgileri sayfasında API anahtarları altında listelenir.
   . (API'yi kısıtlamayı unutmayın. anahtarının doğru şekilde yüklenmesini sağlayın.)

Google Cloud SDK

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

Şu konu hakkında daha fazla bilgi edinin: Google Cloud SDK'sı , Google Cloud SDK kurulumu ve aşağıdaki komutları içerir:

• gcloud alpha services api-keys create

API anahtarlarını kısıtlama

Google, API anahtarlarınızın kullanımını yalnızca bu anahtarlarla sınırlamanızı önerir. Uygulamanız için gereken API'ler. API anahtarlarını kısıtlamak, aşağıdakileri yaparak uygulamanızın güvenliğini artırır: haksız taleplere karşı koruyabilir. Daha fazla bilgi için bkz. API güvenliği en iyi uygulamaları.

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.

Bir API anahtarını kısıtlamak için:

Konsol

1. Google Haritalar Platformu'na gidin > Credentials (Kimlik Bilgileri) sayfasını ziyaret edin.

   Kimlik Bilgileri sayfasına gidin

2. Kısıtlama ayarlamak istediğiniz API anahtarını seçin. API anahtarı mülkü sayfası görüntülenir.
3. Anahtar kısıtlamaları bölümünde aşağıdaki kısıtlamaları ayarlayın:
• Uygulama kısıtlamaları:
1. Sağladığınız web sunucusu IP adresleri listesinden gelen istekleri kabul etmek için Uygulama kısıtlamaları listesinden IP adresleri (web sunucuları, cron işleri vb.)'ni seçin. CIDR gösterimini kullanarak bir veya daha fazla IPv4 ya da IPv6 adresi ya da alt ağ belirtin. IP adresleri, Google Haritalar Platformu sunucularının gözlemlediği kaynak adresle eşleşmelidir. Şunu kullanıyorsanız: ağ adres çevirisi (NAT), bu genellikle makinenizin herkese açık IP adresine karşılık gelir.
• API kısıtlamaları:
1. Anahtarı kısıtla'yı tıklayın.
2. API'leri seç açılır listesinden Places API veya Places API (Yeni)'yi seçin. Places API veya Places API (Yeni) 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

Places API (Yeni)

Mevcut anahtarları listeleme.

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-ips="IP_ADDRESS"

Şu konu hakkında daha fazla bilgi edinin: Google Cloud SDK'sı , Google Cloud SDK kurulumu ve aşağıdaki komutları içerir:

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

Places API

Mevcut anahtarları listeleme.

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/keys/KEY_ID" \
    --api-target="places-backend.googleapis.com"
    --allowed-ips="IP_ADDRESS"

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

API anahtarını isteğinize ekleme

Her Places API isteğine bir API anahtarı eklemeniz gerekir. Aşağıdaki örnekte YOUR_API_KEY yerine API anahtarınızı girin.

https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=YOUR_API_KEY

API anahtarı kullanan istekler için HTTPS gereklidir.

Not: Web Hizmetleri kullanılırken parametrelerdeki tüm özel karakterler URL olarak kodlanmalıdır. URL'lerin geçerli olması için düzgün bir şekilde kodlanması gerekir ve tüm web hizmetleri için 2.048 karakterle sınırlıdır. URL'lerinizi oluştururken bu sınırı göz önünde bulundurun. Farklı tarayıcılar, proxy'ler ve sunucuların farklı URL karakter sınırlamaları da olabilir.