Bir harita yerleştirme

Bu kılavuzda, web sayfanıza etkileşimli harita ekleme işlemi gösterilmektedir.

Maps Embed API URL'sini oluşturma

Aşağıda, Maps Embed API'yi yükleyen örnek bir URL verilmiştir:

https://www.google.com/maps/embed/v1/MAP_MODE?key=YOUR_API_KEY&PARAMETERS

Değiştir:

  • MAP_MODE harita modunuzu değiştirebilirsiniz.
  • YOUR_API_KEY API anahtarınızla. Daha fazla bilgi için API anahtarı alma başlıklı makaleyi inceleyin.
  • PARAMETERS ile harita modunuz için gerekli ve isteğe bağlı parametreleri gönderin.

URL'yi bir iframe'e ekleme

Haritalar İçe Aktarma API'sini web sayfanızda kullanmak için oluşturduğunuz URL'yi bir iframe'in src özelliğinin değeri olarak ayarlayın. Haritanın boyutunu, iframe'ın height ve width özellikleriyle kontrol edebilirsiniz. Örneğin:

<iframe
  width="450"
  height="250"
  frameborder="0" style="border:0"
  referrerpolicy="no-referrer-when-downgrade"
  src="https://www.google.com/maps/embed/v1/MAP_MODE?key=YOUR_API_KEY&PARAMETERS"
  allowfullscreen>
</iframe>

Yukarıdaki iframe örneğinde aşağıdaki ek özellikler kullanılır:

  • Belirli harita bölümlerinin tam ekrana geçmesine izin veren allowfullscreen mülkü.
  • Haritanın etrafındaki standart iFrame kenarlığını kaldırmak için frameborder="0" ve style="border:0" özellikleri.
  • API anahtarı kısıtlamalarının düzgün şekilde çalışabilmesi için tarayıcının URL'nin tamamını istekle birlikte Referer üstbilgisi olarak göndermesine izin veren referrerpolicy="no-referrer-when-downgrade" mülkü.

IFrame'i kendi web sitenizin yapısına ve tasarımına uyacak şekilde yeniden boyutlandırabilirsiniz ancak ziyaretçilerin genellikle daha büyük haritalarla etkileşim kurmayı daha kolay bulduğunu tespit ettik. Yerleştirilen haritaların, her iki boyutta da 200 piksel boyutunun altında desteklenmediğini unutmayın.

API anahtarı kısıtlamaları

Barındırma web sitesinde referrer meta etiketi no-referrer veya same-origin olarak ayarlanmışsa tarayıcı Referer başlığını Google'a göndermez. Bu durum, API anahtarı kısıtlamanızın istekleri reddetmesine neden olabilir. Kısıtlamanın düzgün çalışması için, Referer üstbilgilerinin Google'a gönderilmesine açıkça izin vermek üzere yukarıdaki örnekte gösterildiği gibi iframe'e bir referrerpolicy mülkü ekleyin.

Haritada reklamlar

Maps Embed API, harita üzerinde reklamcılık içerebilir. Belirli bir haritada gösterilen reklam biçimi ve reklam grubu, bildirimde bulunulmaksızın değiştirilebilir.

Harita modlarını seçme

İstek URL'nizde kullanmak üzere aşağıdaki harita modlarından birini belirtebilirsiniz:

  • place: Belirli bir yer veya adreste (ör. önemli bir yer, işletme, coğrafi özellik ya da kasaba) bir harita raptiyesi gösterir.
  • view: İşaretçi veya yol tarifi içermeyen bir harita döndürür.
  • directions: Haritada belirtilen iki veya daha fazla nokta arasındaki yolu, mesafeyi ve seyahat süresini gösterir.
  • streetview: Belirtilen konumlardan alınan etkileşimli panoramik görüntüleri gösterir.
  • search: Görünür harita bölgesinde yapılan bir aramanın sonuçlarını gösterir.

place modu

Aşağıdaki URL'de, Eyfel Kulesi'nde bir harita işaretçisi görüntülemek için place harita modu kullanılmaktadır:

https://www.google.com/maps/embed/v1/place
  ?key=YOUR_API_KEY
  &q=Eiffel+Tower,Paris+France

Aşağıdaki parametreleri kullanabilirsiniz:

