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

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

Расходы

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

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

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

Шаг 1

Консоль

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

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

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

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

Облачный SDK 

gcloud projects create "PROJECT"

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

Шаг 2

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

Консоль

Включите API для встраивания карт.

Облачный SDK 

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

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

Шаг 3

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

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

Для создания ключа API:

Консоль

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

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

  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 .
  2. Создайте HTML-файл и назовите его index.html .

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

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

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

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

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

Уборка

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

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

    Перейдите на страницу «Управление ресурсами».

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

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