Add Map

Load google maps api with javascript

Из этой инструкции вы узнаете, как добавить на веб-страницу простую карту Google с маркером. Для этого достаточно будет начального или среднего уровня знаний HTML и CSS и базовых знаний JavaScript. Инструкции уровня специалистов доступны в руководстве для разработчиков.

Ниже показана карта, которую вы создадите с помощью этой инструкции. Маркером на карте отмечена скала Улуру (Айерс-Рок) в австралийском национальном парке Улуру – Ката-Тьюта.

TypeScript

JavaScript

CSS

HTML

      
My Google Maps Demo
  
  
index.html

Примеры кода

Начало работы

Процесс создания встроенной в веб-страницу карты Google с маркером состоит из трех этапов:

Для работы потребуется веб-браузер. Рекомендуем использовать Google Chrome или другой популярный браузер (Firefox, Safari, Edge), поддерживаемый вашей платформой.

1. Создайте страницу HTML

Ниже приведен код HTML простейшей веб-страницы.

        
My Google Maps Demo
  
   
index.html

Это простейшая веб-страница с заголовком уровня h3 и единственным элементом div , на которую вы можете добавить контент по своему усмотрению.

Как понять код

Указанный ниже код создает страницу HTML, состоящую из заглавия и тела.

Чтобы на странице появился заголовок, показанный в примере, добавьте эту строку кода.

Код ниже определяет область страниц, на которой появится карта Google.

На этом этапе между тегами div ничего нет, поэтому на экране появится серое поле. Код ниже задает размер и цвет блока div с помощью стиля CSS.

/* Set the size of the div element that contains the map */ #map < height: 400px; /* The height is 400 pixels */ width: 100%; /* The width is the width of the web page */ >

Во фрагменте кода выше style задает размер и цвет блока div . Чтобы карта появилась на экране, ее ширина и высота в блоке div должны составлять более 0 пикс. В нашем примере высота div составляет 400 пикс., а ширина – 100 % видимой на экране области страницы.

Программа начальной загрузки подготавливает Maps JavaScript API к загрузке (до вызова importLibrary() загрузка библиотек не начинается).

Инструкции по получению ключа см. в разделе 3. Получите ключ API.

2. Добавьте карту с маркером

Ниже показано, как подгрузить на странице Maps JavaScript API и написать фрагмент кода JavaScript, добавляющий с помощью этого API карту с маркером.

TypeScript

JavaScript

Во фрагменте кода выше библиотеки Map и AdvancedMarkerView загружаются при вызове функции initMap() .

Как понять код

Фрагмент кода ниже создает новый объект карт Google и добавляет свойства карты (центральную точку и масштаб). Информация о других свойствах объекта доступна здесь.

TypeScript

JavaScript

Во фрагменте выше код new Map() создает новый объект карт Google. Свойство center сообщает API, где должен находиться центр карты.

Свойство zoom задает масштаб карты. Нулю соответствует самый мелкий масштаб (пользователь видит на экране всю планету). Чем больше значение свойства, тем крупнее масштаб видимой карты.

Код ниже помещает на карту маркер. Координаты маркера заданы в свойстве position .

TypeScript

JavaScript

3. Получите ключ API

Ниже объясняется, как аутентифицировать ваше приложение в Maps JavaScript API с помощью ключа API.

Выполните следующие действия:

1. Войдите в Google Cloud Console.
2. Создайте или выберите проект.
3. Нажмите Continue для активации API и всех связанных служб.
4. На странице Credentials (Учетные данные) получите ключ API и задайте для него ограничения. Если у вас есть действующий ключ API без ограничений или ключ с ограничениями для браузера, можете использовать его.
5. Узнайте, как защитить свою квоту от посторонних и обезопасить ключ API.
6. Включите оплату. Инструкции
7. Скопируйте весь код из руководства на этой странице в текстовый редактор.
8. Замените значение параметра key в URL-адресе своим ключом API (тем, который вы получили только что).

