Чтобы загрузить код JavaScript для Maps JavaScript API, добавьте на свою страницу загрузочный URL в форму https://maps.googleapis.com/maps/api/js. Эта ссылка загружает все основные объекты и символы JavaScript для Maps JavaScript API. Некоторые функции этого API также доступны в автономных библиотеках, которые загружаются только по отдельному запросу. Разделение дополнительных компонентов на библиотеки позволяет быстро загружать и выполнять синтаксическую проверку основного API. Загружайте и проводите синтаксическую проверку библиотек, только если это действительно нужно.
Для загрузки дополнительных библиотек задайте параметр libraries в запросе загрузки, перечислив в нём названия этих библиотек (необходимо разделить запятой). Доступ к библиотекам можно получить с помощью пространства имен google.maps.libraryName.
Доступны следующие библиотеки:
drawing– предоставляет графический интерфейс для прорисовки на карте многоугольников, прямоугольников, ломаных линий, окружностей и маркеров. Подробнее см. в документации по библиотеке Drawing.geometry– содержит вспомогательные функции для вычисления скалярных геометрических значений (например, расстояния и площади) на поверхности Земли. Подробнее см. в документации по библиотеке Geometry.journeySharing(только в бета-версии) – предоставляет поддержку для решений Google Maps Platform в сферах транспорта и логистики.localContext– показывает пользователям главные достопримечательности рядом с выбранным местом. Подробнее см. в документации по библиотеке Local Context.marker– позволяет добавлять на карту улучшенные маркеры с расширенными возможностями кастомизации. Подробнее читайте в документации по улучшенным маркерам.places– позволяет приложению выполнять поиск адресов (например, организаций), географических координат или главных достопримечательностей в пределах заданной области. Подробнее см. в документации по библиотеке геометрических Places.visualization– рисует тепловые карты с визуальным представлением данных. Подробнее см. в документации по библиотеке геометрических Visualization.
Предварительные версии. Перечисленные ниже библиотеки доступны только в бета-версиях (v=beta):
core(google.maps.CoreLibrary)maps(google.maps.MapsLibrary)places(google.maps.PlacesLibrary)geocoding(google.maps.GeocodingLibrary)routes(google.maps.RoutesLibrary)marker(google.maps.MarkerLibrary)geometry(google.maps.GeometryLibrary)elevation(google.maps.ElevationLibrary)streetView(google.maps.StreetViewLibrary)journeySharing(google.maps.JourneySharingLibrary)drawing(google.maps.DrawingLibrary)visualization(google.maps.VisualizationLibrary)
В примере ниже мы запрашиваем загрузку библиотеки google.maps.geometry для Maps JavaScript API:
<script async
src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=geometry&callback=initMap">
</script>
Чтобы запросить несколько библиотек, их следует перечислить через запятую:
<script async
src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=geometry,places&callback=initMap">
</script>