Получение API-ключей и настройка аккаунта

Все сервисы HERE Maps API предоставляются через облачную платформу HERE Platform. Для доступа к картографическим данным, геокодированию, маршрутизации, поиску объектов, матрицам расстояний и другим сервисам требуется зарегистрированный аккаунт и действительные учетные данные авторизации.

Аккаунт выполняет несколько важных функций:

  • идентификация владельца приложений;
  • управление API-ключами;
  • контроль использования сервисов;
  • просмотр статистики запросов;
  • настройка проектов и приложений;
  • контроль лимитов и тарифных планов;
  • доступ к дополнительным продуктам HERE.

Без корректно настроенного аккаунта выполнение запросов к HERE API невозможно.

Регистрация аккаунта HERE

Создание аккаунта начинается на официальном портале HERE Developer.

В процессе регистрации указываются:

  • имя пользователя;
  • адрес электронной почты;
  • пароль;
  • сведения об организации (при необходимости);
  • страна регистрации.

После подтверждения электронной почты становится доступна консоль управления HERE Platform.

В зависимости от выбранного тарифного плана аккаунт получает определенные лимиты на использование сервисов.

Основные категории тарифов:

Тип аккаунта Назначение
Free Изучение платформы и небольшие проекты
Freemium Ограниченное коммерческое использование
Enterprise Крупные коммерческие решения

После регистрации автоматически создается рабочее пространство пользователя.

Структура консоли HERE Platform

После входа открывается панель управления платформой.

Основные разделы:

Projects

Раздел для создания и управления проектами.

Каждое приложение рекомендуется размещать в отдельном проекте.

Проект может содержать:

  • API-ключи;
  • приложения;
  • наборы данных;
  • настройки доступа;
  • сервисные учетные данные.

Access Manager

Раздел управления авторизацией.

Используется для:

  • создания API-ключей;
  • генерации OAuth-токенов;
  • управления разрешениями;
  • контроля доступа приложений.

Usage

Раздел статистики использования сервисов.

Позволяет отслеживать:

  • количество запросов;
  • потребление ресурсов;
  • превышение лимитов;
  • активность приложений.

Billing

Раздел управления оплатой.

Содержит:

  • информацию о тарифах;
  • платежные данные;
  • отчеты по расходам;
  • историю выставленных счетов.

Создание проекта

Перед генерацией ключей рекомендуется создать отдельный проект.

Типичный порядок действий:

  1. Открыть раздел Projects.
  2. Нажать кнопку создания проекта.
  3. Указать название проекта.
  4. Добавить описание.
  5. Сохранить настройки.

Пример структуры проектов:

Проект Назначение
Delivery App Сервис доставки
Logistics Dashboard Панель логистики
Fleet Tracking Мониторинг транспорта
Geo Search Service Геопоиск объектов

Такой подход упрощает сопровождение и масштабирование инфраструктуры.

API Key как основной механизм авторизации

Для большинства JavaScript-приложений используется API Key.

API Key представляет собой уникальный идентификатор приложения.

Пример структуры:

ABCD1234EFGH5678IJKL9012MNOP3456

Ключ передается в запросах к HERE Platform и позволяет системе определить источник обращения.

Преимущества API Key:

  • простота настройки;
  • отсутствие необходимости получать токены;
  • быстрая интеграция;
  • поддержка большинства сервисов HERE.

Для клиентских JavaScript-приложений API Key является стандартным вариантом авторизации.

Генерация API-ключа

Создание ключа выполняется через Access Manager.

Последовательность действий:

  1. Открыть Access Manager.
  2. Перейти в раздел управления ключами.
  3. Создать новый API Key.
  4. Указать название ключа.
  5. Сохранить изменения.

После генерации система отобразит строку ключа.

Пример:

V6JYjKzT3jM8Q2K7bF4gX1nR9YwP5LsA

Ключ следует сохранить в безопасном месте.

Использование API Key в JavaScript

При инициализации платформы ключ передается в конфигурационный объект.

Пример подключения:

const platform = new H.service.Platform({
    apikey: "YOUR_API_KEY"
});

После создания экземпляра платформы становятся доступны сервисы картографии и геоданных.

Проверка корректности ключа

Наиболее простой способ проверки — загрузка карты.

Пример:

const platform = new H.service.Platform({
    apikey: "YOUR_API_KEY"
});

const layers = platform.createDefaultLayers();

const map = new H.Map(
    document.getElementById("map"),
    layers.vector.normal.map,
    {
        zoom: 10,
        center: { lat: 55.7558, lng: 37.6176 }
    }
);

Если карта успешно отображается, ключ считается рабочим.

