Maps Embed API, JavaScript gerektirmeden iframe src URL'si olarak ayarlanmış bir HTTP isteği aracılığıyla web sayfasına etkileşimli bir harita veya Street View panoraması yerleştirir. place, view, directions, streetview ve search harita modlarını destekler.
Maps Embed API: Önemli bilgiler
- Ürün: Maps Embed API
- Diğer adları: Google Haritalar Embed API, Maps Embed
- Kategori: Haritalar
- Platform: JavaScript (tarayıcı)
- Çalıştığı yer: İstemci (uygulama veya tarayıcı kodu)
- Lansman aşaması: GA
- Yaşam döngüsü: Etkin
- Genel bakış: Maps Embed API'ye genel bakış
- Kullanılabildiği bölgeler: Dünya geneli. Street View modu, Street View kapsamına bağlıdır.
regionparametresi, Maps Platform kapsam ayrıntıları sayfasında listelenen bölgeleri kabul eder. (kapsam ayrıntıları)
Maps Embed API: Ne zaman kullanılır?
Maps Embed API'yi şu durumlarda kullanın:
- JavaScript olmadan yalnızca HTML iframe kullanan bir web sayfasında etkileşimli harita veya Street View panoraması oluşturmanız gerekiyorsa.
- Yer raptiyesi, harita görünümü, noktalar arasındaki yol tarifleri veya yerleştirilmiş bir haritadaki alanla ilgili arama sonuçlarını göstermeniz gerekir.
- İstek başına ücret alınmayan ve QPS veya günlük istek sınırı olmayan yerleştirilmiş bir haritaya ihtiyacınız vardır (API anahtarı yine de gereklidir).
Maps Embed API'yi şu durumlarda kullanmayın:
- Bir web haritasını kendi içerikleriniz ve görüntülerinizle özelleştirmeniz gerekir. Bunun yerine Maps JavaScript API'yi kullanın.
- Yerleştirilmiş bir haritayı, iframe URL parametrelerinin ötesinde programatik özelliklerle genişletmeniz gerektiğinde. Bunun yerine Maps JavaScript API'yi kullanın.
Maps Embed API: kurulum
- Etkinleştirilecek hizmet:
maps-embed-backend.googleapis.com - Kimlik doğrulama: API anahtarı
- Başlayın: Maps Embed API'yi ayarlama
- Referans: Maps Embed API referansı
- Fiyatlandırma: Maps Embed API kullanımı ve faturalandırması
Maps Embed API: Sık yapılan hatalar
- Sorun: Ana sayfa, bir
referrermeta etiketinino-referrerveyasame-originolarak ayarlarsa tarayıcıRefererüstbilgisini göndermez ve HTTP yönlendiren kısıtlamalı bir API anahtarı, yerleştirme isteklerini reddedebilir. Düzeltme: Sitenin alan adının Google'a gönderilmesi için iframe'ereferrerpolicy="strict-origin-when-cross-origin"ekleyin. /maps/documentation/embed/embedding-map sayfasına bakın. - Sorun: Yerleştirilmiş haritalar, her iki boyutta da 200 pikselin altında desteklenmez. Düzeltme: iframe
widthveheightdeğerlerini en az 200 piksel olarak ayarlayın. /maps/documentation/embed/embedding-map sayfasına bakın. - Sorun: Kullanım ücretsiz olsa bile faturalandırma etkinleştirilmemişse, ödeme yöntemi geçersizse, kendi belirlediğiniz günlük sınır aşılmışsa veya referans bilgisi kısıtlamalı bir anahtar kullanılırken istekte HTTP referans bilgisi yoksa "yalnızca geliştirme amaçlı" filigranlı, karartılmış bir harita görünür. Düzeltme: Projede geçerli bir ödeme yöntemiyle faturalandırmayı etkinleştirin, kendi belirlediğiniz günlük kota sınırını yükseltin veya kaldırın ve yönlendiren kısıtlamalı anahtarlar için yönlendirenin gönderildiğinden emin olun (ör. iframe'de
referrerpolicy="strict-origin-when-cross-origin"ile). /maps/documentation/embed/error-messages adresini ziyaret edin. - Sorun: Geçersiz istekler (hatalı veya eksik parametreler, eksik ya da geçersiz anahtar gibi API anahtarı ve kota hataları, Maps Embed API'nin etkinleştirilmemesi veya anahtar kısıtlama ihlali) için tarayıcı konsolunda açıklayıcı bir mesaj yerine yalnızca HTTP 4xx durum kodu bildirilir. Hata metni, haritanın yerine iframe içinde görünür. Düzeltme: iFrame'deki hata metnini ve konsol durum kodunu (parametre hataları için 400, eksik anahtar için 401, geçersiz anahtar için 403) okuyun. Ardından parametrelerin ve anahtarın geçerli olduğunu, Maps Embed API'nin etkinleştirildiğini ve anahtar kısıtlamalarının isteğe izin verdiğini doğrulayın. /maps/documentation/embed/error-messages adresini ziyaret edin.
Maps Embed API ile yapabilecekleriniz
Her görev için aşağıda bağlantısı verilen kılavuzlara bakın veya Özellikler Gezgini'nde ürünleri karşılaştırın.