В этом руководстве мы рассмотрим различные варианты загрузки данных из хранилища в форматах CSV и Excel и объясним, как загрузить данные единым набором.
Весь процесс подробно показан в видеоролике ниже. Обратите внимание: в меню ролика доступны русские субтитры.
1. Для запроса к API (ИПП) и загрузки данных интересующих вас показателей можно использовать самостоятельно сформированный URL. В первом примере будут использоваться показатели HFA_74 и HFA_90.
2. Вы можете загрузить из API данные для показателя в любом из двух форматов – CSV и Excel –при помощи метода «export».
3. Например, чтобы загрузить данные в формате CSV, введите следующий запрос в адресную строку браузера:
http://dw.euro.who.int/api/v3/export?code=HFA_74,HFA_90&format=csv
Обратите внимание, что идентификаторы нужных нам показателей перечислены в запросе после параметра «code» и разделены запятой. Для того чтобы загрузить данные любых нужных вам показателей, подставьте их идентификаторы в запрос по аналогии с примером выше. В одном запросе можно запросить столько угодно идентификаторов – все они будут загружены в одном файле ZIP.
4. В файле ZIP содержится несколько файлов CSV – по одному для каждого из показателей. О параметрах, которые включаются в каждый из файлов CSV, рассказано в руководстве «Как загрузить метаданные в формате Excel».
5. Теперь рассмотрим второй вариант – загрузку данных в формате Excel. Для этого в запросе из предыдущего примера замените «csv» на «xlsx»:
http://dw.euro.who.int/api/v3/export?code=HFA_74,HFA_90&format=xlsx
6. О параметрах, которые включаются в каждый из файлов Excel, рассказано в руководстве «Как загрузить метаданные в формате Excel». Если вы не укажете требуемый формат в адресной строке браузера, то данные будут загружаться в формате Excel по умолчанию.
7. Допустим, нам необходимо загрузить все показатели, входящие в набор данных CAH. Для этого можно воспользоваться методом API “export_data_set”.
a. Чтобы загрузить данные в формате CSV, введите следующий запрос:
http://dw.euro.who.int/api/v3/export_data_set/CAH?format=csv
Получившийся файл ZIP будет содержать по одному файлу CSV на каждый из показателей набора данных CAH.
б. Чтобы загрузить показатели набора CAH в формате Excel, замените в запросе «csv» на «xlsx»:
http://dw.euro.who.int/api/v3/export_data_set/CAH?format=xlsx
В набор CAH входит свыше 40 показателей со значительным объемом данных, поэтому загрузка может занять порядка 10 минут.
8. Загруженные показатели или весь набор данных можно использовать для углубленного статистического или описательного анализа. Если в будущем вы захотите обратиться к обновленным данным по ранее загруженным показателям, просто создайте закладку в браузере.