fetch

Получите данные под эгидой STATS.com

Описание

пример

d = fetch(c) возвращает данные STATS.com с помощью связи STATS.com c.

пример

d = fetch(c,QueryName1,QueryValue1,...,QueryNameN,QueryValueN) возвращает параметры запроса веб-сервиса использования данных STATS.com, как задано одним или несколькими аргументами пары "имя-значение". Веб-сервис STATS.com задает параметры запроса. Для параметров запроса см. Документы ввода-вывода Центра разработки STATS.

Примеры

свернуть все

Соединитесь с STATS.com с помощью ключа API и секретного кода передачи. Задайте статистические данные о позициях для баскетбольных команд в спортивной лиге под названием 'nba' использование параметров запроса.

apikey = 'gkfrq6fabcfehmn2yctrc6j5';
secret = 'aBC5cuBQgc';

sBasketball = statsllc(apikey,secret, ...
    'DataType','stats','LeagueAbbreviation','nba', ...
    'Resource','standings','SportName','basketball', ...
    'VersionNumber','v1');

sBasketball объект связи STATS.com. Для каждого свойства объекта смотрите statsllc.

Получите данные баскетбольной команды с помощью связи STATS.com sBasketball.

d = fetch(sBasketball)
d = 

  struct with fields:

            status: 'OK'
       recordCount: 30
    startTimestamp: '2016-04-19T18:37:36.0745302Z'
      endTimestamp: '2016-04-19T18:37:36.9026552Z'
         timeTaken: 0.8281
        apiResults: [1×1 struct]

Запрос возвращает структуру d с этими полями:

  • status — Состояние веб-запроса ('OK' обозначает успешный веб-запрос),

  • recordCount — Количество записей возвращено

  • startTimestamp — Дата начала и время веб-запроса

  • endTimestamp — Дата окончания и время веб-запроса

  • timeTaken — Количество времени, занятое для веб-запроса, чтобы завершиться в секундах

  • apiResults — Возвращенные данные

Получите данные баскетбольной команды f для второй конференции в массиве структур.

f = d.apiResults.league.season.eventType.conferences(2)
f = 

  struct with fields:

    conferenceId: 2
            name: 'Western Conference'
    abbreviation: 'Western'
       divisions: [3×1 struct]

f структура с этими полями:

  • conferenceId — Идентификатор конференции

  • name — Имя конференции

  • abbreviation — Сокращение конференции

  • divisions — Деления на конференции

Получите идентификаторы команды в первом дивизионе в массиве структур divisions.

f.divisions(1).teams.teamId
ans =

     9

ans =

    12
...

Соединитесь с STATS.com с помощью ключа API и секретного кода передачи. Задайте статистические данные о позициях для баскетбольных команд в спортивной лиге под названием 'nba' использование параметров запроса.

apikey = 'gkfrq6fabcfehmn2yctrc6j5';
secret = 'aBC5cuBQgc';

sBasketball = statsllc(apikey,secret, ...
    'DataType','stats','LeagueAbbreviation','nba', ...
    'Resource','standings','SportName','basketball', ...
    'VersionNumber','v1');

sBasketball объект связи STATS.com. Для каждого свойства объекта смотрите statsllc.

Получите данные баскетбольной команды с помощью связи STATS.com sBasketball в течение 2 015 сезонов.

d = fetch(sBasketball,'season','2015')
d = 

  struct with fields:

            status: 'OK'
       recordCount: 30
    startTimestamp: '2016-04-19T18:37:36.0745302Z'
      endTimestamp: '2016-04-19T18:37:36.9026552Z'
         timeTaken: 0.8281
        apiResults: [1×1 struct]

Запрос возвращает структуру d с этими полями:

  • status — Состояние веб-запроса ('OK' обозначает успешный веб-запрос),

  • recordCount — Количество записей возвращено

  • startTimestamp — Дата начала и время веб-запроса

  • endTimestamp — Дата окончания и время веб-запроса

  • timeTaken — Количество времени, занятое для веб-запроса, чтобы завершиться в секундах

  • apiResults — Возвращенные данные

Получите данные баскетбольной команды f для второй конференции в массиве структур.

f = d.apiResults.league.season.eventType.conferences(2)
f = 

  struct with fields:

    conferenceId: 2
            name: 'Western Conference'
    abbreviation: 'Western'
       divisions: [3×1 struct]

f структура с этими полями:

  • conferenceId — Идентификатор конференции

  • name — Имя конференции

  • abbreviation — Сокращение конференции

  • divisions — Деления на конференции

Получите идентификаторы команды в первом дивизионе в массиве структур divisions.

f.divisions(1).teams.teamId
ans =

     9

ans =

    12
...

Входные параметры

свернуть все

Связь STATS.com в виде statsllc объект.

Параметры запроса веб-сервиса в виде одной или нескольких пар аргументов значения имени. QueryName аргумент является вектором символов или строковым скаляром, который задает имя параметра запроса. QueryValue аргумент является вектором символов или строковым скаляром, который задает значение параметра запроса.

Веб-сервис задает пары "имя-значение", которые он принимает как часть запроса. Для допустимых пар "имя-значение" см. Документы ввода-вывода Центра разработки STATS. Чтобы понять, к каким парам "имя-значение" у вас есть доступ, свяжитесь с STATS.com.

Пары "имя-значение" для этой функции отличаются от пар "имя-значение", заданных в statsllc. Для получения дополнительной информации о различиях, свяжитесь с STATS.com.

Пример: 'season','2015' получает данные в течение 2 015 сезонов.

Типы данных: char | string

Выходные аргументы

свернуть все

Данные STATS.com, возвращенные как структура с этими полями:

Поле структуры данных STATS.comОписание
status

Состояние веб-запроса ('OK' обозначает успешный веб-запрос),

recordCount

Количество записей возвращено

startTimestamp

Дата начала и время веб-запроса

endTimestamp

Дата окончания и время веб-запроса

timeTaken

Номер секунд, чтобы завершить веб-запрос

apiResults

Возвращенные данные

Чтобы получить индивидуума или команду спортивные данные, получите доступ к полю apiResults в структуре. Например, введите:

d.apiResults
ans = 

  struct with fields:

    sportId: 1
       name: 'Basketball'
     league: [1×1 struct]

Для большего количества данных продолжите получать доступ к полям структуры, которые содержат дальнейшие данные. Для доступа к вложенным структурам см. Доступ к данным во Вложенных Структурах (MATLAB).

Введенный в R2017b

Для просмотра документации необходимо авторизоваться на сайте