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 Embed API istekleri sınırsız kullanımla ücretsizdir. Ancak tüm isteklerde geçerli bir Google Cloud API anahtarı gerekir. Daha fazla bilgi için Kullanım ve Faturalandırma bölümüne bakın.

Başlamadan önce

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

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. Projenizde faturalandırmanın etkin olduğunu onaylayın.

    Google Cloud, 0,00 ABD doları ücretli deneme sürümü sunar. Deneme süresi 90 günün sonunda sona erer gün içinde veya hesaba 300 TL tutarında masraf tahakkuk ettikten sonra (hangisi önce gerçekleşirse) bunu yapabilirsiniz. İptal devam edebilir. Google Haritalar Platformu'nda aylık 200 ABD doları tutarındaki yinelenen bir kredi bulunur. Daha fazla bkz. Faturalandırma hesabı kredileri ve Faturalandırma.

Google Cloud SDK

gcloud projects create "PROJECT"

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

2. Adım

Google Haritalar Platformu'nu kullanmak için projenizde 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"

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

3. Adım

Bu adım yalnızca API anahtarı oluşturma işlemiyle yapılır. API Anahtarınızı API anahtarınızı kısıtlamanızı önemle tavsiye ederiz. Daha fazla bilgi için ürüne özel API Anahtarları Kullanma sayfasına gidin.

API anahtarı, şunun için projenizle ilişkili isteklerin kimliğini doğrulayan benzersiz bir tanımlayıcıdır: yalnızca kullanım ve faturalandırma için değil. 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. Credentials sayfasında Create credentials >'ı (Kimlik bilgisi oluştur) tıklayın. API anahtarı.
    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"

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

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. Örneğin, TextEdit veya Microsoft Windows Notepad varsayılan olarak cihazınızda yüklü olur.
  2. Bir HTML dosyası oluşturun ve dosyayı index.html olarak adlandırın.
  3. Yukarıda oluşturduğunuz iframe'e 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ız üzerine 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 Yerleştirme API'sini kullanarak bir harita oluşturdunuz.

Temizleme

Kullanılan tüm kaynakların faturalandırılmasını durdurmak için Google Cloud projenizi silebilirsiniz sorumluluk duygusunu güçlendirir.

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

    Kaynakları yönetin sayfasına gidin

  2. Silmeyi planladığınız proje bir kuruluşa bağlıysa kuruluş listesi oluşturun.
  3. Proje listesinde, silmek istediğiniz projeyi seçin ve Sil'i tıklayın.
  4. İletişim kutusuna proje kimliğini yazın ve projeyi silmek için Kapat'ı tıklayın.

Sonraki adımlar