Maps JavaScript API hızlı referansı

Maps JavaScript API; web sayfalarında 2D ve 3D haritalar oluşturmak, işaretçiler, özel grafikler, animasyonlar ve etkileşimli veri katmanları eklemek ve Places kitaplığıyla konum özellikleri oluşturmak için kullanılan istemci tarafı bir web API'sidir.

Maps JavaScript API: Önemli bilgiler

  • Ürün: Maps JavaScript API
  • Diğer adları: Maps JS API, Maps JS API v3
  • 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 JavaScript API'ye genel bakış
  • Kullanılabildiği bölgeler: Dünya geneli. Özellik kapsamı (ör. 3D haritalar, trafik, yol tarifleri ve sınır stili) ülkeye veya bölgeye göre değişiklik gösterir. Avrupa Ekonomik Alanı fatura adresleri için AEA Hizmet Şartları geçerlidir. (kapsam ayrıntıları)

Maps JavaScript API: Ne zaman kullanılır?

Maps JavaScript API'yi şu durumlarda kullanın:

  • Bir web sayfasında özel işaretçiler, grafikler veya veri katmanları içeren etkileşimli bir 2D ya da 3D haritaya ihtiyacınız var.
  • Gelişmiş İşaretçiler ve çoklu çizgileri kullanarak kendi veri akışınızdan canlı öğe konumlarını ve seyahat yollarını göstermeniz gerekir.
  • Tarayıcıda coğrafi sınırlar (daireler, çokgenler) çizmeniz ve koordinatların bu sınırların içine girip girmediğini test etmeniz gerekir.
  • Places kitaplığı aracılığıyla bir web uygulamasında istemci tarafı yer arama, otomatik tamamlama veya yer ayrıntıları özelliğine ihtiyacınız varsa.

Maps JavaScript API'yi şu durumlarda kullanmayın:

  • Özel JavaScript yazmadan bir işletme konumu haritası veya yol tarifi bağlantısı yerleştirmeniz gerekiyor. Bunun yerine Maps Embed API'yi kullanın.
  • Yalnızca Google Haritalar'ı bir konum, arama veya yol tarifiyle açan bir bağlantıya ihtiyacınız vardır. Bunun yerine Haritalar URL'lerini kullanın.
  • Mobil Driver SDK'sı ve arka uç JWT kimlik doğrulaması ile entegre edilmiş araç paylaşımı veya planlı teslimat filosu takibi gerekir. Bunun yerine Fleet Engine hizmetini kullanın.

Maps JavaScript API: kurulum

Resmi Maps JavaScript API paketleri:

  • npm: @googlemaps/js-api-loader
  • npm: @types/google.maps
  • npm: @googlemaps/markerclusterer

Maps JavaScript API: Sık yapılan hatalar

  • Sorun: API anahtarı veya faturalandırma yanlış yapılandırıldığında hata yerine, "yalnızca geliştirme amaçlı" filigranı bulunan karartılmış bir harita veya negatif Street View görüntüsü gösterilir. Düzeltme: Cloud projesinde faturalandırmayı etkinleştirin, her isteğe geçerli bir API anahtarı ekleyin ve tarayıcı konsolunda belirli hata kodunu kontrol edin. /maps/documentation/javascript/error-messages adresini ziyaret edin.
  • Sorun: PlacesService, DirectionsService ve DistanceMatrixService gibi eski hizmetler, eski API'nin etkinleştirilmediği yeni projelerde LegacyApiNotActivatedMapError hatası verir. Düzeltme: Places API (Yeni) ve Routes API tarafından desteklenen yeni eşdeğerleri (Place sınıfı, Route sınıfı, RouteMatrix sınıfı) kullanın. /maps/legacy#LegacyApiNotActivatedMapError sayfasına bakın.
  • Sorun: Sürüm 3.65 itibarıyla uydu ve karma haritalar artık 45° görüntülere geçmiyor ve map.setTilt(45) parametresinin bir etkisi olmuyor. Düzeltme: 45° görüntüler yerine 3D haritalar kullanın. /maps/deprecations sayfasına bakın.
  • Sorun: Gelişmiş işaretçiler için harita kimliği gerekir. Harita kimliği olmadan oluşturulan haritalarda AdvancedMarkerElement kullanılamaz. Düzeltme: Cloud Console'da bir harita kimliği oluşturun (veya test için DEMO_MAP_ID kullanın) ve haritada mapId değerini ayarlayın. /maps/documentation/javascript/advanced-markers/start adresini inceleyin.