Parametre Tür Açıklama Kabul edilen değerler
q Zorunlu Harita işaretçisinin konumunu tanımlar. URL'den kaçan yer adı, adres, plus kodu veya yer kimliği. Haritalar İçe Aktarma API'si, boşluklardan kaçarken hem + hem de %20'yi destekler. Örneğin, "City Hall, New York, NY"yi City+Hall,New+York,NY veya "849VCWC8+R9" kodlarını 849VCWC8%2BR9 olarak dönüştürün.
center İsteğe bağlı Harita görünümünün merkezini tanımlar. Virgülle ayrılmış enlem ve boylam değerini kabul eder. Örneğin: 37.4218,-122.0840.
zoom İsteğe bağlı Haritanın ilk yakınlaştırma düzeyini ayarlar. Değerler 0 (tüm dünya) ile 21 (tek binalar) aralığındadır. Üst sınır, seçilen konumda bulunan harita verilerine bağlı olarak değişebilir.
maptype İsteğe bağlı Yüklenecek harita karolarının türünü tanımlar. roadmap (varsayılan) veya satellite
language İsteğe bağlı Kullanıcı arayüzü öğeleri ve harita karolarındaki etiketlerin görüntülenmesi için kullanılacak dili tanımlar. Ziyaretçiler varsayılan olarak kendi dillerinde bir harita görür. Bu parametre yalnızca bazı ülke karoları için desteklenir; istenen belirli dil karo seti için desteklenmiyorsa söz konusu karo setinin varsayılan dili kullanılır.
region İsteğe bağlı Coğrafi-politik hassasiyetlere göre görüntülenecek uygun sınırları ve etiketleri tanımlar. Bilinen ccTLD ("üst düzey alan") iki karakterli değerleriyle eşleşen iki karakterli (sayısal olmayan) unicode bölge alt etiketi olarak belirtilen bir bölge kodunu kabul eder. Desteklenen bölgeler için Google Haritalar Platformu Kapsam Ayrıntıları'na bakın.

view modu

Aşağıdaki örnekte, haritanın uydu görünümünü görüntülemek için view modu ve isteğe bağlı maptype parametresi kullanılmaktadır:

https://www.google.com/maps/embed/v1/view
  ?key=YOUR_API_KEY
  &center=-33.8569,151.2152
  &zoom=18
  &maptype=satellite

Aşağıdaki parametreleri kullanabilirsiniz:

Parametre Tür Açıklama Kabul edilen değerler
center Zorunlu Harita görünümünün merkezini tanımlar. Virgülle ayrılmış enlem ve boylam değerini kabul eder. Örneğin: 37.4218,-122.0840.
zoom İsteğe bağlı Haritanın ilk yakınlaştırma düzeyini ayarlar. Değerler 0 (tüm dünya) ile 21 (tek binalar) aralığındadır. Üst sınır, seçilen konumda bulunan harita verilerine bağlı olarak değişebilir.
maptype İsteğe bağlı Yüklenecek harita karolarının türünü tanımlar. roadmap (varsayılan) veya satellite
language İsteğe bağlı Kullanıcı arayüzü öğeleri ve harita karolarındaki etiketlerin görüntülenmesi için kullanılacak dili tanımlar. Ziyaretçiler varsayılan olarak kendi dillerinde bir harita görür. Bu parametre yalnızca bazı ülke karoları için desteklenir; istenen belirli dil karo seti için desteklenmiyorsa söz konusu karo setinin varsayılan dili kullanılır.
region İsteğe bağlı Coğrafi-politik hassasiyetlere göre görüntülenecek uygun sınırları ve etiketleri tanımlar. Bilinen ccTLD ("üst düzey alan") iki karakterli değerleriyle eşleşen iki karakterli (sayısal olmayan) unicode bölge alt etiketi olarak belirtilen bir bölge kodunu kabul eder. Desteklenen bölgeler için Google Haritalar Platformu Kapsam Ayrıntıları'na bakın.

directions modu

Aşağıdaki örnekte, Oslo ile Norveç'in Telemark kenti arasındaki yolu, mesafeyi ve otoyollardan ve ücretli yollardan kaçınarak yolculuk süresini göstermek için directions modu kullanılmaktadır.

