выборка

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

Синтаксис

d = fetch(c)
d = fetch(c,QueryName1,QueryValue1,...,QueryNameN,QueryValueN)

Описание

пример

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 с этими полями:

  • состояние Состояние веб-запроса ('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 — Идентификатор конференции

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

  • 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 с этими полями:

  • состояние Состояние веб-запроса ('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 — Идентификатор конференции

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

  • 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