Формат ответа на получение матрицы
Ответ API содержит матрицу, закодированную форматом gzip. Перед использованием ее нужно декодировать. После декодирования матрица будет представлена в JSON-формате, описанном ниже.
Результат вычислений доступен для скачивания в течение 10 минут.
Заголовки ответа
| Заголовок | Значение |
|---|---|
| Content-Encoding | gzip |
| Content-Type | application/json |
Параметры ответа
cells-
Ячейки матрицы.
Строки матрицы
cellsсоответствуют исходным точкам.Столбцы матрицы
cellsсоответствуют конечным точкам.Каждая ячейка матрицы будет содержать пару целых чисел в формате:
[distance, duration].distanceуказывается в метрах.durationуказывается в секундах.В случае отсутствия маршрута между двумя точками, соответствующая ячейка матрицы будет содержать
[-1, -1].
Сообщения об ошибках
| Code | Description |
|---|---|
| 400 | Запрос не содержит одного или нескольких обязательных параметров. |
| 401 | Запрос не содержит параметр apikey или указан неверный ключ. |
| 429 | Превышено количество запросов. |
| 500 или 504 | Системная ошибка сервера. Повторите запрос с небольшой задержкой. |
Если при обработке запроса происходит ошибка, API возвращает сообщение с описанием ошибки в поле errors:
{"errors": ["Error with parameter \"origins\": Required"]}
{"errors": ["Key not found"]}
{"errors": ["Parameter 'apikey' is missing"]}