Примеры

Примеры запросов в этом документе представлены с использованием CLI-утилиты curl.

Отправить запрос для инициирования генерации матрицы

curl -X POST 'https://api.routing.yandex.net/v2/distancematrix_async/driving/matrices/generate?apikey=YOUR_API_KEY' \
    -H 'Content-Type: application/json'
    -d '{"origins":[[37.540775,55.886412],[37.509132,55.825264],[37.484335,55.826820],[37.722153,55.721870],[37.468273,55.676837]],"destinations":[[37.619979,55.676799],[37.646084,55.826680],[37.661889,55.671596],[37.640079,55.780732],[37.494420,55.762688],[37.656392,55.874199]]}'

Пример ответа

{
  "id": "abc-012345",
  "done": false
}

Получить статус выполнения операции

Используйте идентификатор операции из ответа на предыдущий запрос.

curl 'https://api.routing.yandex.net/v2/distancematrix_async/driving/operations/get?apikey=YOUR_API_KEY&id=OPERATION_ID'

Пример ответа когда операция еще выполняется

{
  "id": "abc-012345",
  "done": false
}

Пример ответа когда операция завершена успешно

{
  "id": "abc-012345",
  "done": true,
  "response": {
    "matrixId": "7335312_8ad6-b4a6"
  }
}

Пример ответа когда операция завершена с ошибкой

{
  "id": "abc-012345",
  "done": true,
  "error": {
    "code": 500,
    "message": "Internal Server Error"
  }
}

Получить результирующую матрицу

Используйте идентификатор матрицы из ответа на предыдущий запрос.

Обратите внимание, что тело ответа для этого запроса закодировано в формате gzip. Для просмотра декодированного содержимого можно воспользоваться CLI-утилитой gunzip.

curl 'https://api.routing.yandex.net/v2/distancematrix_async/driving/matrices/get?apikey=YOUR_API_KEY&id=MATRIX_ID' | gunzip

Пример ответа

{
  "cells": [
    [ [36100, 6966], [26075, 5232], [44059, 8404], [28426, 5700], [29732, 5960], [31785, 6368]],
    [ [34422, 6633], [24398, 4898], [42381, 8072], [26748, 5366], [28055, 5626], [30524, 6117]],
    [ [36845, 5831], [25164, 5051], [42464, 7096], [27515, 5519], [1586, 325], [37445, 7492]],
    [ [15570, 1925], [25146, 4101], [13327, 2681], [20942, 3262], [51957, 7639], [20934, 3613]],
    [ [32949, 5056], [31305, 6272], [38568, 6322], [33656, 6739], [10300, 2082], [43586, 8709]]
  ]
}