Как настроить Weather API

В этом документе описаны шаги, которые необходимо выполнить, чтобы начать использовать Weather API.

Чтобы начать работу с Weather API, запросите демоключ Карт или создайте аккаунт и включите платежные функции.

Как получить демоключ Карт

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

Как получить стандартный ключ API

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

Требования

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

1. Ознакомьтесь с информацией о выставлении счетов и стоимости использования в статье Статистика использования и оплата Weather API.

2. Убедитесь, что у вас есть аккаунт Google Cloud.

   Войдите в консоль Google Cloud.
   Примечание. Если вы новый пользователь и у вас нет аккаунта Google Cloud, то есть вы не можете войти в консоль, прочитайте статью Начало работы с платформой Google Карт.

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

   Перейти на страницу "Оплата"
   Примечание. Если вы новый пользователь и у вас нет облачного проекта Google Cloud, ознакомьтесь со статьей Начало работы с платформой Google Карт.
1. Выберите проект, чтобы открыть страницу Billing (Оплата).

2. На странице Оплата:

   • Если для выбранного проекта уже включена оплата и у вас только один платежный аккаунт, откроется страница Оплата.
   • Если у вас несколько платежных аккаунтов, нажмите Открыть этот аккаунт. Появится страница с информацией о платежном аккаунте, связанном с проектом.
   • Если у вас есть платежный аккаунт, но он не связан с проектом, вам будет предложено связать их.
   • Если у вас нет платежного аккаунта или вы хотите создать новый, выберите Manage Billing Accounts (Управление платежными аккаунтами). Подробнее о том, как создать платежный аккаунт Cloud для самостоятельного использования…

Включение API

Прежде чем использовать Weather API, необходимо включить его в облачном проекте Google Cloud в консоли Google Cloud или с помощью команды gcloud.

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

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

Консоль

1. Откройте страницу продукта в консоли Google Cloud:

   Как включить Weather API

2. Нажмите Включить.

   Примечание. Если API уже включен, вместо кнопки Включить вы увидите кнопку Управление.

gcloud

gcloud services enable \
    --project "PROJECT" \
    "weather.googleapis.com"

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

• gcloud services enable
• gcloud services disable

Как получить ключ API для использования с Weather API

Важно! В этом руководстве по настройке описаны процедуры настройки ключа API и создания токена OAuth. Выберите процедуру, которая подходит для вашей среды развертывания.

Продукты платформы Google Карт защищены от несанкционированного использования, поскольку принимают только те вызовы API, которые содержат ключ API или токен OAuth. Сначала нужно получить ключ API. Если вы хотите использовать токен OAuth, ознакомьтесь с разделом Как создать токен OAuth.

Ключ API – это уникальная буквенно-цифровая строка, которая связывает ваш платежный аккаунт Cloud и облачный проект Google Cloud с запросом, который ваше приложение отправляет в API или SDK платформы Google Карт. Чтобы создать ключ или добавить API или SDK к существующему ключу, следуйте инструкциям ниже.

Консоль

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

   Перейти на страницу "Ключи и учетные данные"

2. Если появится запрос, выберите проект.

3. Выполните одно из следующих действий:

   • Создайте ключ.

     1. Нажмите Создать учетные данные > Ключ API.
     2. На панели Create API key (Создать ключ API) откройте список Select API restrictions (Выбрать ограничения API).
     3. Удалите все API, которые не нужны для этого ключа, и убедитесь, что выбран Weather API.
     4. Нажмите Создать. На панели появится новый ключ API.

   • Использовать существующий ключ:

     1. Нажмите на название ключа.
     2. В списке Select API restrictions (Выбрать ограничения API) выберите Weather API.
     3. Нажмите Сохранить.

   Выбор API не означает его включение. Убедитесь, что Weather API включен на странице библиотеки API.

4. Чтобы посмотреть строку ключа позже, перейдите на страницу Ключи и учетные данные и нажмите Показать ключ.

Если консоль выглядит иначе, чем описано в этих шагах, ознакомьтесь с разделами Создание ключа API и Добавление ограничений API в документации Google Cloud.

gcloud

В следующих командах замените PROJECT_ID идентификатором своего проекта.

• Создайте новый ключ. Выполните следующую команду, заменив DISPLAY_NAME на название ключа.

  gcloud services api-keys create \
      --project="PROJECT_ID" \
      --display-name="DISPLAY_NAME" \
      --api-target=service=weather.googleapis.com

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

  • gcloud services api-keys create

