Библиотеки

Чтобы загрузить код JavaScript для API JavaScript Карт, включите на свою страницу скрипт начальной загрузки следующего вида:

<script>   (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({     key: "YOUR_API_KEY",     v: "weekly",     // Use the 'v' parameter to indicate the version to use (weekly, beta, alpha, etc.).     // Add other bootstrap parameters as needed, using camel case.   }); </script>

Maps JavaScript API состоит из библиотек , которые не загружаются, пока вы их специально не запросите. Разбиение компонентов на библиотеки позволяет API быстро загружать (и анализировать). Вы несете дополнительные накладные расходы на загрузку и анализ библиотек только по мере необходимости.

Загрузите дополнительные библиотеки во время выполнения, используя оператор await для вызова importLibrary() из async функции. Например:

const { Map } = await google.maps.importLibrary("maps");

В следующем примере кода показана загрузка библиотек Map и AdvancedMarkerElement :

Машинопись 

// Initialize and add the map let map; async function initMap(): Promise<void> {   // The location of Uluru   const position = { lat: -25.344, lng: 131.031 };    // Request needed libraries.   //@ts-ignore   const { Map } = await google.maps.importLibrary("maps") as google.maps.MapsLibrary;   const { AdvancedMarkerElement } = await google.maps.importLibrary("marker") as google.maps.MarkerLibrary;    // The map, centered at Uluru   map = new Map(     document.getElementById('map') as HTMLElement,     {       zoom: 4,       center: position,       mapId: 'DEMO_MAP_ID',     }   );    // The marker, positioned at Uluru   const marker = new AdvancedMarkerElement({     map: map,     position: position,     title: 'Uluru'   }); }  initMap();
index.ts

JavaScript 

// Initialize and add the map let map;  async function initMap() {   // The location of Uluru   const position = { lat: -25.344, lng: 131.031 };   // Request needed libraries.   //@ts-ignore   const { Map } = await google.maps.importLibrary("maps");   const { AdvancedMarkerElement } = await google.maps.importLibrary("marker");    // The map, centered at Uluru   map = new Map(document.getElementById("map"), {     zoom: 4,     center: position,     mapId: "DEMO_MAP_ID",   });    // The marker, positioned at Uluru   const marker = new AdvancedMarkerElement({     map: map,     position: position,     title: "Uluru",   }); }  initMap();
index.js

Доступные библиотеки

Следующие библиотеки доступны для использования с динамическим импортом библиотек и тегом прямой загрузки скрипта :

Следующий запрос начальной загрузки иллюстрирует, как добавить запрос для библиотеки google.maps.geometry API JavaScript Карт в тег прямой загрузки скрипта:

<script async     src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&libraries=geometry&callback=initMap"> </script>

Чтобы запросить несколько библиотек, разделите их запятой:

<script async     src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&libraries=geometry,places&callback=initMap"> </script>