Alexandria Digital Library Project The ADL Gazetteer Thesaurus

Alexandria Digital Library Project The ADL Gazetteer & Thesaurus Service Protocols Greg Janée gjanee@alexandria. ucsb. edu

Alexandria Digital Library Project Outline o o Motivation ADL Gazetteer Protocol § model, services, query language, relationships o ADL Thesaurus Protocol § model, services o Summary Greg Janée • NKOS workshop on digital gazetteers, JCDL 2002 • July 18, 2002 2

Alexandria Digital Library Project Motivation o Gazetteer § more a service than a collection § streamlined, customized for gazetteers o Thesaurus § referenced by gazetteers and DLs o Style § lightweight protocols § buzzword-compliant Greg Janée • NKOS workshop on digital gazetteers, JCDL 2002 • July 18, 2002 3

Alexandria Digital Library Project Gazetteer model identifier adlgaz-1 -6450449 -20 names* * may be qualified as “place” footprints* Willbridge North Portland thesaurus reference feature classes* populated places primary and/or historical Multnomah County extended • • • <? xml. . . relationships Administrative. Part. Of Conventionally. Qualified. By Greg Janée • NKOS workshop on digital gazetteers, JCDL 2002 • July 18, 2002 Oregon • • • 4

Alexandria Digital Library Project Service characteristics o o Stateless, independent, synchronous, optional SOAP-like, XML-over-HTTP formulation § HTTP POST to common URL o Access control not addressed Greg Janée • NKOS workshop on digital gazetteers, JCDL 2002 • July 18, 2002 5

Alexandria Digital Library Project Services o get-capabilities() capabilities description § what thesauri, services, query types, etc. , are supported o query(query, report format [, geometry lang]) reports § returns all entries that match a query § two report formats: standard, extended § geometry language (GML, Arc. XML, …) negotiable o download(report format [, geometry language]) reports § downloads entire gazetteer o o o add-entry(report) identifier relate-entries(relationship, identifier 1, identifier 2) remove-entry(identifier) Greg Janée • NKOS workshop on digital gazetteers, JCDL 2002 • July 18, 2002 6

Alexandria Digital Library Project Query language o Constraint types § identifier – find gazetteer entry #314159 § name – find placenames containing the phrase “San Diego” § footprint – find everything that overlaps a given region § class – find all cemeteries § relationship – find the capital of California o Booleans: AND, OR, AND NOT Greg Janée • NKOS workshop on digital gazetteers, JCDL 2002 • July 18, 2002 7

Alexandria Digital Library Project Relationships… o Part. Of § Administrative. Part. Of – Administrative. Partition. Member. Of – Administrative. Seat. Of – Conventionally. Qualified. By § Subfeature. Of – Geophysical. Partition. Member. Of o Physically. Connected. To § Flows. Into Greg Janée • NKOS workshop on digital gazetteers, JCDL 2002 • July 18, 2002 8

Alexandria Digital Library Project Relationships… and the protocol o Two semantically equivalent constraints § find place spatially within another place § find place Part. Of another place o o Behavior depends on implementation Mandate equivalence? Greg Janée • NKOS workshop on digital gazetteers, JCDL 2002 • July 18, 2002 9

Alexandria Digital Library Project Thesaurus model hydrographic structures BT/NT “concept” locks RT name extended canals <? xml. . . UF log rides USE (+) preferred: notes amusement park rides Manmade waterway. . . BT/NT freshwater canals Greg Janée • NKOS workshop on digital gazetteers, JCDL 2002 • July 18, 2002 10

Alexandria Digital Library Project Services o o get-properties() properties download(include-nonpreferred, format) list § returns list of terms § three formats: brief, standard, extended o query(operator, text, fuzzy, format) list § against term names § matching: word-based, equality, regular expression o get-broader(start-term, max-levels, format) hierarchy § returns DAG of terms o get-narrower([start-term, ] max-levels, fmt) hierarchy § null start term yields whole thesaurus Greg Janée • NKOS workshop on digital gazetteers, JCDL 2002 • July 18, 2002 11

Alexandria Digital Library Project Issues o o Identifiers Multilingual thesauri Greg Janée • NKOS workshop on digital gazetteers, JCDL 2002 • July 18, 2002 12

Alexandria Digital Library Project Summary o ADL Gazetteer & Thesaurus Protocols § lightweight, stateless, complementary § based on XML, HTTP o Reference servers § generic, open source, J 2 EE-based § gazetteer server: maps to JDBC/SQL § thesaurus server: imports Multi. Tes o For more information § http: //www. alexandria. ucsb. edu/gazetteer/protocol § http: //www. alexandria. ucsb. edu/thesaurus/protocol Greg Janée • NKOS workshop on digital gazetteers, JCDL 2002 • July 18, 2002 13