apod api
1.0.0
خدمة صغيرة مكتوبة بلغة بايثون مع إطار عمل Flask الصغير.
تمت إعادة تنظيم التعليمات البرمجية لجعلها تعمل بسهولة أكبر على خدمة Elastic Beanstalk من AWS.
التغييرات على الإصدار السابق كانت:
يمكنك العثور على نسخة مجمدة من الكود السابق في الفرع المسمى "prevCodeOrganization"
يستخدم عدد كبير جدًا من الأشخاص مثيل واجهة برمجة التطبيقات (API) التي أنشأتها وكالة ناسا. إذا كنت بحاجة إلى إصدار موثوق للغاية من واجهة برمجة التطبيقات هذه، فمن المرجح أنك تريد دعم الإصدار الخاص بك من واجهة برمجة التطبيقات. يمكنك فعل ذلك بهذا الكود! يتم في الواقع الحصول على جميع المعلومات التي تُرجعها واجهة برمجة التطبيقات هذه من موقع الويب الخاص بعلم الفلك لصورة اليوم (APOD).
لا أحد يشاهد هذا المستودع له أي علاقة بموقع Astronomy Photo of the Day، لذلك لا يمكننا التعامل مع المشكلات المتعلقة مباشرة بمحتواه. يرجى الاتصال بهم مباشرة.
virtualenvcondagit clone https://github.com/nasa/apod-apicd في الدليل الجديد cd apod-apilib المشروع pip install -r requirements.txt -t liblib إلى PYTHONPATH الخاص بك وقم بتشغيل الخادم PYTHONPATH=./lib python application.pyvirtualenvgit 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.pycondagit 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توجد نقطة نهاية واحدة فقط في هذه الخدمة والتي تأخذ حقلين اختياريين كمعلمات لطلب http GET. يتم إرجاع قاموس JSON اسميًا.
api_key | العرض التوضيحي: DEMO_KEY | https://api.nasa.gov/#signUpdate سلسلة بتنسيق YYYY-MM-DD تشير إلى تاريخ صورة APOD (مثال: 2014-11-03). الافتراضيات لتاريخ اليوم. يجب أن يكون بعد 16 يونيو 1995، وهو اليوم الأول الذي تم فيه نشر صورة APOD. لا توجد صور متاحة للغد من خلال واجهة برمجة التطبيقات هذه.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 عنوان URL لصورة أو مقطع فيديو APOD لهذا اليوم.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"
}
]إذا كنت تقوم بإعادة عرض الصور، فقد تحتاج إلى التحقق من وجود حقوق الطبع والنشر. أي شيء بدون حق إرجاع حقوق الطبع والنشر هو بشكل عام لوكالة ناسا وفي الملكية العامة. يرجى الاطلاع على قسم "حول أذونات الصورة" على الموقع الرئيسي لعلم الفلك لهذا اليوم لمزيد من المعلومات.
لا يعد محلل APOD جزءًا من واجهة برمجة التطبيقات نفسها. بدلاً من ذلك، تم تصميمه ليتم استخدامه للوصول إلى APOD API بسرعة باستخدام Python دون كتابة الكثير من التعليمات البرمجية الإضافية بنفسك. تم العثور عليه في المجلد 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 كتطوير حيث ستأتي معظم طلبات السحب على أي حال.
يتم نشر واجهة برمجة التطبيقات هذه على AWS باستخدام شجرة الفاصولياء المرنة نظرًا لوجود عدد كبير من الأشخاص الذين يستخدمون الخدمة. ومع ذلك، إذا كنت تخطط لاستخدامه بنفسك، فهو صغير بما يكفي ليتم وضعه على جهاز micro EC2 واحد أو أي جهاز حوسبة سحابية صغير الحجم آخر.
قم بتمييز هذا الريبو بنجمة إذا وجدت أنه مفيد. استخدم أداة تعقب المشكلات github لتقديم تعليقات حول هذا الريبو.
نحن نقبل طلبات السحب من الجمهور. يرجى ملاحظة أننا يمكن أن نكون بطيئين في الاستجابة. يرجى التحلي بالصبر.
كما أن الأشخاص الذين يتمتعون بحقوق في هذا المستودع ليسوا أشخاصًا يمكنهم تصحيح الأخطاء في موقع APOD نفسه . إذا كنت ترغب في المساهمة، يمكننا الآن الاستفادة من بعض الاهتمام بالاختبارات.
