ממשק Image API

ממשק Image API

מבנה הבקשה

http://iiif.nli.org.il/IIIFv21/{identifier}/{region}/{size}/{rotation}/{quality}.{format}

ה-Image API הוא ממשק שמחזיר אובייקט דיגיטלי כתשובה לבקשת HTTP רגילה.

שורת הפקודה (URI) מאפשרת להגדיר כפרמטרים את האזור, הגודל, זוית סיבוב, מאפייני האיכות והפורמט של התמונה המבוקשת.

משתנה ה-region (אזור בתמונה) מאפשר להגדיר צפייה בצורה מוגדלת של חלק מהאובייקט הדיגיטלי שמוחזר למשתמש.

ה-API Image מאפשר שימוש של צד שלישי במגוון צפיינים או ממשקים התומכים בפרוטוקול IIIF וכך הוא מאפשר להציג אובייקטים דיגיטליים של הספריה הלאומית, בכל כלי חיצוני של המשתמש.

קלט

משתנה תיאור
identifier המזהה של הדף באובייקט הדיגיטלי שאליו ברצונך לגשת, שנמצא ב-Manifest API. מזהה הדף המבוקש ב-manifest מיוצג על ידי images-> @id
region האזור בתמונה שתרצו לקבל:
  • Full  -  מחזיר את התמונה בשלמותה בפלט
  • x, y, w, h - נקודות ציון להתחלה לפי פיקסלים (x, y) (מתחיל מפינה שמאלית עליונה) , וממנה גודל אזור נבחר בפיקסלים (w, h)
size מידות התמונה שתרצו לקבל (width, height)
rotation זווית סיבוב של התמונה (במעלות) בכיוון השעון (0,90,180,270). זוית סיבוב ושיקוף (תמונת מראה) של התמונה (במעלות) בכיוון השעון (0!, 90!, !180,!270)
Quality התמונה מוחזרת בצבע מלא (ברירת מחדל) או בצבע אפור (grey)
format פורמט קובץ תמונה. נכון לעכשיו, רק פורמט JPEG נתמך

הערה: שורת פקודה מלאה (URI) של ה-API Image, לגישה לאובייקט הדיגיטלי, זמין ב-Manifest בשורת הפקודה מוגדרים כבר הפרמטרים לעיל. ה-URI מאוחסן תחת: images-> resource-> @id