Получение транспорта
Отображаем самокаты на карте
Теперь, когда мы показали пользователю на карте где он может кататься и завершать поездки, самое время показать ему самокаты, доступные к аренде. Для этого существует два способа:
- Получение транспорта в “радиусе видимости” от определенной точки на карте. В качестве такой точки обычно служит широта-долгота центра экрана пользователя, а “радиус видимости” составляет 500 метров (настраивается в конфигурациях на стороне Юрент).
- Получение всех самокатов в зоне аренды.
Мы не рекомендуем отображать пользователю все самокаты в городе (по зоне аренды), так как для пользователя это не несет никакой ценности, но при этом нагружает приложение. Вряд ли пользователь поедет туда, где есть самокаты. Скорее наоборот — он будет искать самокаты там, куда планирует поехать.
Получение информации об отдельном самокате
В интерфейсе приложения для аренды самокатов обычно существует возможность выбрать понравившейся самокат и получить о нем подробную информацию, прежде чем начать аренду. Эта информация отображается на карточке самоката.
Открыть карточку самоката обычно можно следующими способами:
- Отсканировать QR-код на руле самоката с помощью сканера внутри приложения или камерой смартфона. Этот способ идентификации самоката является самым частотным, реализовать его следует в первую очередь.
- Ввести номер самоката вручную в специальное поле поиска внутри приложения;
- Тапнуть на самокат на карте.
Во всех этих случаях мы получаем идентификатор самоката в формате [S.XXXXXX] и используем его в запросе {шлюз}/api/v1/Transports/transport_multi/{identifier}
В ответ получаем довольно обширную информацию о самокате:
| Поле | Значение |
|---|---|
| "lockType" | Тип замка. Понадобится для реализации открытия и закрытия самокатов |
| "identifier" | ID самоката |
| "modelId" | ID модели |
| "modelName" | Название модели самоката |
| "modelImgUrl" | Ссылка на фотографию модели самоката |
| "insideEndZones" | ID города и ID Тарифной Зоны |
| "insideUseZones" | ID Тарифной Зоны |
| "state" | Статус самоката доступен ли он |
| "charge" | "batteryPercent” — заряд батареи, используемый внутри платформы "customerPercent” — заряд батареи, для отображению пользователю. Показываем заряд немного меньше настоящего, чтобы не разряжать самокаты в 0. "remainKm” — оставшееся число километров "batteryForActiveInHours” — оставшееся число минут |
| "insideParkings" | Парковка, на которой находится самокат |
| "trialOrderingsCount" | Количество заказов |
| "rates" | Тарифы, доступные по этому самокату |
| "legalEntity" | Принадлежность самоката (в том числе ИНН) |