Быстрый старт

Создайте бесплатный аккаунт на странице регистрации. Бесплатный тариф включает 1 000 запросов в месяц - достаточно для тестирования и небольших проектов.

В личном кабинете создайте API-ключ. Ключ начинается с префикса mk_ и используется для всех запросов к API.

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

• Заголовок X-API-Key: mk_ваш_ключ - рекомендуемый способ
• Query-параметр ?api_key=mk_ваш_ключ - для отладки

Используйте любой HTTP-клиент для вызова API геокодинга. Вот примеры на разных языках:

curl "https://me3ka.ru/api/geocode?q=Москва+Тверская+1&limit=3" \
  -H "X-API-Key: mk_ваш_ключ"

const response = await fetch(
  'https://me3ka.ru/api/geocode?q=Москва+Тверская+1&limit=3',
  { headers: { 'X-API-Key': 'mk_ваш_ключ' } }
);
const data = await response.json();
console.log(data.results[0].lat, data.results[0].lon);

import requests

r = requests.get(
    'https://me3ka.ru/api/geocode',
    params={'q': 'Москва Тверская 1', 'limit': 3},
    headers={'X-API-Key': 'mk_ваш_ключ'}
)
result = r.json()['results'][0]
print(f"{result['lat']}, {result['lon']}")

{
  "results": [
    {
      "name": "г Москва, ул Тверская, д 1",
      "lat": 55.7558,
      "lon": 37.6173,
      "type": "building",
      "score": 0.92
    }
  ],
  "query": "Москва Тверская 1",
  "count": 1,
  "time_ms": 87
}

Помимо геокодинга, Me3ka предоставляет другие API: