Version 3 (categorical & numerical types) - პერიოდული შედარების დეტალები

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

პერიოდული შედარების დეტალების მიღება

URL

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

http://data.unicef.ge/[locale]/api/v3/time_series

სადაც:

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

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

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

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

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

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

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

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

რას მიიღებთ

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

პარამეტრიაღწერა
id პერიოდული შედარების უნიკალური ID
url URL to the time series
title პერიოდული შედარების სახელწოდება
description პერიოდული შედარების აღწერა შეიძლება შეიცავდეს html-ის მონიშვნას
dates_included იმ თარიღების მასივი, რომელსაც მოიცავს პერიოდული შედარება. თარიღები შეიძლება წარმოადგენდნენ წელს, თვე/წელი, ა.შ. - ამ მნიშვნელობებისთვის რაიმე კონკრეული ფორმატი არ არსებობს.
datasets

An array of the following information for each dataset that is part of the time series:

  • dataset_id - the IF of the dataset
  • label - the label used to represet the dataset in the time series
  • title - the title of the dataset
public_at ვებ გვერდზე მონაცემების საჯაროდ გამოქვეყნების თარიღი, ფორმატი: წელი-თვე-რიცხვი (მაგ., 2015-01-31)
is_weighted Flag indicating if the time series is weighted
categories An array of the category names that have been assigned to this time series
countries An array of the country names that the time series respresents
languages იმ ენების მასივი, რომლებიც ხელმისაწვდომია ცხრილში.
default_language ენა, რომელიც გამოყენებულია ძირითად ენად.
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

მაგალითები

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

http://data.unicef.ge/en/api/v3/time_series?access_token=123456789&time_series_id=1111111111
{
  {
    id: "1111111111",
    title: "This is a time series!",
    description: "This is an amazing time series!"
    dates_included: [
      "2009",
      "2011",
      "2013"
    ],
    datasets: [
      {
        dataset_id: "1111111111",
        label: "2009",
        title: "This is a dataset!"
      },
      {
        dataset_id: "22222222222",
        label: "2011",
        title: "This is another dataset!"
      },
      {
        dataset_id: "3333333333",
        label: "2013",
        title: "This is also dataset!"
      }
    ]
    public_at: "2015-03-01"
    is_weighted: false,
    categories: [
      "Education",
      "Finance"
    ],
    countries: [
      "Georgia"
    ]
    languages:[
      "en",
      "ka"
    ],
    default_language: "en",
    license: {
      title: "Open Data License",
      description: "This is a description about the license",
      url: null
    }
  }
}