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

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

Maliyetler

Tüm Maps Embed API istekleri ücretsizdir ve sınırsız kullanılabilir. 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ştirilmiş bir harita oluşturmak için aşağıdaki sekmeleri tıklayarak gerekli kurulum adımlarını tamamlayın:

1. Adım

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 gitme

  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, 0,00 ABD doları tutarında bir deneme ücreti sunar. Deneme süresi, 90 günün sonunda veya hesapta 300 ABD doları değerinde ücret biriktikten sonra (hangisi önce gerçekleşirse) sona erer. Dilediğ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ükleme ve aşağıdaki komutlar hakkında daha fazla bilgi edinin:

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"

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 süreci ele alınır. API anahtarınızı üretimde kullanıyorsanız API anahtarınızı kısıtlamanızı kesinlikle öneririz. Daha fazla bilgiyi ürüne özel API Anahtarlarını Kullanma sayfasında 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ş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 gitme

  2. Kimlik bilgileri sayfasında Kimlik bilgileri oluştur > API anahtarı'nı tıklayın.
    API anahtarı oluşturuldu iletişim kutusunda yeni oluşturduğunuz API anahtarı gösterilir.
  3. Kapat'ı tıklayın.
    Yeni API anahtarı, Kimlik bilgileri sayfasındaki API anahtarları bölümünde listelenir.
    (Üretimde kullanmadan önce API anahtarını kısıtlamayı unutmayın.)

Google Cloud SDK

gcloud 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

Aşağıdaki seçenekleri tıklayarak web sayfanız için bir iframe oluşturmak üzere konum ve API anahtarı ekleyin. Ek 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şturun ve index.html olarak adlandırın.

  3. Aşağıdaki kodu, yukarıda oluşturduğunuz iframe ile birlikte 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ına yükleyin. Alternatif olarak, dosyayı çift tıklamak çoğu işletim sisteminde işe yarar.

Tebrikler! Maps Embed API'yi kullanarak bir harita oluşturdunuz.

Temizleme

Bu proje kapsamında kullanılan tüm kaynaklar için faturalandırmayı durdurmak üzere Google Cloud projenizi silebilirsiniz.

  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 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. İletişim kutusunda proje kimliğini yazın ve projeyi silmek için Kapat'ı tıklayın.

Sonraki adımlar