Советы и устранение неполадок

• Чтобы настроить отображение карты, меняйте стиль, свойства и другие переменные. Подробную информацию можно найти в руководствах по стилю и рисованию на карте.
• Используйте Инструменты разработчика в своем веб-браузере, чтобы тестировать и запускать свой код, просматривать отчеты об ошибках и устранять проблемы.
• Открыть консоль в Chrome можно сочетанием клавиш:
  Command+Option+J (Mac) или Control+Shift+J (Windows).
• Чтобы получить географические координаты (широту и долготу) точки на Google Картах:
  1. Откройте Google Карты в браузере.
  2. Нажмите правой кнопкой мыши на точку, координаты которой хотите получить.
  3. В появившемся контекстном меню выберите Что здесь. Появится карточка в нижней части экрана, в последней строке которой записаны значения широты и долготы.
• Преобразовать адрес в географические координаты можно с помощью службы геокодирования. Узнайте, как начать с ней работу.

Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons «С указанием авторства 4.0», а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.

Последнее обновление: 2023-06-26 UTC.

Источник

Saved searches

Use saved searches to filter your results more quickly

You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session.

Load the Google Maps JavaScript API script dynamically.

License

googlemaps/js-api-loader

This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Sign In Required

Please sign in to use Codespaces.

Launching GitHub Desktop

If nothing happens, download GitHub Desktop and try again.

Launching GitHub Desktop

If nothing happens, download GitHub Desktop and try again.

Launching Xcode

If nothing happens, download Xcode and try again.

Launching Visual Studio Code

Your codespace will open once ready.

There was a problem preparing your codespace, please try again.

Latest commit

### [1.16.2](v1.16.1. v1.16.2) (2023-06-14) ### Bug Fixes * Support for Advanced markers (AdvancedMarkerView) ([#803](#803)) ([a7a93d1](a7a93d1)), closes [#802](#802) ### Miscellaneous Chores * Add a unit test for valid URL generation ([#800](#800)) ([9a13708](9a13708))

Git stats

Files

Failed to load latest commit information.

README.md

Google Maps JavaScript API Loader

Load the Google Maps JavaScript API script dynamically. This takes inspiration from the google-maps npm package but updates it with ES6, Promises, and TypeScript.

Available via npm as the package @googlemaps/js-api-loader.

npm i @googlemaps/js-api-loader

Alternatively you may add the umd package directly to the html document using the unpkg link.

script src pl-s">https://unpkg.com/@googlemaps/js-api-loader@1.x/dist/index.min.js">script>

When adding via unpkg, the loader can be accessed at google.maps.plugins.loader.Loader .

TypeScript users need to install the following types package.

The reference documentation can be found at this link. The Google Maps JavaScript API documentation is the authoritative source for the loader options.

import  Loader > from '@googlemaps/js-api-loader'; const loader = new Loader( apiKey: "", version: "weekly", libraries: ["places"] >); const mapOptions =  center:  lat: 0, lng: 0 >, zoom: 4 >;

Using a promise for a specific library.

// Promise for a specific library loader .importLibrary('maps') .then((Map>) =>  new Map(document.getElementById("map"), mapOptions); >) .catch((e) =>  // do something >);

Using a promise for when the script has loaded.

// Promise loader .load() .then((google) =>  new google.maps.Map(document.getElementById("map"), mapOptions); >) .catch(e =>  // do something >);

Alternatively, if you want to use a callback.

// Callback loader.loadCallback(e =>  if (e)  console.log(e); > else  new google.maps.Map(document.getElementById("map"), mapOptions); > >);

View the package in action here.

This library is community supported. We’re comfortable enough with the stability and features of the library that we want you to build real production applications on it.

If you find a bug, or have a feature suggestion, please log an issue. If you’d like to contribute, please read How to Contribute.

About

Load the Google Maps JavaScript API script dynamically.

Источник