Bir harita yerleştirme

Bu kılavuzda, etkileşimli bir haritayı web sayfanıza nasıl yerleştireceğiniz 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:

  • Harita modunuz aracılığıyla MAP_MODE.
  • YOUR_API_KEY API anahtarınızla. Daha fazla bilgi için API anahtarı alma bölümüne bakın.
  • Haritanız için gerekli ve isteğe bağlı parametrelerle birlikte PARAMETERS yatırım yapmanız önemlidir.

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ği ek özellikleri kullanır:

  • Belirli harita bölümlerinin tam ekrana geçmesine izin veren allowfullscreen mülkü.
  • Standardı kaldırmak için frameborder="0" ve style="border:0" özellikleri iframe'in kenarlığını değiştirin.
  • Şuna izin verecek referrerpolicy="no-referrer-when-downgrade" özelliği: tam URL'yi istekle birlikte Referer başlığı olarak göndermesini API anahtarı kısıtlamaları düzgün çalışabilir.

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 no-referrer olarak ayarlanmış bir referrer meta etiketi varsa same-origin için tarayıcı Referer üstbilgisini Google'a göndermez. Bu API anahtarı kısıtlamanıza neden olabilir değerini girin. 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.

Haritadaki reklamlar

Maps Embed API, harita üzerinde reklamcılığı içerebilir. Reklam biçimi ve herhangi bir haritada gösterilen reklam kümesi haber verilmeden 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 adresteki harita raptiyesini gösterir. önemli nokta, işletme, coğrafi özellik veya kasaba gibi bir yer gibi.
  • view: İşaretçi veya yol tarifi içermeyen bir harita döndürür.
  • directions: İki veya daha fazlası arasındaki yolu gösterir mesafe ve seyahat süresiyle birlikte haritada belirtilen noktaları gösterir.
  • streetview: şuradan etkileşimli panoramik görüntüleri gösterir: tanımlanmış konumlar.
  • search: Bir aramanın sonuçlarını görünür haritada gösterir bölge.

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. Maps Embed API hem + hem de %20 desteği sağlar emin olun. Ö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 parçaları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ı Kullanıcı adı ve kimlik bilgilerine göre görüntülenecek uygun kenarlıkları ve etiketleri hassasiyetleri gözetiyor. 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 parçaları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ı Kullanıcı adı ve kimlik bilgilerine göre görüntülenecek uygun kenarlıkları ve etiketleri hassasiyetleri gözetiyor. 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. Bkz. Google Haritalar Platformu Desteklenen bölgeler için Kapsam Ayrıntıları'nı tıklayın.

directions modu

Aşağıdaki örnekte, Oslo ile Norveç'in Telemark kenti arasındaki yolu, mesafeyi ve otoyollardan ve ücretli yollardan kaçınarak seyahat 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 tariflerinin görüntüleneceği başlangıç noktasını tanımlar. URL çıkışlı yer adı, adres, artı kodu, enlem/boylam koordinatları veya yer kimliğini girin. Maps Embed API hem + hem de %20 desteği sağlar emin olun. Örneğin, "Belediye Binası, New York, NY"yi dönüştür - City+Hall,New+York,NY veya artı kodları "849VCWC8+R9" - 849VCWC8%2BR9.
destination Zorunlu Yol tariflerinin bitiş noktasını tanımlar. URL çıkışlı yer adı, adres, artı kodu, enlem/boylam koordinatları veya yer kimliğini girin. Haritalar İçe Aktarma API'si, boşluklardan kaçarken hem + hem de %20'ü 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ı Aralarında yol tarifi oluşturulacak bir veya daha fazla ara yeri belirtir kalkış ve varış noktası. 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 yöntemini 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. Aksi halde Kısıtlanmış özellikleri içeren rotaları engellemeyecek; her bir görev için daha elverişli rotalara yönlendirilebilir. tolls, ferries ve/veya highways. Birden çok değeri dikey çizgi karakteriyle ayırın (ör. avoid=tolls|highways) bilgileri gösterilir.
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 parçaları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ı Kullanıcı adı ve kimlik bilgilerine göre görüntülenecek uygun kenarlıkları ve etiketleri hassasiyetleri gözetiyor. 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. Bkz. Google Haritalar Platformu Desteklenen bölgeler için Kapsam Ayrıntıları'nı tıklayı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ı katkıda bulunulan fotoğraf küreleri ve Street View özel koleksiyonları mevcuttur.

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. İlgili içeriği oluşturmak için kullanılan streetview modu, sonucu oluşturan bir görüntüleyici sağlar merkezinde kamera bulunan küre şeklinde bir panorama oluşturun. Kamerayı manipüle edebilirsiniz. kameranın yakınlaştırmayı ve yönünü kontrol edin.

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 yerde ç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 konumunuz farklı bir panoramaya sabitlenebilir.

  • pano, belirli bir panorama kimliğidir. Bir pano ayrıca bir location 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 yönünü saat yönünde derece olarak gösterir geliştiriyor. -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. İlgili içeriği oluşturmak için kullanılan varsayılan 0° perdesi, bu çekim sırasında kameranın konumuna göre resim çekildi. Bu nedenle, 0°'lik bir perde genellikle her zaman değil, yatay. Örneğin, bir tepede çekilen bir resim muhtemelen yatay olmayan bir varsayılan ses tonu gösterir. -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 parçaları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ı Kullanıcı adı ve kimlik bilgilerine göre görüntülenecek uygun kenarlıkları ve etiketleri hassasiyetleri gözetiyor. İki karakterli (sayısal olmayan) olarak belirtilen bölge kodunu kabul eder bilinen ccTLD'ye ("üst düzey alan") unicode bölgesi alt etiketi eşleme iki karakterli değerler sunmalıdır. Bkz. Google Haritalar Platformu Desteklenen bölgeler için Kapsam Ayrıntıları'nı tıklayı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. Coğrafi kısıtlama, in+Seattle veya near+98033 gibi.
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 parçaları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ı Kullanıcı adı ve kimlik bilgilerine göre görüntülenecek uygun kenarlıkları ve etiketleri hassasiyetleri gözetiyor. 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. Bkz. Google Haritalar Platformu Desteklenen bölgeler için Kapsam Ayrıntıları'nı tıklayın.

Yer kimliği parametreleri

Maps Embed API, yer adı veya adres sağlamak yerine yer kimliklerinin kullanılmasını destekler. Yer kimlikleri benzersiz ve kalıcı bir yeri tanımlayabilirsiniz. Daha fazla bilgi için Google Places API dokümanlarına bakın.

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ırlar. Geçerli değerler şunlardır:

    • default, Street View için varsayılan kaynakları kullanır; aramalar kaynaklarla sınırlı değil.
    • outdoor, aramaları açık hava koleksiyonlarıyla sınırlandırır. İç mekan koleksiyonlar arama sonuçlarına dahil edilmez. Dış mekan panoramalarının belirtilen yer için mevcut olmayabilir. Ayrıca yalnızca bu aşamada olan içeride olup olmadıklarının belirlenmesinin mümkün olduğu panoramalar döndürür. üretebiliriz. Örneğin, iç mekan veya dış mekan olup olmadığı bilinmediği için PhotoSphere'ler döndürülmez.