Dynamic Library Import API

Dynamic Library Import API – это новый способ загрузки Maps JavaScript API и всех связанных с ним библиотек. Используя динамическую загрузку библиотек во время выполнения, вы можете не беспокоиться о межкомпонентных зависимостях. Кроме того, она поддерживает объекты Promise и избавляет вас от необходимости указывать длинные пространства имен при работе с Maps JavaScript API (но вы по-прежнему можете их использовать).

Как начать работу с Dynamic Library Import API

Чтобы начать работу с Dynamic Library Import API, добавьте в HTML-код страницы тег скрипта для встроенной программы начальной загрузки и исполняемый код для вызова importLibrary(). Вы можете использовать простой загрузчик скриптов. В этом случае код приложения должен запускать importLibrary только после обратного вызова. Скопируйте приведенный ниже код, а затем добавьте в него свой ключ 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_HERE",
  v: "beta",
  // Add other bootstrap parameters as needed, using camel case.
});
</script>

Чтобы загружать библиотеки во время выполнения, используйте оператор await для вызова importLibrary() внутри асинхронной функции, как показано ниже.

let map;

async function initMap() {
    // Create the map.
    const { Map, InfoWindow } = await google.maps.importLibrary("maps");
    map = new Map(document.getElementById("map"),{
        center: { lat: 37.4239163, lng: -122.0947209 },
        zoom: 14,
        mapId: 'DEMO_MAP_ID',
    });

    // Add an info window.
    const infoWindow = new InfoWindow({
        ariaLabel: "Googleplex",
    });

    // Add a marker.
    const {AdvancedMarkerView} = await google.maps.importLibrary("marker");
    const markerView = new AdvancedMarkerView({
        map,
        position: { lat: 37.4239163, lng: -122.0947209 },
        title: 'Googleplex, Mountain View CA'
    });

    markerView.addListener('click', () => {
        infoWindow.close();
        infoWindow.setContent('<b>Googleplex</b>, Mountain View CA');
        infoWindow.open(markerView.map, markerView);
    });
}

initMap();

Обязательные параметры

  • key – ваш ключ API. Maps JavaScript API не будет загружаться, если не указать действительный ключ.

  • v: "beta" – для предварительного просмотра необходимо указать бета-канал.

Дополнительные параметры

  • libraries – дополнительные библиотеки Maps JavaScript API, которые нужно загрузить (список, разделенный запятыми). В большинстве случаев не рекомендуется использовать фиксированный набор библиотек, но с его помощью можно точно настроить кеширование на сайте. Однако учтите, что если будет требоваться библиотека, которая не указана, то время загрузки может увеличиться.

  • language – язык, который нужно использовать. Определяет отображение элементов интерфейса и управления картой, уведомлений об авторских правах, маршрутов и ответов на запросы к сервису. Список поддерживаемых языков приводится в разделе часто задаваемых вопросов.

  • region – код региона. От него зависит, как будет выглядеть карта той или иной страны или территории.

  • solutionChannel – используется для отслеживания работы с образцами кода, которые мы публикуем, чтобы помочь разработчикам освоиться с API. Параметр запроса solution_channel включается в вызовы API, выполняемые из образцов кода.

  • authReferrerPolicy – ограничивает доступ к API по источнику ссылок HTTP, заданному пользователями Maps JS в Cloud Console (на страницах с какими URL будет срабатывать ключ API). Доступ можно ограничить только определенными адресами. Если же вы хотите, чтобы это были любые страницы в домене, присвойте параметру значение authReferrerPolicy: "origin". Это ограничит объем данных, пересылаемых при авторизации запросов от Maps JavaScript API. Если параметр определен и ограничения по источнику ссылок HTTP включены в Cloud Console, Maps JavaScript API сможет загружаться только на страницах домена (без уточнения пути), которым ограничен доступ.