apod api
1.0.0
使用 Flask 微框架用 Python 编写的微服务。
代码经过重新组织，使其能够更轻松地在 AWS 的 Elastic Beanstalk 服务上运行。
与之前版本相比的变化是：
您可以在名为“prevCodeOrganization”的分支中找到先前代码的冻结版本
很多人使用 NASA 建立的这个 API 的实例。如果您需要此 API 的极其可靠的版本，您可能希望建立自己的 API 版本。你可以用这段代码做到这一点！该 API 返回的所有信息实际上只是从每日天文照片网站 (APOD) 中获取。
没有人观看此存储库与每日天文照片网站有任何关系，因此我们无法处理与其内容直接相关的问题。请直接联系他们。
virtualenv环境conda环境git clone https://github.com/nasa/apod-apicd进入新目录 cd apod-apilib中pip install -r requirements.txt -t liblib添加到 PYTHONPATH 并运行服务器PYTHONPATH=./lib python application.pyvirtualenv环境git clone https://github.com/nasa/apod-apicd进入新目录 cd apod-apienv python -m venv venv. v env S cripts A ctivatepip install -r requirements.txtpython application.pyconda环境git clone https://github.com/nasa/apod-apicd进入新目录 cd apod-apienv conda create --prefix ./envconda activate ./envpip install -r requirements.txtpython application.pygit clone https://github.com/nasa/apod-api.gitcd进入新目录 cd apod-apidocker build . -t apod-apidocker run -p 5000:5000 apod-api/<version>/apod此服务中只有一个端点，它采用 2 个可选字段作为 http GET 请求的参数。名义上返回一个 JSON 字典。
api_key |演示： DEMO_KEY | https://api.nasa.gov/#signUpdate YYYY-MM-DD 格式的字符串，指示 APOD 图像的日期（例如：2014-11-03）。默认为今天的日期。必须是在 1995 年 6 月 16 日之后，APOD 图片发布的第一天。没有通过此 API 提供明天的图像。concept_tags布尔值True|False指示概念标签是否应与响应的其余部分一起返回。概念标签不一定包含在解释中，而是源自与描述文本相关联的常见搜索标签。 （比纯文本搜索更好。）默认为 False。hd一个布尔值True|False参数，指示是否应返回高分辨率图像。这是为了遗留目的而存在的，它总是被服务忽略，并且无论如何都会返回高分辨率的 URL。count一个正整数，不大于 100。如果指定，则count随机选择的图像将以 JSON 数组返回。不能与date或start_date和end_date一起使用。start_date YYYY-MM-DD 格式的字符串，指示日期范围的开始时间。从start_date到end_date范围内的所有图像都将以 JSON 数组形式返回。不能与date一起使用。end_date YYYY-MM-DD 格式的字符串，指示日期范围的结束日期。如果指定start_date而没有end_date ，则end_date默认为当前日期。thumbs布尔参数True|False指示 API 是否应返回视频文件的缩略图 URL。如果设置为True ，API 将返回视频缩略图的 URL。如果 APOD 不是视频，则忽略此参数。返回字段
resource描述响应说明的image_set或planet字典，完全由结构化端点确定。concept_tags提供选项的布尔值反映。由于默认值而包含在响应中。title图像的标题。date图像的日期。由于默认值而包含在响应中。url当天 APOD 图片或视频的 URL。hdurl当天任何高分辨率图像的 URL。无论“hd”参数设置如何，都会返回，但如果 APOD 中最初不存在该参数，则在响应中将被省略。media_type返回的媒体（数据）的类型。根据内容可以是“图像”或“视频”。explanation提供的图像文本解释。concepts文本解释中最相关的概念。仅当concept_tags设置为 True 时才提供。thumbnail_url视频缩略图的 URL。copyright版权所有者的姓名。service_version使用的服务版本。例子
localhost:5000/v1/apod ? api_key=DEMO_KEY & date=2014-10-01 & concept_tags=True{
resource : {
image_set : "apod"
},
concept_tags : "True" ,
date : "2013-10-01" ,
title : "Filaments of the Vela Supernova Remnant" ,
url : "http://apod.nasa.gov/apod/image/1310/velafilaments_jadescope_960.jpg" ,
explanation : "The explosion is over but the consequences continue. About eleven
thousand years ago a star in the constellation of Vela could be seen to explode,
creating a strange point of light briefly visible to humans living near the
beginning of recorded history. The outer layers of the star crashed into the
interstellar medium, driving a shock wave that is still visible today. A roughly
spherical, expanding shock wave is visible in X-rays. The above image captures some
of that filamentary and gigantic shock in visible light. As gas flies away from the
detonated star, it decays and reacts with the interstellar medium, producing light
in many different colors and energy bands. Remaining at the center of the Vela
Supernova Remnant is a pulsar, a star as dense as nuclear matter that rotates
completely around more than ten times in a single second." ,
concepts : {
0 : "Astronomy" ,
1 : "Star" ,
2 : "Sun" ,
3 : "Milky Way" ,
4 : "Hubble Space Telescope" ,
5 : "Earth" ,
6 : "Nebula" ,
7 : "Interstellar medium"
}
}https://api.nasa.gov/planetary/apod ? api_key=DEMO_KEY & count=5[
{
"copyright" : "Panther Observatory" ,
"date" : "2006-04-15" ,
"explanation" : "In this stunning cosmic vista, galaxy M81 is on the left surrounded by blue spiral arms. On the right marked by massive gas and dust clouds, is M82. These two mammoth galaxies have been locked in gravitational combat for the past billion years. The gravity from each galaxy dramatically affects the other during each hundred million-year pass. Last go-round, M82's gravity likely raised density waves rippling around M81, resulting in the richness of M81's spiral arms. But M81 left M82 with violent star forming regions and colliding gas clouds so energetic the galaxy glows in X-rays. In a few billion years only one galaxy will remain." ,
"hdurl" : "https://apod.nasa.gov/apod/image/0604/M81_M82_schedler_c80.jpg" ,
"media_type" : "image" ,
"service_version" : "v1" ,
"title" : "Galaxy Wars: M81 versus M82" ,
"url" : "https://apod.nasa.gov/apod/image/0604/M81_M82_schedler_c25.jpg"
},
{
"date" : "2013-07-22" ,
"explanation" : "You are here. Everyone you've ever known is here. Every human who has ever lived -- is here. Pictured above is the Earth-Moon system as captured by the Cassini mission orbiting Saturn in the outer Solar System. Earth is the brighter and bluer of the two spots near the center, while the Moon is visible to its lower right. Images of Earth from Saturn were taken on Friday. Quickly released unprocessed images were released Saturday showing several streaks that are not stars but rather cosmic rays that struck the digital camera while it was taking the image. The above processed image was released earlier today. At nearly the same time, many humans on Earth were snapping their own pictures of Saturn. Note: Today's APOD has been updated." ,
"hdurl" : "https://apod.nasa.gov/apod/image/1307/earthmoon2_cassini_946.jpg" ,
"media_type" : "image" ,
"service_version" : "v1" ,
"title" : "Earth and Moon from Saturn" ,
"url" : "https://apod.nasa.gov/apod/image/1307/earthmoon2_cassini_960.jpg"
},
{
"copyright" : "Joe Orman" ,
"date" : "2000-04-06" ,
"explanation": "Rising before the Sun on February 2nd, astrophotographer Joe Orman anticipated this apparition of the bright morning star Venus near a lovely crescent Moon above a neighbor's house in suburban Phoenix, Arizona, USA. Fortunately, the alignment of bright planets and the Moon is one of the most inspiring sights in the night sky and one that is often easy to enjoy and share without any special equipment. Take tonight, for example. Those blessed with clear skies can simply step outside near sunset and view a young crescent Moon very near three bright planets in the west Jupiter, Mars, and Saturn. Jupiter will be the unmistakable brightest star near the Moon with a reddish Mars just to Jupiter's north and pale yellow Saturn directly above. Of course, these sky shows create an evocative picture but the planets and Moon just appear to be near each other -- they are actually only approximately lined up and lie in widely separated orbits. Unfortunately, next month's highly publicized alignment of planets on May 5th will be lost from view in the Sun's glare but such planetary alignments occur repeatedly and pose no danger to planet Earth.",
"hdurl" : "https://apod.nasa.gov/apod/image/0004/vm_orman_big.jpg" ,
"media_type" : "image" ,
"service_version" : "v1" ,
"title" : "Venus, Moon, and Neighbors" ,
"url" : "https://apod.nasa.gov/apod/image/0004/vm_orman.jpg"
},
{
"date" : "2014-07-12" ,
"explanation": "A new star, likely the brightest supernova in recorded human history, lit up planet Earth's sky in the year 1006 AD. The expanding debris cloud from the stellar explosion, found in the southerly constellation of Lupus, still puts on a cosmic light show across the electromagnetic spectrum. In fact, this composite view includes X-ray data in blue from the Chandra Observatory, optical data in yellowish hues, and radio image data in red. Now known as the SN 1006 supernova remnant, the debris cloud appears to be about 60 light-years across and is understood to represent the remains of a white dwarf star. Part of a binary star system, the compact white dwarf gradually captured material from its companion star. The buildup in mass finally triggered a thermonuclear explosion that destroyed the dwarf star. Because the distance to the supernova remnant is about 7,000 light-years, that explosion actually happened 7,000 years before the light reached Earth in 1006. Shockwaves in the remnant accelerate particles to extreme energies and are thought to be a source of the mysterious cosmic rays.",
"hdurl" : "https://apod.nasa.gov/apod/image/1407/sn1006c.jpg" ,
"media_type" : "image" ,
"service_version" : "v1" ,
"title" : "SN 1006 Supernova Remnant" ,
"url" : "https://apod.nasa.gov/apod/image/1407/sn1006c_c800.jpg"
},
{
"date" : "1997-01-21" ,
"explanation": "In Jules Verne's science fiction classic A Journey to the Center of the Earth, Professor Hardwigg and his fellow explorers encounter many strange and exciting wonders. What wonders lie at the center of our Galaxy? Astronomers now know of some of the bizarre objects which exist there, like vast dust clouds,r bright young stars, swirling rings of gas, and possibly even a large black hole. Much of the Galactic center region is shielded from our view in visible light by the intervening dust and gas. But it can be explored using other forms of electromagnetic radiation, like radio, infrared, X-rays, and gamma rays. This beautiful high resolution image of the Galactic center region in infrared light was made by the SPIRIT III telescope onboard the Midcourse Space Experiment. The center itself appears as a bright spot near the middle of the roughly 1x3 degree field of view, the plane of the Galaxy is vertical, and the north galactic pole is towards the right. The picture is in false color - starlight appears blue while dust is greenish grey, tending to red in the cooler areas.",
"hdurl" : "https://apod.nasa.gov/apod/image/9701/galcen_msx_big.gif" ,
"media_type" : "image" ,
"service_version" : "v1" ,
"title" : "Journey to the Center of the Galaxy rn Credit:" ,
"url" : "https://apod.nasa.gov/apod/image/9701/galcen_msx.jpg"
}
]https://api.nasa.gov/planetary/apod ? api_key=DEMO_KEY & start_date=2017-07-08 & end_date=2017-07-10[
{
"copyright" : "T. Rector" ,
"date" : "2017-07-08" ,
"explanation" : "Similar in size to large, bright spiral galaxies in our neighborhood, IC 342 is a mere 10 million light-years distant in the long-necked, northern constellation Camelopardalis. A sprawling island universe, IC 342 would otherwise be a prominent galaxy in our night sky, but it is hidden from clear view and only glimpsed through the veil of stars, gas and dust clouds along the plane of our own Milky Way galaxy. Even though IC 342's light is dimmed by intervening cosmic clouds, this sharp telescopic image traces the galaxy's own obscuring dust, blue star clusters, and glowing pink star forming regions along spiral arms that wind far from the galaxy's core. IC 342 may have undergone a recent burst of star formation activity and is close enough to have gravitationally influenced the evolution of the local group of galaxies and the Milky Way." ,
"hdurl" : "https://apod.nasa.gov/apod/image/1707/ic342_rector2048.jpg" ,
"media_type" : "image" ,
"service_version" : "v1" ,
"title" : "Hidden Galaxy IC 342" ,
"url" : "https://apod.nasa.gov/apod/image/1707/ic342_rector1024s.jpg"
},
{
"date" : "2017-07-09" ,
"explanation" : "Can you find your favorite country or city? Surprisingly, on this world-wide nightscape, city lights make this task quite possible. Human-made lights highlight particularly developed or populated areas of the Earth's surface, including the seaboards of Europe, the eastern United States, and Japan. Many large cities are located near rivers or oceans so that they can exchange goods cheaply by boat. Particularly dark areas include the central parts of South America, Africa, Asia, and Australia. The featured composite was created from images that were collected during cloud-free periods in April and October 2012 by the Suomi-NPP satellite, from a polar orbit about 824 kilometers above the surface, using its Visible Infrared Imaging Radiometer Suite (VIIRS)." ,
"hdurl" : "https://apod.nasa.gov/apod/image/1707/EarthAtNight_SuomiNPP_3600.jpg" ,
"media_type" : "image" ,
"service_version" : "v1" ,
"title" : "Earth at Night" ,
"url" : "https://apod.nasa.gov/apod/image/1707/EarthAtNight_SuomiNPP_1080.jpg"
},
{
"date" : "2017-07-10" ,
"explanation" : "What's happening around the center of this spiral galaxy? Seen in total, NGC 1512 appears to be a barred spiral galaxy -- a type of spiral that has a straight bar of stars across its center. This bar crosses an outer ring, though, a ring not seen as it surrounds the pictured region. Featured in this Hubble Space Telescope image is an inner ring -- one that itself surrounds the nucleus of the spiral. The two rings are connected not only by a bar of bright stars but by dark lanes of dust. Inside of this inner ring, dust continues to spiral right into the very center -- possibly the location of a large black hole. The rings are bright with newly formed stars which may have been triggered by the collision of NGC 1512 with its galactic neighbor, NGC 1510." ,
"hdurl" : "https://apod.nasa.gov/apod/image/1707/NGC1512_Schmidt_1342.jpg" ,
"media_type" : "image" ,
"service_version" : "v1" ,
"title" : "Spiral Galaxy NGC 1512: The Nuclear Ring" ,
"url" : "https://apod.nasa.gov/apod/image/1707/NGC1512_Schmidt_960.jpg"
}
]如果您要重新显示图像，您可能需要检查是否存在版权。任何没有版权返回字段的内容通常都是 NASA 的且属于公共领域。请参阅每日天文照片主网站上的“关于图像权限”部分了解更多信息。
APOD 解析器不是 API 本身的一部分。 rather 旨在通过 Python 快速访问 APOD API，而无需您自己编写太多额外代码。它可以在 apod_parser 文件夹中找到。
首先导入apod_object_parser.py文件。
现在使用get_data函数并将您的 API 密钥作为唯一参数传递。您可以在此处获取 API 密钥
response = apod_object_parser . get_data ( < your_api_key > ) -> apod_object_parser.get_date(response)
-> apod_object_parser.get_explaination(response)
-> apod_object_parser.get_hdurl(response)
-> apod_object_parser.get_media_type(response)
-> apod_object_parser.get_service_version(response)
-> apod_object_parser.get_title(response)
-> apod_object_parser.get_url(response)
有关完整文档和更多功能，请单击此处访问 apod 解析器的自述文件
该API的部署版本基于eb分支。之前部署的版本位于eb_previous分支中。 master分支用作开发，因为无论如何，大多数拉取请求都会进入主分支。
由于使用该服务的人数较多，因此该 API 使用 Elastic beanstalk 部署在 AWS 上。但是，如果您打算自己使用它，它足够小，可以安装在单个微型 EC2 或任何其他小型云计算机上。
如果您发现此存储库有用，请为其加注星标。使用 github 问题跟踪器提供有关此存储库的反馈。
我们确实接受公众的拉取请求。请注意，我们的回复可能会很慢。请耐心等待。
而且，拥有该存储库权限的人并不是能够调试 APOD 网站本身问题的人。如果您愿意做出贡献，现在我们可以对测试进行一些关注。
