Чтобы загрузить код 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>