• Использовать существующий ключ. Выполните следующую команду, заменив KEY_ID идентификатором ключа. Флаг --append сохраняет API, которые уже разрешены ключом. Если его не указать, команда заменит их.

  gcloud services api-keys update KEY_ID \
      --project="PROJECT_ID" \
      --append \
      --api-target=service=weather.googleapis.com

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

  • gcloud services api-keys update
  • gcloud services api-keys list

  Идентификатор ключа – это не строка ключа и не отображаемое название. Чтобы найти его, выполните команду gcloud services api-keys list --project="PROJECT_ID". Идентификатор – это последняя часть поля name: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.

Чтобы посмотреть строку ключа, выполните команду gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID".

Как отправить запрос к API

Сделайте запрос к Weather API, чтобы получить ответ в формате JSON с информацией о текущих погодных условиях в Маунтин-Вью, Калифорния. Вы должны включать буквенно-цифровую строку ключа API в каждый запрос и использовать HTTPS для запросов, содержащих ключ API.

1. Нажмите API_KEY в коде ниже, чтобы вставить буквенно-цифровую строку ключа:

   curl -X GET "https://weather.googleapis.com/v1/currentConditions:lookup?key=YOUR_API_KEY&location.latitude=37.4220&location.longitude=-122.0841"
   

2. Нажмите на значок копирования в примере кода , чтобы скопировать команду curl.
3. Вставьте команду в окно терминала и запустите ее.

Вы получите объект JSON следующего вида:

{
  "currentTime": "2025-07-01T12:33:24.606422609Z",
  "timeZone": {
    "id": "America/Los_Angeles"
  },
  "isDaytime": false,
  "weatherCondition": {
    "iconBaseUri": "https://maps.gstatic.com/weather/v1/partly_clear",
    "description": {
      "text": "Partly cloudy",
      "languageCode": "en"
    },
    "type": "PARTLY_CLOUDY"
  },
  "temperature": {
    "degrees": 16,
    "unit": "CELSIUS"
  },
  "feelsLikeTemperature": {
    "degrees": 16,
    "unit": "CELSIUS"
  },
  "dewPoint": {
    "degrees": 12,
    "unit": "CELSIUS"
  },
  "heatIndex": {
    "degrees": 16,
    "unit": "CELSIUS"
  },
  "windChill": {
    "degrees": 16,
    "unit": "CELSIUS"
  },
  "relativeHumidity": 78,
  "uvIndex": 0,
  "precipitation": {
    "probability": {
      "percent": 3,
      "type": "RAIN"
    },
    "snowQpf": {
      "quantity": 0,
      "unit": "MILLIMETERS"
    },
    "qpf": {
      "quantity": 0,
      "unit": "MILLIMETERS"
    }
  },
  "thunderstormProbability": 0,
  "airPressure": {
    "meanSeaLevelMillibars": 1011.5
  },
  ...
}

Как применить ограничения для ключа API

Внимание! Ключ API без ограничений можно использовать для отправки запросов к любому сервису платформы Google Карт, включая Weather API. Вы несете финансовую ответственность за расходы, вызванные злоупотреблением ключами API без ограничений.

Мы настоятельно рекомендуем ограничивать использование ключей API только теми API и приложениями, которым они необходимы. Ограничение ключей API повышает безопасность вашего приложения, защищая его от нежелательных запросов. Для ключей API поддерживаются два типа ограничений:

• Ограничения API определяют, какие SDK и API можно вызывать с помощью ключа API. При создании ключа в консоли или gcloud CLI необходимо задать хотя бы одно ограничение API.
• Ограничения для приложений определяют, какие сайты, IP-адреса или приложения могут использовать ключ API.

Подробнее о том, как ограничить использование ключей API…

Как создать токен OAuth

Weather API поддерживает аутентификацию OAuth 2.0. Google поддерживает распространенные сценарии OAuth 2.0, например для веб-сервера.

В этом документе описывается, как передать токен OAuth в вызов Weather API в среде разработки. Дополнительную информацию об использовании OAuth в рабочей среде можно найти в статье Способы аутентификации в Google.

Общая информация о протоколе OAuth

Создавать токены доступа и управлять ими с помощью OAuth можно несколькими способами в зависимости от среды развертывания.

