LoCloud - D3.2: Geocoding Enrichment Services

Download LoCloud - D3.2: Geocoding Enrichment Services

Post on 26-May-2015

237 views

Category:

Technology

3 download

DESCRIPTION

This is one of 7 reports provided in work package 3: Micro services for small and medium institutions.

TRANSCRIPT

1. Local content in a Europeana cloudD3.2: Geocoding Enrichment Services Geolocation API (LoGeo API) Geocoding applicationAuthors:Franc J.Zakrajsek, IPCHSVlasta Vodeb, UIRSJurij Stare and Andrej Grilc, GrangeoStein Runar Bergheim, Asplan Viak Internet AS (AVINET)LoCloud is funded by the European CommissionsICT Policy Support ProgrammeVersion: 1.0 2. RevisionHistoryRevisionDateAuthorOrganisationDescription0.003.02.2014FrancJ.ZakrajsekIPCHSDraft0.119.08.2014FrancJ.ZakrajsekVlastaVodebJurijStareAndrejGrilcIPCHSUIRSGrangeoGrangeoCompletesectionongeocodingAPI0.222.08.2014S.R.BergheimAVINETIncorporatedgeocodingtooldocumentation0.326.08.2014FrancJ.ZakrajsekVlastaVodebJurijStareAndrejGrilcS.R.BergheimIPCHSUIRSGrangeoGrangeoAVINETForinternalreview0.428.08.2014FrancJ.ZakrajsekVlastaVodebJurijStareAndrejGrilcS.R.BergheimIPCHSUIRSGrangeoGrangeoAVINETReviseddraft,completeforinternalreview1.003.09.2014FrancJ.ZakrajsekS.R.BergheimIPCHSAVINETFinalVersion1WView the LoCloud project deliverablesStatementoforiginality:Thisdeliverablecontainsoriginalunpublishedworkexceptwhereclearlyindicatedotherwise.Acknowledgementofpreviouslypublishedmaterialandoftheworkofothershasbeenmadethroughappropriatecitation,quotationorboth.LoCloudD3.2GeolocationEnrichmentServices2 3. Contents1.ExecutiveSummary.................................................................................................................42.Introduction............................................................................................................................5Overviewofgeolocationenrichmenttools..............................................................................................5Overviewofthedevelopmentmethodology...........................................................................................63.Gettingstarted.......................................................................................................................9GeolocationAPI......................................................................................................................................9Geocodingapplication..........................................................................................................................104.GeolocationAPIreference.....................................................................................................12Request.................................................................................................................................................12Response..............................................................................................................................................13HTMLStatusCodes...............................................................................................................................14InvokingthegeolocationAPIprogrammatrically...................................................................................155.Geocodingapplicationuserdocumentation..........................................................................17Overviewoftheuserinterface..............................................................................................................17Executingageocodingproject,stepbystep..........................................................................................186.Howtoinstallthegeolocationenrichmenttools...................................................................32GeolocationAPI....................................................................................................................................32Geocodingapplication..........................................................................................................................327.HowthethetoolsareinstalledinLoCloud............................................................................34GeolocationAPI....................................................................................................................................34Geocodingapplication..........................................................................................................................348.References............................................................................................................................359.Glossary................................................................................................................................37LoCloudD3.2GeolocationEnrichmentServices3 4. 1. ExecutiveSummaryGeolocationisanimportantpieceofinformationthatmakesitpossibletofacilitatebothsearch/retrievalandexplorationofculturalheritagecontent.Themajorityofheritagemetadatacontainssomeformofimplicitorexplicitgeographicalreferencebutmorecommonlythancoordinatesareindirecttextualorformalreferencessuchasaddressesorgeographicalnames.Inordertoachievethefullbenefitsofspatialmetadataitisnecessarytohaveaccesstomapcoordinatesthatcanbeusedtovisualizethelocationofaresourceonamaporthatmaybeusedtoinfermeaningfulrelationshipsbetweentwoormoreresourcesbasedontheproximityoftheirspatialmetadata.Thisdeliverable,theLoCloudGeolocationEnrichmentServicesaddressesthisweaknessinexistingculturalheritagedataandintroducestwodifferentinteroperabletoolstofacilitateenrichmentofexistingculturalheritagemetadataaswellasenablinggeographicalnamesresolutionintocoordinatesfromliterallyanythird-partyapplicationthroughageolocationAPI.GeolocationAPILoGeoisageolocationAPI(ApplicationProgramingInterface),oneoftheGeolocationEnrichmentToolsandhasbeendevelopedwithinWP3intheLoCloudproject.ThepurposeoftheLoGeoAPIistoresolveagivensearchtermintooneormorerecognizedplacenamescandidatesaccompaniedbygeographicalcoordinates.TheLoGeoAPIisspeciallydesignedfortherecognitionoftheplacenamefrommetadataoftheculturalheritageandcouldbesimplyintegratedandusedintheotherAPI-s,microservices,andapplications.TheusabilityoftheLoGeoAPImayeasilybetestedonline:http://locloudgeo.eculturelab.eu/Console_LoGeo_1_1_m/GeocodingapplicationThepurposeofthegeocodingapplicationistoenablelocalheritageprofessionalstoexecutecrowd-sourcingprojectstoenrichnon-spatialmetadatarecordswithgeographicallocations.SourcedatatobegeocodedcanbeimportedfromeithertheMORErepository,onthewayfromthelocalinstitutiontoEuropena,oritcanbeimportedasCSVfilesfromanylocalcollectionmanagementsystemthatiscapableofrepresentingcontentasrecords.Recordscanbegeocodedbymeansofmanuallocationinthemaporbysearchingseveralmain-streamgeolocationAPIsincluding,optionally,theLoGeogeolocationAPI.Geocodeddatacanbeexportedbackintoavarietyofpopularusageformatsthatwillfacilitatetheiruptakeanduseinwebapplicationsaswellasloadingenricheddatabackintotheauthoritativecollectionmanagementsystem.ThegeocodingapplicationcanbetestedbypointingyourwebbrowsertothefollowingURL:http://locloud.avinet.no/demoLoCloudD3.2GeolocationEnrichmentServices4 5. 2. IntroductionOverview of geolocation enrichment toolsInrecognitionoftheimportanceofgeographyincreatingmeaningfulrelationshipsbetweenindependentpiecesofculturalheritagecontent,LoCloudhasdevelopedasetoftoolsandservicesthathelpsownersandcustodiansofculturalheritagecollectionstoaddgeographicalmetadata,intheformofspatialcoordinates,totheirexistingcontent.Thesetoolsfillavoidinexistingsoftwareinfrastructuresforgeocodingthatareeither(1)high-endcommercialofferingstargetedatprofessionalGISusersor(2)opensourcedesktop/command-line/terminal/shellapplicationsthatarebestsuitableforexpertuserswithveryparticularsoftwareenvironmentrequirements.TheLoCloudgeocodingenrichmenttoolsconsistsoftwoseparatecomponentsthatoptionallycanbeconfiguredtoworktogether,i.e.thegeocodingapplicationcanconsumethegeolocationAPIservices:1. LoGeo:GeolocationAPI2. GeocodingapplicationLoGeo: geolocation APILoGeoisageolocationAPI(ApplicationProgramingInterface),oneoftheGeolocationEnrichmenttools.TheAPIwasdevelopedwithinWP3intheLoCloudprojectbyIPCHS(InstituteforProtectionofCulturalHeritageofSlovenia)andGrangeoltd.ThepurposeofLoGeoAPIistorecognize(NER-NameEntityRecognition)agivenplacenameandreturnoneormorerecognizedplacenamescandidatesaccompaniedbygeographicalcoordinates.TheLoGeoAPIisspecificallydesignedfortheuseoftheplacenamerecognitionofculturalheritagemetadata.TheefficiencyofLoGeoAPIistestedwithEuropeanaEDMcollections.TheLoGeoAPImaybeinvokeddirectlybyanyoftheothermicroservices(WP3)includingtheMetadataEnrichment(Task3.3)andHistoricplacenames(Task3.4).TheLoGeoAPIcouldbealsosimplyimplementedintheculturalheritagemanagementsystems/repositoriesusedbymuseums,libraries,archivesandotherculturalinstitutions.LoCloudD3.2GeolocationEnrichmentServices5 6. /)191.(1+1/7)6/6"%1.('.).(:"%1*.($7:"%'(7/)19811(4$'.(0)6/6"41'.(:"+'.):"41+7/1.!"#$"%&'(! " #$%&'()%(*$#+",*'+-'./0! " #$%&)1+1/'%#+"0'()0! " 21.*2).(0! " ,1130! " 2#40! " 4#'.('./0! " 5'-)10! " $'(*#+0! " 666! " 4&70'%#+"+1%#('1.! " 4$15).').%)! " +1%#('1."18")5).(! " %*$$).("'.0('(*('1.! " 666))**++''**++4+#%)".#2)0%1.();(0%1$)((,,''**++4+#%)".#2)%1.();(J7157

Recommended

View more >