Библиотеки

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

<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>

API JavaScript Карт состоит из библиотек , которые не загружаются до тех пор, пока вы их специально не запросите. Разбиение компонентов на библиотеки позволяет 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

Библиотеки для динамического импорта библиотек

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

Библиотеки для URL-адреса начальной загрузки (устаревшие версии)

Следующие библиотеки поддерживаются для использования с устаревшим тегом сценария начальной загрузки :
  • drawing предоставляет пользователям графический интерфейс для рисования на карте многоугольников, прямоугольников, ломаных линий, кругов и маркеров. Дополнительную информацию см. в документации библиотеки чертежей .
  • geometry включает служебные функции для расчета скалярных геометрических значений (таких как расстояние и площадь) на поверхности земли. Для получения дополнительной информации обратитесь к документации библиотеки Geometry .
  • journeySharing обеспечивает поддержку решений для транспорта и логистики платформы Google Maps.
  • localContext показывает пользователям ключевые достопримечательности рядом с указанным вами местоположением. Для получения дополнительной информации обратитесь к документации библиотеки локального контекста .
  • marker позволяет добавлять на карты настраиваемые и эффективные расширенные маркеры. Дополнительную информацию см. в документации по расширенным маркерам .
  • places позволяют вашему приложению искать такие места, как заведения, географические местоположения или известные достопримечательности, в пределах определенной области. Дополнительную информацию можно найти в документации библиотеки Places .
  • visualization предоставляет тепловые карты для визуального представления данных. Для получения дополнительной информации обратитесь к документации библиотеки визуализации .

Следующий запрос начальной загрузки показывает, как добавить запрос к библиотеке 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>