Краткое руководство по Maps Embed API

Разместите интерактивную карту или панораму Street View на своей веб-странице с помощью простого HTTP-запроса — JavaScript не требуется.

Расходы

Все запросы Maps Embed API доступны бесплатно с неограниченным использованием. Однако все запросы по-прежнему требуют действительный ключ Google Cloud API. Для получения дополнительной информации см. Использование и выставление счетов .

Прежде чем начать

Чтобы создать встроенную карту на своей веб-странице, выполните необходимые шаги по настройке, перейдя по следующим вкладкам:

Шаг 1

Консоль

  1. В консоли Google Cloud на странице выбора проекта нажмите «Создать проект» , чтобы начать создание нового облачного проекта.

    Перейти на страницу выбора проекта

  2. Убедитесь, что биллинг включен для вашего проекта Cloud. Подтвердите, что биллинг включен для вашего проекта .

    Google Cloud предлагает пробную версию за 0,00 $. Пробная версия истекает в конце 90 дней или после того, как счет накопит 300 $ расходов, в зависимости от того, что наступит раньше. Отменить можно в любое время. Для получения дополнительной информации см. разделы Кредиты на счете выставления счетов и Выставление счетов .

Облачный SDK 

gcloud projects create "PROJECT"

Узнайте больше о Google Cloud SDK , установке Cloud SDK и следующих командах:

Шаг 2

Чтобы использовать платформу Google Карт, вам необходимо включить API или SDK, которые вы планируете использовать в своем проекте.

Консоль

Включить API встраивания Карт

Облачный SDK 

gcloud services enable \
    --project "PROJECT" \
    "maps-embed-backend.googleapis.com"

Узнайте больше о Google Cloud SDK , установке Cloud SDK и следующих командах:

Шаг 3

Этот шаг проходит только через процесс создания API Key. Если вы используете свой API Key в производстве, мы настоятельно рекомендуем вам ограничить свой API Key. Вы можете найти дополнительную информацию на странице Using API Keys для конкретного продукта.

API-ключ — это уникальный идентификатор, который аутентифицирует запросы, связанные с вашим проектом, для целей использования и выставления счетов. У вас должен быть хотя бы один API-ключ, связанный с вашим проектом.

Чтобы создать ключ API:

Консоль

  1. Перейдите на страницу «Платформа Google Карт» > «Учетные данные» .

    Перейти на страницу «Учетные данные»

  2. На странице «Учетные данные» нажмите «Создать учетные данные» > «Ключ API» .
    В диалоговом окне создания ключа API отображается только что созданный ключ API.
  3. Нажмите Закрыть.
    Новый ключ API указан на странице «Учетные данные» в разделе «Ключи API» .
    (Не забудьте ограничить ключ API перед его использованием в производстве.)

Облачный SDK 

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Узнайте больше о Google Cloud SDK , установке Cloud SDK и следующих командах:

Создание iframe

Нажмите на следующие параметры и добавьте местоположение и ключ API, чтобы сгенерировать iframe для вашей веб-страницы. Дополнительные параметры и параметры см. в разделе Встраивание карты .

Тестирование вашего iframe

Чтобы увидеть ваш iframe в окне HTML-браузера:

  1. Откройте текстовый редактор по умолчанию. На вашем устройстве по умолчанию должны быть установлены текстовые редакторы, такие как TextEdit или Microsoft Windows Notepad .
  2. Создайте HTML-файл и назовите его index.html .

  3. Добавьте следующий код в iframe, который вы сгенерировали выше:

    <html>
  <!-- Replace this code comment with your iframe. -->
</html>

  4. Сохраните HTML-файл index.html .

  5. Загрузите HTML-файл в веб-браузер, перетащив его с рабочего стола в браузер; в большинстве операционных систем это можно сделать, дважды щелкнув по файлу.

Поздравляем! Вы только что настроили и создали карту с помощью Maps Embed API.

Уборка

Вы можете удалить свой проект Google Cloud, чтобы прекратить взимание платы за все ресурсы, используемые в этом проекте.

  1. В консоли Google Cloud перейдите на страницу «Управление ресурсами» :

    Перейти на страницу управления ресурсами

  2. Если проект, который вы планируете удалить, привязан к организации, выберите и разверните список организаций в верхней части страницы.
  3. В списке проектов выберите проект, который вы хотите удалить, и нажмите Удалить .
  4. В диалоговом окне введите идентификатор проекта и нажмите «Завершить работу» , чтобы удалить проект.

Следующие шаги