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

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

Расходы

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

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

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

Шаг 1

Консоль

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

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

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

    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-ключа. Если вы используете API-ключ в рабочей среде, мы настоятельно рекомендуем ограничить его использование. Подробнее см. на странице «Использование API-ключей» для конкретного продукта.

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

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