Вы можете использовать OAuth 2.0 для межсерверного взаимодействия между вашим приложением и сервисом Google. В этом случае вы используете сервисный аккаунт, связанный с вашим приложением, а не с отдельным пользователем. Вы можете отправлять запросы к API, используя сервисный аккаунт, без непосредственного участия пользователей. Подробнее о способах аутентификации в Google…

Вы также можете интегрировать Weather API в мобильное приложение для Android или iOS. Дополнительную информацию об использовании OAuth и управлении токенами доступа для разных сред развертывания можно найти в статье Использование OAuth 2.0 для доступа к API Google.

Области действия OAuth

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

https://www.googleapis.com/auth/cloud-platform

Пример. Попробуйте вызовы REST API в локальной среде разработки

Если у вас нет среды, которая генерирует токены, и вы хотите попробовать Weather API с токеном OAuth, выполните процедуру, описанную в этом разделе.

В этом примере показано, как использовать токен OAuth, предоставленный Application Default Credentials (ADC), для выполнения вызова. Подробнее о том, как выполнить аутентификацию с помощью клиентских библиотек с использованием ADC для вызова API Google…

Приведенную ниже процедуру REST следует использовать только для разработки или тестирования, но не для рабочей среды.

Требования

Прежде чем отправлять REST-запрос с помощью ADC, предоставьте ADC учетные данные, используя CLI gcloud:

1. Установите и инициализируйте интерфейс командной строки gcloud. Подробнее о том, как установить gcloud CLI…

2. Выполните аутентификацию с помощью интерфейса командной строки gcloud:

   gcloud auth application-default login

3. Завершите процесс входа, чтобы сохранить учетные данные в локальном файле учетных данных, используемом ADC.

Подробнее о том, как настроить ADC для локальной среды разработки…

Как выполнить REST-запрос

В этом примере вы передаете два заголовка запроса:

• Передайте токен OAuth в заголовке Authorization, используя следующую команду для создания токена:

  gcloud auth application-default print-access-token

  Возвращенный токен имеет область действия https://www.googleapis.com/auth/cloud-platform.

• Передайте идентификатор или название проекта Google Cloud, для которого включена оплата, в заголовке X-Goog-User-Project.

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

1. В следующем примере кода замените PROJECT_NUMBER_OR_ID на номер или идентификатор облачного проекта Google Cloud:

   curl -X GET \
   -H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
   -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
   "https://weather.googleapis.com/v1/currentConditions:lookup?location.latitude=37.4220&location.longitude=-122.0841"

2. Чтобы скопировать команду curl, нажмите Копировать в примере кода.

3. Вставьте команду в окно терминала и запустите ее.

Вы получите объект JSON:

{
  "currentTime": "2025-07-01T12:33:24.606422609Z",
  "timeZone": {
    "id": "America/Los_Angeles"
  },
  "isDaytime": false,
  "weatherCondition": {
    "iconBaseUri": "https://maps.gstatic.com/weather/v1/partly_clear",
    "description": {
      "text": "Partly cloudy",
      "languageCode": "en"
    },
    "type": "PARTLY_CLOUDY"
  },
  "temperature": {
    "degrees": 16,
    "unit": "CELSIUS"
  },
  "feelsLikeTemperature": {
    "degrees": 16,
    "unit": "CELSIUS"
  },
  "dewPoint": {
    "degrees": 12,
    "unit": "CELSIUS"
  },
  "heatIndex": {
    "degrees": 16,
    "unit": "CELSIUS"
  },
  "windChill": {
    "degrees": 16,
    "unit": "CELSIUS"
  },
  "relativeHumidity": 78,
  "uvIndex": 0,
  "precipitation": {
    "probability": {
      "percent": 3,
      "type": "RAIN"
    },
    "snowQpf": {
      "quantity": 0,
      "unit": "MILLIMETERS"
    },
    "qpf": {
      "quantity": 0,
      "unit": "MILLIMETERS"
    }
  },
  "thunderstormProbability": 0,
  "airPressure": {
    "meanSeaLevelMillibars": 1011.5
  },
  ...
}

Устранение неполадок

Если в ответ на запрос вы получаете сообщение об ошибке о том, что API не поддерживает учетные данные конечных пользователей, ознакомьтесь с разделом Устранение неполадок с настройкой ADC.

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

Теперь, когда вы включили Weather API и успешно выполнили запрос, прочитайте статью Как получить текущие погодные условия, чтобы узнать больше об использовании API.