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

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

3. Alexandria Digital Library Project 3 Greg Janée NKOS workshop on digital gazetteers, JCDL 2002 July 18, 2002 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

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

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

6. Alexandria Digital Library Project 6 Greg Janée NKOS workshop on digital gazetteers, JCDL 2002 July 18, 2002 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, ArcXML, …) negotiable o download( report format [, geometry language ])  reports  downloads entire gazetteer o add-entry( report )  identifier o relate-entries( relationship, identifier 1, identifier 2 ) o remove-entry( identifier )

7. Alexandria Digital Library Project 7 Greg Janée NKOS workshop on digital gazetteers, JCDL 2002 July 18, 2002 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

8. Alexandria Digital Library Project 8 Greg Janée NKOS workshop on digital gazetteers, JCDL 2002 July 18, 2002 Relationships… o PartOf  AdministrativePartOf –AdministrativePartitionMemberOf –AdministrativeSeatOf –ConventionallyQualifiedBy  SubfeatureOf –GeophysicalPartitionMemberOf o PhysicallyConnectedTo  FlowsInto

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

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

11. Alexandria Digital Library Project 11 Greg Janée NKOS workshop on digital gazetteers, JCDL 2002 July 18, 2002 Services o get-properties()  properties o 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

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

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