https://www.google.com/maps/embed/v1/directions
  ?key=YOUR_API_KEY
  &origin=Oslo+Norway
  &destination=Telemark+Norway
  &avoid=tolls|highways

Aşağıdaki parametreleri kullanabilirsiniz:

Parametre Tür Açıklama Kabul edilen değerler
origin Zorunlu Yol tarifinin gösterileceği başlangıç noktasını tanımlar. URL'den kaçan yer adı, adres, Plus Code, enlem/boylam koordinatları veya yer kimliği. Haritalar İçe Aktarma API'si, boşluklardan kaçarken hem + hem de %20'yi destekler. Örneğin, "City Hall, New York, NY"yi City+Hall,New+York,NY veya "849VCWC8+R9" kodlarını 849VCWC8%2BR9 olarak dönüştürün.
destination Zorunlu Yol tarifinin bitiş noktasını tanımlar. URL'den kaçan yer adı, adres, Plus Code, enlem/boylam koordinatları veya yer kimliği. Haritalar İçe Aktarma API'si, boşluklardan kaçarken hem + hem de %20'yi destekler. Örneğin, "City Hall, New York, NY"yi City+Hall,New+York,NY veya "849VCWC8+R9" kodlarını 849VCWC8%2BR9 olarak dönüştürün.
waypoints İsteğe bağlı Kalkış ve varış noktası arasında yol tarifi için bir veya daha fazla ara konum belirtir. Yer adı, adresi veya yer kimliği. Yerleri ayırmak için dikey çizgi karakteri (|) kullanılarak birden fazla yol noktası belirtilebilir (ör. Berlin,Germany|Paris,France). 20'ye kadar yol noktası belirtebilirsiniz.
mode İsteğe bağlı Seyahat şeklini tanımlar. Hiçbir mod belirtilmezse Haritalar Embed API, belirtilen rotayla en alakalı modlardan birini veya daha fazlasını gösterir. driving, walking (mevcut olduğunda yaya yollarını ve kaldırımları tercih eder), bicycling (mevcut olduğunda bisiklet yolları ve tercih edilen sokaklardan rota oluşturur), transit veya flying.
avoid İsteğe bağlı Yol tarifinde kaçınılması gereken özellikleri belirtir. Bunun, kısıtlanmış özellikleri içeren rotaları engellemediğini, sonucu daha uygun rotalara yönlendirdiğini unutmayın. tolls, ferries ve/veya highways. Birden çok değeri dikey çizgi karakteriyle ayırın (ör. avoid=tolls|highways).
units İsteğe bağlı Sonuçlarda mesafeleri gösterirken ölçüm yöntemini (metrik veya İngiliz) belirtir. units belirtilmezse kullanılacak birimler, sorgunun origin ülkesine göre belirlenir. metric veya imperial
center İsteğe bağlı Harita görünümünün merkezini tanımlar. Virgülle ayrılmış enlem ve boylam değerini kabul eder. Örneğin: 37.4218,-122.0840.
zoom İsteğe bağlı Haritanın ilk yakınlaştırma düzeyini ayarlar. Değerler 0 (tüm dünya) ile 21 (tek binalar) aralığındadır. Üst sınır, seçilen konumda bulunan harita verilerine bağlı olarak değişebilir.
maptype İsteğe bağlı Yüklenecek harita karolarının türünü tanımlar. roadmap (varsayılan) veya satellite
language İsteğe bağlı Kullanıcı arayüzü öğeleri ve harita karolarındaki etiketlerin görüntülenmesi için kullanılacak dili tanımlar. Ziyaretçiler varsayılan olarak kendi dillerinde bir harita görür. Bu parametre yalnızca bazı ülke karoları için desteklenir; istenen belirli dil karo seti için desteklenmiyorsa söz konusu karo setinin varsayılan dili kullanılır.
region İsteğe bağlı Coğrafi-politik hassasiyetlere göre görüntülenecek uygun sınırları ve etiketleri tanımlar. Bilinen ccTLD ("üst düzey alan") iki karakterli değerleriyle eşleşen iki karakterli (sayısal olmayan) unicode bölge alt etiketi olarak belirtilen bir bölge kodunu kabul eder. Desteklenen bölgeler için Google Haritalar Platformu Kapsam Ayrıntıları'na bakın.

streetview modu

