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

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

Расходы

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

Прежде чем вы начнете

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

Шаг 1

Приставка

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

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

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

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

Облачный SDK

gcloud projects create "PROJECT"

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

Шаг 2

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

Приставка

Включить Maps Embed API

Облачный SDK

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

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

Шаг 3

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

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

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

Приставка

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

    Перейти на страницу учетных данных

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

Облачный SDK

gcloud alpha 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 Console перейдите на страницу Управление ресурсами :

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

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

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