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

Добавьте на веб-страницу интерактивную карту или панораму в Просмотре улиц с помощью простого HTTP-запроса. Пользовательский код JavaScript не требуется.

Расходы

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

Подготовка

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

Шаг 1

Консоль

  1. Перейдите на страницу выбора проекта в консоли Google Cloud Console и нажмите Create Project (Создать проект).

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

  2. Убедитесь, что для проекта Google Cloud включены платежные функции.

    Мы предлагаем бесплатный пробный период для использования Google Cloud. Он длится 90 дней или пока сумма расходов не достигнет 300 долл. США в зависимости от того, что произойдет раньше. Отказаться от предложения можно в любое время. Ознакомьтесь с информацией о бонусах в платежных аккаунтах и об оплате.

Cloud SDK

gcloud projects create "PROJECT"

Прочитайте статьи о Google Cloud SDK, установке Cloud SDK и следующих командах:

Шаг 2

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

Консоль

Как включить Maps Embed API

Cloud SDK

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

Прочитайте статьи о Google Cloud SDK, установке Cloud SDK и следующих командах:

Шаг 3

На этом шаге рассматривается только создание ключа API. Если у вас есть собственный ключ API, мы настоятельно рекомендуем настроить для него ограничения. Подробная информация приводится в разделе Использование ключей API.

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

Чтобы создать ключ API, выполните следующие действия.

Cloud Console

  1. Откройте страницу Google Maps Platform > Credentials (Платформа Google Карт > Учетные данные).

    Перейти к настройкам учетных данных

  2. На странице Credentials (Учетные данные) нажмите Create credentials > API key (Создать учетные данные > Ключ API).
    Появится диалоговое окно с созданным ключом API.
  3. Нажмите Close (Закрыть).
    Новый ключ API можно будет найти на странице Credentials (Учетные данные) в разделе API keys (Ключи API).
    Не забудьте настроить ограничения для ключа API, прежде чем использовать его в рабочей среде.

Cloud 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.
  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. В диалоговом окне введите идентификатор проекта и нажмите Завершение работы, чтобы удалить проект.

Дальнейшие действия