---
id: live-3d-tracker
title: Live 3D Tracker в Sport Line API
description: Описание виджета Live 3D Tracker для визуализации хода спортивного матча в реальном времени.
version: v1
language: ru
---

# Live 3D Tracker в Sport Line API


## Что такое Live 3D Tracker

Live 3D Tracker — это готовый виджет визуализации спортивного матча. Он показывает поле
или площадку, положение мяча, атаки, счёт, таймер и игровые события.

Sport Line API не передаёт клиенту данные для самостоятельной отрисовки трекера. API
только помогает определить, доступен ли готовый виджет для конкретного матча, и
возвращает его идентификатор в поле `zp`.

```text
Sport Line API → поле zp → готовый виджет Live 3D Tracker
```

Трекер не является самостоятельным источником списка матчей. Чтобы найти матч и получить
его `zp`, клиенту нужна подписка на спортивную линию SportAPI.

## Готовый виджет

Клиенту не нужно разрабатывать визуализацию матча самостоятельно. SportAPI предоставляет
готовый виджет, который встраивается на сайт или в веб-приложение.

Доступны два способа подключения:

- прямой `iframe`;
- скрипт `embed.js`, который автоматически создаёт `iframe` и позволяет управлять
  виджетом через JavaScript.

Краткий пример прямого встраивания:

```html
<iframe
  src="https://bet-embed-sport-tracker.vercel.app/?key=pk_live_yourkey&gameid=745829876&sport=1&lang=ru"
  style="width: 100%; height: 360px; border: none; display: block;"
  allowfullscreen
  title="Live tracker"
></iframe>
```

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

## Полная документация по подключению

Способы встраивания, получение ключа, разрешённые домены, параметры, смена матча и
диагностика подробно описаны в [полной документации Live 3D Tracker](https://sportapi.net/ru/docs/live-3d-tracker/service-overview.html).

Демонстрация внешнего вида:
[https://bet-embed-sport-tracker-stage.vercel.app/showcase](https://bet-embed-sport-tracker-stage.vercel.app/showcase).

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

## Поле `zp`

Поле `zp` находится в объекте матча спортивной линии:

```json
{
  "game_id": 746266481,
  "sport_id": 1,
  "zp": 746266481
}
```

Значение `zp` передаётся в параметр `gameid` готового виджета:

```text
gameid трекера = zp спортивной линии
```

Для примера выше:

```js
BetZoneEmbed.init({
  container: '#zone',
  key: 'pk_live_yourkey',
  gameid: 746266481,
  sport: 1,
  lang: 'ru',
  height: 360
});
```

Не передавайте в `gameid` поля `game_id`, `game_mid` или `stat_id`. Даже если в
отдельном ответе `game_id` и `zp` имеют одинаковые числа, назначение у них разное.

## Когда показывать трекер

Виджет можно показывать только при одновременном выполнении условий:

1. Матч находится в Live.
2. Вид спорта поддерживается трекером.
3. Поле `zp` содержит ID, а не `null`.
4. У клиента есть активный ключ Live 3D Tracker.
5. Домен страницы разрешён для этого ключа.
6. Вид спорта и язык входят в подключённый тариф.

Если спортивная линия возвращает:

```json
{
  "zp": null
}
```

для этого матча трекер недоступен. Не создавайте пустой виджет и не подставляйте вместо
`zp` другой идентификатор.

## Поддерживаемые виды спорта

В параметре `sport` передаётся значение `sport_id` матча.

| ID | Вид спорта |
|---:|---|
| `1` | Футбол |
| `2` | Хоккей |
| `3` | Баскетбол |
| `4` | Теннис |
| `5` | Бейсбол |
| `6` | Волейбол |
| `7` | Регби |
| `8` | Гандбол |
| `10` | Настольный теннис |
| `13` | Американский футбол |
| `17` | Водное поло |
| `21` | Дартс |
| `26` | Формула-1 |
| `28` | Австралийский футбол |
| `44` | Скачки |
| `66` | Крикет |
| `86` | CS:GO / киберспорт |

Наличие вида спорта в таблице означает, что трекер умеет его отображать. Это не
гарантирует наличие визуализации у каждого Live-матча. Окончательная проверка всегда
выполняется по полю `zp`.

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

## Практические правила интеграции

1. Показывайте трекер только для Live-матча.
2. Проверяйте, что `sport_id` входит в список поддерживаемых видов спорта.
3. Передавайте значение `zp` как `gameid` без изменения.
4. При `zp: null` не создавайте виджет.
5. Используйте готовый `iframe` или `embed.js`, а не собственную отрисовку данных.
6. Не смешивайте `zp` с `game_id` и другими идентификаторами.
7. Для полной интеграции используйте [документацию Live 3D Tracker](https://sportapi.net/ru/docs/live-3d-tracker/service-overview.html).

## Поддержка

Для получения ключа и добавления рабочего, тестового домена или `localhost` обратитесь
в поддержку SportAPI:
[@suport_sportapi](https://t.me/suport_sportapi).

## Связанные документы

- [Модель данных: матч](../data-models/match.md)
- [`events` — список матчей](../api-reference/events.md)
- [`event` — конкретный матч](../api-reference/event.md)
- [Единый справочник полей](../data-models/field-reference.md)