Haritalar Yerleştirme API'si, Street View görüntülerini kapsam alanındaki belirli konumlardan alınan etkileşimli panoramalar olarak görüntülemenize olanak tanır. Kullanıcıların katkıda bulunduğu Photosphere'ler ve Street View özel koleksiyonları da kullanılabilir.

Her Street View panoraması, tek bir konumdan 360 derecelik tam bir görünüm sunar. Resimler 360 derece yatay görünüm (tam çevreleme) ve 180 derece dikey görünüm (doğrudan yukarıdan doğrudan aşağıya) içerir. streetview modu, ortaya çıkan panoramayı ortasında kamera bulunan bir küre olarak gösteren bir görüntüleyici sağlar. Yakınlaştırmayı ve kameranın yönünü kontrol etmek için kamerayı hareket ettirebilirsiniz.

Aşağıdaki streetview modu panoramasına bakın:

https://www.google.com/maps/embed/v1/streetview
  ?key=YOUR_API_KEY
  &location=46.414382,10.013988
  &heading=210
  &pitch=10
  &fov=35

Aşağıdaki URL parametrelerinden biri zorunludur:

  • location, enlem ve boylamı virgül ile ayrılmış değerler (46.414382,10.013988) olarak kabul eder. API, bu konuma en yakın konumda fotoğrafı çekilen panoramayı gösterir. Street View görüntüleri düzenli olarak yenilendiğinden ve fotoğraflar her seferinde biraz farklı konumlardan çekilebileceğinden, görüntüler güncellendiğinde konumunuzun farklı bir panoramaya sabitlenmesi mümkündür.

  • pano, belirli bir panorama kimliğidir. Bir pano belirtirseniz location da belirtebilirsiniz. location yalnızca API panorama kimliğini bulamıyorsa kullanılır.

Aşağıdaki URL parametreleri isteğe bağlıdır:

Parametre Tür Açıklama Kabul edilen değerler
heading İsteğe bağlı Kameranın pusula istikametini kuzeyden itibaren saat yönünde derece cinsinden belirtir. -180° ile 360° arasında derece cinsinden değer
pitch İsteğe bağlı kameranın yukarı veya aşağı açısını belirtir. Pozitif değerler kamera açısını yukarı, negatif değerler de kamera açısını aşağı doğru döndürür. 0° olan varsayılan eğim, görüntü çekilirken kameranın konumuna göre ayarlanır. Bu nedenle, 0° eğim genellikle yataydır ancak her zaman yatay değildir. Örneğin, bir tepede çekilen bir resimde yatay olmayan bir varsayılan eğim görülebilir. -90° ile 90° arasında derece cinsinden değer
fov İsteğe bağlı resmin yatay görüş alanını belirler. Varsayılan olarak 90°'tır. Sabit boyutlu bir görüntü alanıyla çalışırken, daha küçük sayılar daha yüksek bir yakınlaştırma düzeyini belirtecek şekilde yakınlaştırma düzeyi olarak görüntü alanı düşünülebilir. 10° - 100° aralığında derece cinsinden değer
center İsteğe bağlı Harita görünümünün merkezini tanımlar. Virgülle ayrılmış enlem ve boylam değerini kabul eder. Örneğin: 37.4218,-122.0840.
zoom İsteğe bağlı Haritanın ilk yakınlaştırma düzeyini ayarlar. Değerler 0 (tüm dünya) ile 21 (tek binalar) aralığındadır. Üst sınır, seçilen konumda bulunan harita verilerine bağlı olarak değişebilir.
maptype İsteğe bağlı Yüklenecek harita karolarının türünü tanımlar. roadmap (varsayılan) veya satellite
language İsteğe bağlı Kullanıcı arayüzü öğeleri ve harita karolarındaki etiketlerin görüntülenmesi için kullanılacak dili tanımlar. Ziyaretçiler varsayılan olarak kendi dillerinde bir harita görür. Bu parametre yalnızca bazı ülke karoları için desteklenir; istenen belirli dil karo seti için desteklenmiyorsa söz konusu karo setinin varsayılan dili kullanılır.
region İsteğe bağlı Coğrafi-politik hassasiyetlere göre görüntülenecek uygun sınırları ve etiketleri tanımlar. Bilinen ccTLD ("üst düzey alan") iki karakterli değerleriyle eşleşen iki karakterli (sayısal olmayan) unicode bölge alt etiketi olarak belirtilen bir bölge kodunu kabul eder. Desteklenen bölgeler için Google Haritalar Platformu Kapsam Ayrıntıları'na bakın.

