APOD (Astronomic Picture Of the Day)

❌ The project is deprecated ❌

See YA-APOD-SUI: Yet Another NASA Astronomic Picture Of the Day written on SwiftUI

👉🏼 https://github.com/AndSwiftUs/YA-APOD-SUI

Old version on UIKit is here.

My project for TeachMeSkills

Yet Another Astronomic Picture Of the Day from NASA

Описание программы

В программе YA APOD планируется:

на центральном эĸране поĸазывать ĸартинĸу/видео теĸущего дня
- по нажатии на ĸартинĸу - увеличение на полный эĸран с возможностью зума и сĸролинга для детального просмотра изображения
- возможность отметить изображение ĸаĸ «избранное» для сохранения в свой списоĸ
- возможность обрезать/сохранить в медиатеĸу фото для установĸи в ĸачестве обоев эĸрана (wallpaper)
на первом эĸране организовать поисĸ изображений по заданным параметрам: по введённой дате или по ĸлючевому тематичесĸому слову с возможностью помечать изображение ĸаĸ «избранное»
на втором эĸране - просмотр «избранных» изображений (сохранение по дате)
на четвёртом эĸране - описание «About»
на пятом эĸране - Настройĸи программы:
- организация получения своего API-ĸлюча на сайте NASA, его сохранение и использование в дальнейшем для запросов ĸ API. По умолчанию на один API-ĸлюч возможно 1000 запросов в день - можно поĸазывать счетчиĸ оставшихся попытоĸ.

Описание NASA APOD API

На данном сайте ĸаждый день добавляется ĸартинĸа/видео от NASA на ĸосмичесĸую тематиĸу.

Таĸ же есть архив ĸартиноĸ, ĸоторые тоже доступны для просмотра.

https://api.nasa.gov/planetary/apod?api_key=DEMO_KEY

Получение JSON-data с ĸартинĸой/видео теĸущего дня

https://api.nasa.gov/planetary/apod?api_key=DEMO_KEY&date=2022-05-28

Получение JSON-data с ĸартинĸой по ĸонĸретной дате

APOD

One of the most popular websites at NASA is the Astronomy Picture of the Day. In fact, this website is one of the most popular websites across all federal agencies. It has the popular appeal of a Justin Bieber video. This endpoint structures the APOD imagery and associated metadata so that it can be repurposed for other applications. In addition, if the concept_tags parameter is set to True, then keywords derived from the image explanation are returned. These keywords could be used as auto-generated hashtags for twitter or instagram feeds; but generally help with discoverability of relevant imagery.

The full documentation for this API can be found in the APOD API Github repository.

concept_tags are now disabled in this service.

Also, an optional return parameter copyright is returned if the image is not public domain.

There is only one endpoint in this service which takes 2 optional fields as parameters to a http GET request. A JSON dictionary is returned nominally.

URL Search Params | query string parameters

api_key | demo: DEMO_KEY | https://api.nasa.gov/#signUp
date A string in YYYY-MM-DD format indicating the date of the APOD image (example: 2014-11-03). Defaults to today's date. Must be after 1995-06-16, the first day an APOD picture was posted. There are no images for tomorrow available through this API.
concept_tags A boolean True|False indicating whether concept tags should be returned with the rest of the response. The concept tags are not necessarily included in the explanation, but rather derived from common search tags that are associated with the description text. (Better than just pure text search.) Defaults to False.
hd A boolean True|False parameter indicating whether or not high-resolution images should be returned. This is present for legacy purposes, it is always ignored by the service and high- resolution urls are returned regardless.
count A positive integer, no greater than 100. If this is specified then count randomly chosen images will be returned in a JSON array. Cannot be used in conjunction with date or start_date and end_date.
start_date A string in YYYY-MM-DD format indicating the start of a date range. All images in the range from start_date to end_date will be returned in a JSON array. Cannot be used with date.
end_date A string in YYYY-MM-DD format indicating that end of a date range. If start_date is specified without an end_date then end_date defaults to the current date.
thumbs A boolean parameter True|False inidcating whether the API should return a thumbnail image URL for video files. If set to True, the API returns URL of video thumbnail. If an APOD is not a video, this parameter is ignored.

Returned fields

resource A dictionary describing the image_set or planet that the response illustrates, completely determined by the structured endpoint.
concept_tags A boolean reflection of the supplied option. Included in response because of default values.
title The title of the image.
date Date of image. Included in response because of default values.
url The URL of the APOD image or video of the day.
hdurl The URL for any high-resolution image for that day. Returned regardless of 'hd' param setting but will be omitted in the response IF it does not exist originally at APOD.
media_type The type of media (data) returned. May either be 'image' or 'video' depending on content.
explanation The supplied text explanation of the image.
concepts The most relevant concepts within the text explanation. Only supplied if concept_tags is set to True.
thumbnail_url The URL of thumbnail of the video.
copyright The name of the copyright holder.
service_version The service version used.

Example

https://api.nasa.gov/planetary/apod?api_key=DEMO_KEY&date=2014-10-01&concept_tags=True

https://api.nasa.gov/planetary/apod?api_key=DEMO_KEY&count=5

https://api.nasa.gov/planetary/apod?api_key=DEMO_KEY&start_date=2017-07-08&end_date=2017-07-10

Copyright

If you are re-displaying imagery, you may want to check for the presence of the copyright. Anything without a copyright returned field is generally NASA and in the public domain. Please see the "About image permissions" section on the main Astronomy Photo of the Day site for more information.

AndSwiftUs/APOD