Version 2 (groups & weights) - მონაცემების დეტალები

გამოქვეყნებულია: 25 იანვ 2016ბოლო განახლება: 26 იანვ 2016

მონაცემების შესახებ დეტალების მიღება

URL

ამ მეთოდის გამოძახებისთვის გამოიყენეთ HTTP GET მოთხოვნა შემდეგი URL-სთვის:

http://data.unicef.ge/[locale]/api/v2/dataset

სადაც:

  • [locale] = ენა, რომელშიც გსურთ მონაცემების მიღება (ამ დროისთვის ka ქართულად ან en ინგლისურად)

 

აუილებელი პარამეტრები

მოთხოვნა უნდა შეიცავდეს შემდეგ პარამეტრებს:

პარამეტრიაღწერა
access_token ყველა მოთხოვნა უნდა შეიცავდეს დაშვების გასაღებს. თქვენ მარტივად და უფასოდ შეგიძლიათ მიიღოთ დაშვების გასაღები აქ გადასვლით.
dataset_id მონაცემების ID.

 

არჩევით პარამეტრები

მოთხოვნისთვის შემდეგი პარამეტრები არის არჩევითი.

პარამეტრიაღწერა
language

კოდი ენისთვის, რომელშიც დაბრუნდება მონაცემებზე ინფორმაცია (მაგ. en ინგლისური ენისთვის). იმ შემთხვევაში, თუ language არ არის მოცემული, ცხრილისთვის გამოყენებული იქნება ძირითადი ენა.

რას მიიღებთ

დაბრუნებული ობიექტი არის JSON ცხრილის ობიექტი შემდეგი ინფრომაციით:

პარამეტრიაღწერა
id მონაცემების უნიკალური ID
url URL to the dataset
title მონაცემების სახელწოდება
description მონაცემთა აღწერა შეიძლება შეიცავდეს html-ის კოდს
source იმ წყაროს დასახელება, რომელმაც შეაგროვა მონაცემები
source_url იმ წყაროს URL, რომელმაც შეაგროვა მონაცემები.
donor Person(s) or organization(s) that funded the data collection
start_gathered_at მონაცემების შეგროვების საწყისი თარიღი, ფორმატი: წელი-თვე-რიცხვი (მაგ., 2015-01-31)
end_gathered_at მონაცემების შეგროვების დასრულების თარიღი, ფორმატი: წელი-თვე-რიცხვი (მაგ., 2015-01-31)
released_at წყაროს მიერ მონაცემების საჯაროდ გამოქვეყნების თარიღი, ფორმატი: წელი-თვე-რიცხვი (მაგ., 2015-01-31)
public_at ვებგვერდზე მონაცემების საჯაროდ გამოქვეყნების თარიღი, ფორმატი: წელი-თვე-რიცხვი (მაგ., 2015-01-31)
total_responses Number of responses in the datasets
analyzable_questions Number of questions the dataset has that can be analyzed
is_weighted Flag indicating if the dataset is weighted
is_mappable ბულის ალამი, რომელიც მიუთითებს, აქვს თუ არა მონაცემებს ერთი შეკითხვა მაინც, რომელიც მიბმულია რუკის ფორმებთან
categories An array of the category names that have been assigned to this dataset
countries An array of the country names that the dataset respresents
languages ენების მასივი, რომლებიც გვხვდება ამ მონაცემებში
default_language ენა, რომელიც გამოყენებულია ძირითად ენად
methodology მეთოდი, რომლითაც მონაცემები შეგროვდა, შეიძლება შეიცავდეს html კოდს
license

An object with the following values:

  • title - the title of the license
  • description - a brief description of the license
  • url - a URL that contains more information about the license
reports

An array of reports that have been written based on the dataset:

  • title - the title of the report
  • summary - a brief summary of the report
  • language - the language the report is written in
  • released_at - the date the report was released to the public
  • file_type - the format of the file (i.e., PDF)
  • url - the URL to the report

მაგალითები

მაგალითისთვის მოცემულია, თუ რა შეიძლება დაბრუნდეს ამ მეთოდის გამოძახების შემდეგ მოცემული url-ის გამოყენებით:

http://data.unicef.ge/en/api/v2/dataset?access_token=123456789&dataset_id=1111111111
{
  {
    id: "1111111111",
    url: "http://data.unicef.ge/en/datasets/dataset1",
    title: "This is a dataset!",
    source: "People",
    start_gathered_at: "2014-04-01",
    end_gathered_at: "2014-06-30",
    released_at: "2015-01-01",
    public_at: "2015-03-01",
    total_responses: 453,
    analyzable_questions: 345,
    is_weighted: false,
    is_mappable: false,
    categories: [
      "Education"
    ],
    countries: [
      "Georgia"
    ]
    languages:[
      "en",
      "ka"
    ],
    default_language: "en",
    methodology: "This data was gathered from by asking people questions!",
    license:{
      title: "Open Data License",
      description: "This is a description about the license",
      url: null,
    }
    reports:[
      {
        title: ,
        summary: ,
        language: "English",
        released_at: "2015-01-01",
        file_type: "PDF",
        url: "http://data.unicef.ge/system/datasets/1111111111/reports/this_is_a_report.pdf"
      }
    ]
  }
}