При ошибке авторизации в консоли браузера обычно появляются сообщения:

401 Unauthorized

или

403 Forbidden

Ограничение доступа по доменам

Для повышения безопасности рекомендуется ограничивать использование ключей.

Допускается настройка разрешенных доменов:

example.com
www.example.com
app.example.com

Преимущества ограничения:

  • защита от кражи ключа;
  • предотвращение несанкционированного использования;
  • снижение риска превышения лимитов.

Даже при утечке ключа сторонние сайты не смогут использовать его вне разрешенных доменов.

Ограничение доступа по IP-адресам

Для серверных приложений может использоваться привязка к IP-адресам.

Примеры:

192.168.1.10
203.0.113.15

Подход особенно полезен для:

  • Node.js-сервисов;
  • внутренних API;
  • микросервисной архитектуры;
  • корпоративных систем.

Ротация API-ключей

Практикой промышленной разработки является периодическая замена ключей.

Причины ротации:

  • повышение безопасности;
  • предотвращение компрометации;
  • соблюдение корпоративных требований.

Типичный процесс:

  1. Создать новый ключ.
  2. Обновить конфигурацию приложения.
  3. Развернуть новую версию.
  4. Удалить старый ключ.

Наличие нескольких активных ключей позволяет выполнить замену без остановки сервиса.

OAuth как альтернативный механизм авторизации

Помимо API Key платформа HERE поддерживает OAuth 2.0.

OAuth применяется в случаях:

  • работы с защищенными API;
  • интеграции корпоративных решений;
  • использования расширенных возможностей платформы;
  • взаимодействия между сервисами.

OAuth включает несколько сущностей:

  • Access Key ID;
  • Access Key Secret;
  • Access Token;
  • Refresh Token.

Для браузерных картографических приложений OAuth используется значительно реже, чем API Key.

Различия между API Key и OAuth

Характеристика API Key OAuth
Простота настройки Высокая Средняя
Использование в браузере Да Ограниченно
Серверные приложения Да Да
Уровень безопасности Хороший Очень высокий
Работа с защищенными сервисами Не всегда Да

Для большинства проектов на JavaScript достаточно API Key.

Организация хранения ключей

Никогда не следует хранить ключи в открытом виде внутри репозитория.

Нежелательный вариант:

const API_KEY = "REAL_API_KEY";

Более безопасный подход для серверных приложений:

const API_KEY = process.env.HERE_API_KEY;

Файл окружения:

HERE_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxx

При публикации исходного кода файл .env обычно исключается из системы контроля версий.

Переменные окружения в Node.js

Использование пакета dotenv:

npm install dotenv

Подключение:

require("dotenv").config();

const apiKey = process.env.HERE_API_KEY;

Инициализация платформы:

const platform = new H.service.Platform({
    apikey: apiKey
});

Такой подход считается стандартом для современных JavaScript-проектов.

Мониторинг использования API

После начала работы приложения необходимо регулярно контролировать статистику.

Консоль HERE позволяет анализировать:

  • количество запросов по дням;
  • потребление отдельных сервисов;
  • динамику нагрузки;
  • ошибки авторизации;
  • превышение квот.

Контроль статистики помогает:

  • выявлять ошибки интеграции;
  • прогнозировать затраты;
  • обнаруживать подозрительную активность;
  • предотвращать блокировку из-за превышения лимитов.

Типичные ошибки при настройке аккаунта

Использование устаревших учетных данных

Некоторые старые примеры кода используют:

app_id
app_code

Подобный механизм считается устаревшим.

Современные версии HERE Maps API используют:

apikey

Публикация ключа в открытом репозитории

Ошибка приводит к:

  • несанкционированному использованию API;
  • быстрому расходованию квот;
  • возможной блокировке ключа.

Отсутствие ограничений по доменам

Без ограничений любой пользователь, получивший ключ, сможет использовать его в собственных приложениях.

Использование одного ключа для всех проектов

Такой подход усложняет:

  • анализ статистики;
  • поиск ошибок;
  • управление доступом;
  • масштабирование инфраструктуры.

Для каждого проекта рекомендуется создавать отдельный API Key.

Рекомендуемая схема организации доступа

Для производственной среды часто используется следующая структура:

HERE Account
│
├── Project A
│   ├── API Key A1
│   └── API Key A2
│
├── Project B
│   ├── API Key B1
│   └── API Key B2
│
└── Project C
    └── API Key C1

Преимущества такой организации:

  • изоляция проектов;
  • удобная аналитика;
  • безопасная ротация ключей;
  • упрощенное сопровождение;
  • централизованный контроль использования сервисов HERE Platform.
Оглавление