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 gerekli değildir.

Maliyetler

Tüm Maps Embed API istekleri, sınırsız kullanımla ücretsiz olarak sunulur. Ancak tüm istekler için yine de 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ıza 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. 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 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 ücretsiz deneme süresi sunar. Deneme, hangisinin önce gerçekleştiğine bağlı olarak, 90 günün sonunda veya hesaba 300 ABD doları tutarında maliyet tahakkuk ettikten sonra sona erer. Dilediğiniz zaman iptal edebilirsiniz. Google Haritalar Platformu'nda aylık 200 ABD doları değerinde yinelenen bir kredi bulunur. Daha fazla bilgi için Faturalandırma hesabı kredileri ve Faturalandırma bölümlerine bakın.

Google Cloud SDK

gcloud projects create "PROJECT"

Google Cloud SDK, Google 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

Haritalar Embed API'yi etkinleştirme

Google Cloud SDK

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

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

3. Adım

Bu adım yalnızca API Anahtarı oluşturma sürecinden geçer. API Anahtarınızı üretimde kullanıyorsanız API anahtarınızı kısıtlamanızı kesinlikle öneririz. Ürüne özel API Anahtarlarını Kullanma sayfasında daha fazla bilgi bulabilirsiniz.

API anahtarı, kullanım ve faturalandırma amaçları doğrultusunda 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.
    API anahtarı oluşturuldu iletişim kutusunda yeni oluşturduğunuz API anahtarı görüntülenir.
  3. Kapat'ı tıklayın.
    Yeni API anahtarı, API anahtarları altındaki Kimlik Bilgileri sayfasında listelenir.
    (Üretimde kullanmadan önce API anahtarını kısıtlamayı unutmayın.)

Google Cloud SDK

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

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

iframe oluşturma

Aşağıdaki seçenekleri tıklayın ve web sayfanız için iframe oluşturmak üzere bir konum ve API anahtarı ekleyin. Ek parametreler ve seçenekler için Harita yerleştirme konusuna bakın.

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 dosyaya index.html adını verin.

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

Tebrikler! Maps Embed API'yi kullanarak bir harita oluşturup oluşturmanız yeterlidir.

Temizleme

Google Cloud projenizi silebilirsiniz. Böylece, söz konusu projede kullanılan tüm kaynaklar için faturalandırma yapmayı durdurabilirsiniz.

  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 eklenmişse sayfanın üst kısmındaki kuruluş listesini seçin ve genişletin.
  3. Proje listesinden 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