Maps JavaScript API: Eski ve desteği sonlandırılmış özellikler

  • Directions Service (google.maps.DirectionsService): 01.03.2025 tarihinden itibaren eski. Değişim: Route sınıfı. Belirti: Eski Directions API'nin etkinleştirilmediği projelerde LegacyApiNotActivatedMapError. Geçiş rehberini inceleyin.
  • Distance Matrix Service (google.maps.DistanceMatrixService): 01.03.2025'ten itibaren eski. Değişim: RouteMatrix sınıfı. Belirti: Eski Distance Matrix API'nin etkinleştirilmediği projelerde LegacyApiNotActivatedMapError. Geçiş rehberini inceleyin.
  • Places Service (google.maps.places.PlacesService): 01.03.2025 tarihinden itibaren eski. Değişiklik: Place sınıfı (Places API (Yeni)). Belirti: Eski Places API'nin etkinleştirilmediği projelerde LegacyApiNotActivatedMapError. Geçiş rehberini inceleyin.
  • google.maps.Marker: 22.02.2024'ten itibaren desteği sonlandırıldı. Değiştirme: google.maps.marker.AdvancedMarkerElement. Belirti: Çalışmaya devam eder ve kullanımdan kaldırılması planlanmamıştır. Mevcut hatalar düzeltilmez. Geçiş rehberini inceleyin.
  • KmlLayer: 30 Nisan 2026'dan itibaren desteği sonlandırıldı. Alternatif: Veri kümeleri için veri odaklı stil veya veri katmanıyla üçüncü taraf KML ayrıştırıcıları. Belirti: KmlLayer, 3.66 ve sonraki sürümlerde kullanılamaz. Bu özelliği destekleyen son sürüm olan 3.65 sürümü, Mayıs 2027'de kullanımdan kaldırılacak. Geçiş rehberini inceleyin.
  • Isı Haritası Katmanı (Görselleştirme Kitaplığı): 20 Mayıs 2026'dan itibaren kullanımdan kaldırılacak. Alternatif: deck.gl HeatmapLayer gibi üçüncü taraf kitaplıkları. Belirti: Mayıs 2026'dan itibaren kullanılamayacak. Geçiş rehberini inceleyin.
  • Çizim Kitaplığı: 04.06.2026 tarihinden itibaren kullanımdan kaldırıldı. Alternatif: Terra Draw. Belirti: Mayıs 2026'dan itibaren kullanılamayacak. Geçiş rehberini inceleyin.
  • 45° Görüntüler: 20.05.2026 tarihinden itibaren kullanımdan kaldırılmıştır. Değişiklik: 3D haritalar. Belirti: map.setTilt(45) etkisiz; uydu görünümü yukarıdan aşağıya kalıyor. Geçiş rehberini inceleyin.
  • google.maps.event.addDomListener() ve addDomListenerOnce(): 07.04.2022'den itibaren kullanımdan kaldırılmıştır. Değişiklik: Standart DOM addEventListener().
  • Yer Adı Otomatik Tamamlama hizmetindeki bounds, location ve radius seçenekleri: 18 Mayıs 2023'ten itibaren desteği sonlandırıldı. Değiştirme: locationBias ve locationRestriction.
  • Places UI Kit'te gmp-place-content-config (PlaceContentConfigElement): Desteği sonlandırıldı. Değişiklik: İçerik öğelerini doğrudan Yer Ayrıntıları öğelerine veya Yer Arama yapılandırmasına ekleyin.
  • Local Context Library: Kullanımdan kaldırıldı. Değişiklik: Places Library.

Maps JavaScript 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.

Maps JavaScript API: Adres doğrulama

Maps JavaScript API: Sınırlar için veri odaklı stil

Maps JavaScript API: Veri kümeleri için veri odaklı stil

Maps JavaScript API: Veri Kümeleri

  • Haritaya KML katmanı ekleme Not: Maps JavaScript API'de KmlLayer desteği sonlandırılmıştır (en son 3.65 sürümünde desteklenmiştir, Mayıs 2027'de kullanımdan kaldırılacaktır). Sınırlar veya veri kümeleri için veri odaklı stile geçin ya da veri katmanına GeoJSON yükleyin. KML katmanları, Haritalar SDK'sı Yardımcı Program Kitaplıkları aracılığıyla Android ve iOS'te desteklenmeye devam eder.
  • Haritaya GeoRSS katmanı ekleme Not: Maps JavaScript API'de desteği sonlandırılmıştır (KmlLayer en son v3.65'te desteklenir, Mayıs 2027'de kullanımdan kaldırılır). GeoRSS feed'lerini GeoJSON'a dönüştürün ve map.data.addGeoJson() ile veri katmanına yükleyin.
  • Haritaya GeoJSON verileri ekleme

Maps JavaScript API: Yol Tarifi ve Rota Oluşturma

Maps JavaScript API: Rakım

Maps JavaScript API: Fleet Engine

Maps JavaScript API: Coğrafi Kodlama

Maps JavaScript API: Haritalar

Maps JavaScript API: Harita ek açıklamaları

Maps JavaScript API: Harita stillendirme

Maps JavaScript API: Diğer

Maps JavaScript API: Fotoğraf Gerçekliğinde 3D Haritalar

Maps JavaScript API: Places

Maps JavaScript API: Places UI Kit

Maps JavaScript API: Street View