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

Разместите интерактивную карту или панораму Street View на своей веб-странице с помощью простого 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, которые вы планируете использовать в своем проекте.

Консоль

Включите 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 Maps > страницу «Учетные данные» .

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

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

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

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

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

  • Начните разработку с помощью Maps Embed API, настроив свой проект Google Cloud:

    Настройка в Cloud Console

  • Список дополнительных параметров и опций, которые вы можете добавить в свой iframe:

    Вставка карты

  • Расширьте свой проект Карт с помощью API Javascript:

    Карты Javascript API