Документация для разработчиков

Начните работу с QazMap API за 5 минут

1

Получите API ключ

Зарегистрируйтесь и получите бесплатный API ключ для начала работы

2

Установите SDK

Выберите SDK для вашей платформы и установите через пакетный менеджер

3

Интегрируйте карту

Добавьте несколько строк кода и карта готова к работе

SDK и библиотеки

Готовые решения для всех популярных платформ

JavaScript / TypeScript

Для веб-приложений

npm install @qazmap/sdk Документация →

React

React компоненты

npm install @qazmap/react Документация →

Python

Для backend приложений

pip install qazmap Документация →

iOS (Swift)

Нативный SDK для iOS

pod 'QazMapSDK' Документация →

Android (Kotlin)

Нативный SDK для Android

implementation 'kz.qazmap:sdk' Документация →

REST API

Прямые HTTP запросы

curl api.qazmap.kz/v1 Документация →

Пример кода

Добавьте интерактивную карту на вашу страницу

// Инициализация карты
import QazMap from '@qazmap/sdk';

const map = new QazMap({
  container: 'map',
  style: 'qazmap://styles/streets',
  center: [71.4704, 51.1694], // Астана
  zoom: 12,
  apiKey: 'YOUR_API_KEY'
});

// Добавление маркера
map.addMarker({
  coordinates: [71.4704, 51.1694],
  title: 'Астана'
});
// React компонент с картой
import { QazMapReact, Marker } from '@qazmap/react';

function MapComponent() {
  return (
    <QazMapReact
      style="qazmap://styles/streets"
      center={[71.4704, 51.1694]}
      zoom={12}
      apiKey="YOUR_API_KEY"
    >
      <Marker
        coordinates={[71.4704, 51.1694]}
        title="Астана"
      />
    </QazMapReact>
  );
}
# Python интеграция
from qazmap import QazMap

# Инициализация клиента
client = QazMap(api_key='YOUR_API_KEY')

# Геокодирование адреса
result = client.geocode('Астана, проспект Мәңгілік Ел')
print(f"Координаты: {result.coordinates}")

# Построение маршрута
route = client.directions(
    origin=[71.4704, 51.1694],
    destination=[71.4447, 51.1282]
)
print(f"Расстояние: {route.distance} км")
// Swift для iOS
import QazMapSDK

class MapViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()

        // Инициализация карты
        let mapView = QazMapView(
            style: .streets,
            apiKey: "YOUR_API_KEY"
        )

        // Установка центра карты
        mapView.setCenter(
            coordinate: CLLocationCoordinate2D(
                latitude: 51.1694,
                longitude: 71.4704
            ),
            zoom: 12
        )

        view.addSubview(mapView)
    }
}