Maps Embed API hızlı başlangıç kılavuzu

Basit bir HTTP isteğiyle web sayfanıza etkileşimli bir harita veya Street View panoraması yerleştirin. JavaScript gerekmez.

Maliyetler

Tüm Haritalar İçe Aktarma API'si istekleri sınırsız kullanımla ücretsizdir. Ancak tüm istekler için geçerli bir Google Cloud API anahtarı gerekir. Daha fazla bilgi için Kullanım ve Faturalandırma başlıklı makaleyi inceleyin.

Başlamadan önce

Web sayfanızda yerleşik bir harita oluşturmak için aşağıdaki sekmeleri tıklayarak gerekli kurulum adımlarını tamamlayın:

1. Adım

Konsol

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

    Proje seçici sayfasına gidin.

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

    Google Cloud, 0,00 ABD doları ücretli deneme sürümü sunar. Deneme süresinin sonu, 90 günün sonunda veya hesapta 300 ABD doları tutarında ödeme yapıldıktan sonra (hangisi önce gerçekleşirse) gelir. İstediğiniz zaman iptal edebilirsiniz. Google Haritalar Platformu'nda aylık 200 ABD doları tutarındaki yinelenen bir kredi bulunur. 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ükleme ve aşağıdaki komutlar hakkında daha fazla bilgi edinin:

2. Adım

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

Konsol

Maps Embed API'yi etkinleştirme

Google Cloud SDK

gcloud services enable \
    --project "PROJECT" \
    "maps-embed-backend.googleapis.com"

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

3. Adım

Bu adımda yalnızca API anahtarı oluşturma işlemi gerçekleştirilir. API anahtarınızı üretimde kullanıyorsanız API anahtarınızı kısıtlamanızı önemle tavsiye ederiz. Daha fazla bilgi için ürüne özel API Anahtarlarını Kullanma sayfasını inceleyin.

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:

Iframe oluşturma

Web sayfanız için bir iframe oluşturmak üzere aşağıdaki seçenekleri tıklayın ve bir konum ile API anahtarı ekleyin. Diğer parametreler ve seçenekler için Harita yerleştirme başlıklı makaleyi inceleyin.

Iframe'inizi test etme

Iframe'inizi bir HTML tarayıcı penceresinde görmek için:

  1. Varsayılan metin düzenleyicinizi açın. Cihazınızda varsayılan olarak TextEdit veya Microsoft Windows Not Defteri gibi metin düzenleyiciler yüklü olmalıdır.
  2. Bir HTML dosyası oluşturup index.html olarak adlandırın.

  3. Yukarıda oluşturduğunuz iFrame'ye aşağıdaki kodu ekleyin:

    <html>
  <!-- Replace this code comment with your iframe. -->
</html>

  4. index.html HTML dosyanızı kaydedin.

  5. HTML dosyasını masaüstünüzden tarayıcınıza sürükleyerek bir web tarayıcısından yükleyin. Alternatif olarak, çoğu işletim sisteminde dosyayı çift tıklayarak da yükleyebilirsiniz.

Tebrikler! Haritalar İçe Aktarma API'sini kullanarak bir harita oluşturdunuz.

Temizleme

Projede kullanılan tüm kaynaklar için faturalandırmayı durdurmak amacıyla Google Cloud projenizi silebilirsiniz.

  1. Google Cloud Console'da Kaynakları yönet sayfasına gidin:

    Kaynakları yönet sayfasına gidin.

  2. Silmek istediğiniz proje bir kuruluşa bağlıysa sayfanın üst kısmındaki kuruluş listesini seçip genişletin.
  3. Proje listesinde, silmek istediğiniz projeyi seçin ve Sil'i tıklayın.
  4. Projeyi silmek için iletişim kutusuna proje kimliğini yazın ve Kapat'ı tıklayın.

Sonraki adımlar