search modu

Search modu, görünür harita bölgesindeki bir aramanın sonuçlarını gösterir. Arama terimine bir konum (record+stores+in+Seattle) ekleyerek veya aramayı sınırlamak için bir center ve zoom parametresi ekleyerek arama için bir konum tanımlanması önerilir.

https://www.google.com/maps/embed/v1/search
  ?key=YOUR_API_KEY
  &q=record+stores+in+Seattle

Aşağıdaki parametreleri kullanabilirsiniz:

Parametre Tür Açıklama Kabul edilen değerler
q Zorunlu Arama terimini tanımlar. in+Seattle veya near+98033 gibi coğrafi kısıtlamalar içerebilir.
center İsteğe bağlı Harita görünümünün merkezini tanımlar. Virgülle ayrılmış enlem ve boylam değerini kabul eder. Örneğin: 37.4218,-122.0840.
zoom İsteğe bağlı Haritanın ilk yakınlaştırma düzeyini ayarlar. Değerler 0 (tüm dünya) ile 21 (tek binalar) aralığındadır. Üst sınır, seçilen konumda bulunan harita verilerine bağlı olarak değişebilir.
maptype İsteğe bağlı Yüklenecek harita karolarının türünü tanımlar. roadmap (varsayılan) veya satellite
language İsteğe bağlı Kullanıcı arayüzü öğeleri ve harita karolarındaki etiketlerin görüntülenmesi için kullanılacak dili tanımlar. Ziyaretçiler varsayılan olarak kendi dillerinde bir harita görür. Bu parametre yalnızca bazı ülke karoları için desteklenir; istenen belirli dil karo seti için desteklenmiyorsa söz konusu karo setinin varsayılan dili kullanılır.
region İsteğe bağlı Coğrafi-politik hassasiyetlere göre görüntülenecek uygun sınırları ve etiketleri tanımlar. Bilinen ccTLD ("üst düzey alan") iki karakterli değerleriyle eşleşen iki karakterli (sayısal olmayan) unicode bölge alt etiketi olarak belirtilen bir bölge kodunu kabul eder. Desteklenen bölgeler için Google Haritalar Platformu Kapsam Ayrıntıları'na bakın.

Yer kimliği parametreleri

Maps Embed API, yer adı veya adres sağlamak yerine yer kimliklerinin kullanılmasını destekler. Yer kimlikleri, bir yeri benzersiz şekilde tanımlamanın sabit bir yoludur. Daha fazla bilgi için Google Places API belgelerini inceleyin.

Haritalar İçe Aktarma API'si, aşağıdaki URL parametreleri için yer kimliklerini kabul eder:

  • q
  • origin
  • destination
  • waypoints

Yer kimliğini kullanmak için önce place_id: ön ekini eklemeniz gerekir. Aşağıdaki kodda, yol tarifi isteğinin başlangıç noktası olarak New York Belediye Sarayı belirtilmiştir: origin=place_id:ChIJs--MqP1YwokRBwAhjXWIHn8.

  • radius, belirli bir enlem ve boylama odaklı bir panorama aramak için metre cinsinden belirtilen bir yarıçapı ayarlar. Geçerli değerler sıfırdan büyük tam sayılardır. Varsayılan değer 50'dir.

  • source, Street View aramalarını seçili kaynaklarla sınırlandırır. Geçerli değerler şunlardır:

    • default, Street View için varsayılan kaynakları kullanır; aramalar belirli kaynaklarla sınırlı değildir.
    • outdoor, aramaları açık hava koleksiyonlarıyla sınırlandırır. Kapalı koleksiyonlar arama sonuçlarına dahil edilmez. Belirtilen konum için açık hava panoramalarının bulunmayabileceğini unutmayın. Ayrıca, aramanın yalnızca iç mekan veya dış mekan olup olmadığının belirlenebildiği panoramaları döndürdüğünü unutmayın. Örneğin, iç mekan veya dış mekan olup olmadığı bilinmediği için PhotoSphere'ler döndürülmez.