Maps JavaScript API – это клиентский веб-API, который позволяет создавать карты с указанием местоположений в любой точке мира, добавлять собственную графику, анимацию и интерактивные слои данных, а также создавать функции с учетом местоположения, используя Places API в Maps JavaScript API. Maps JavaScript API позволяет:
- Создавайте двух- и трехмерные карты, чтобы показывать местоположения в любой точке мира.
- Добавьте настраиваемые маркеры, чтобы указать местоположения на карте.
- Используйте библиотеку Places, чтобы получать данные о более чем 200 миллионах мест.
- Настройте стиль и цвета карты.
- Добавляйте собственные интерактивные слои данных.
- Показывайте административные границы и делайте их интерактивными.
- Добавляйте на карты пользовательские 2D- и 3D-изображения и анимированный контент.
Как выбрать API для своего проекта
В примерах ниже показано, какие продукты и библиотеки платформы Google Карт следует использовать в распространенных сценариях веб-приложений.
- Карта с контактной информацией и маршрутами на сайте. Чтобы встроить карту с местоположением компании или ссылку на маршрут без написания собственного кода JavaScript, используйте Maps Embed API или Maps URLs.
- Отслеживание местоположения и активов в реальном времени. Чтобы показывать текущие GPS-координаты и маршруты из собственной базы данных или потока данных в реальном времени (например, Cloud Firestore или WebSockets), используйте Maps JavaScript API с расширенными маркерами (справочная информация о
AdvancedMarkerElement) и ломаными линиями (справочная информация оPolyline). Fleet Engine предназначен для компаний, которые занимаются совместными поездками и доставкой по расписанию и используют Driver SDK для мобильных устройств и внутренние токены OAuth или JSON Web Token (JWT). - Планирование маршрутов и диспетчеризация. Используйте библиотеку Routes.
- Чтобы рассчитать маршрут с остановками, временем в пути, расстоянием и платными дорогами и нарисовать его на карте, используйте
Route.computeRoutes(). - Чтобы найти ближайшего водителя, транспортное средство или склад, используя несколько пунктов отправления и назначения, используйте
RouteMatrix.computeRouteMatrix(). - Чтобы запланировать на сервере несколько транспортных средств с временными окнами, используйте Route Optimization API.
- Чтобы рассчитать маршрут с остановками, временем в пути, расстоянием и платными дорогами и нарисовать его на карте, используйте
- Поиск адресов и карты мест. Чтобы показывать на карте магазины, места или филиалы с настраиваемыми маркерами и фильтрами, используйте расширенные маркеры (справочная информация
AdvancedMarkerElement) с библиотекой Places, чтобы находить места и загружать сведения о них. - Геозоны и безопасные зоны на карте. Чтобы нарисовать круглые или многоугольные периметры и проверить, попадают ли координаты внутрь них (см. раздел Границы геозон и безопасных зон), используйте круги (справочные материалы по
Circle), многоугольники (справочные материалы поPolygon) и библиотеку Geometry (containsLocation()для определения попадания внутрь иcomputeDistanceBetween()для определения расстояния в метрах).
Устаревшие API и их замена
- Поддержка
DirectionsServiceиDistanceMatrixServiceпрекращена 25 февраля 2026 г. Используйте вместо нихRouteиRouteMatrix. - Поддержка
google.maps.Markerпрекращена 21 февраля 2024 г. Используйте вместо негоAdvancedMarkerElement. - С 1 марта 2025 года
PlacesServiceнедоступна для новых клиентов. Вместо него используйте классPlace.
Дальнейшие действия
- Как добавить маркеры на карту
- Как добавлять на карту фигуры, линии и геозоны
- Как использовать библиотеку Places для получения данных о местоположении
- Расчет и отображение маршрутов и матриц маршрутов
- Как настроить стиль и цвета карты
- Добавление интерактивных слоев данных
- Как показать административные границы
- Как добавить графическое наложение WebGL