research-article

Open Geodata Reuse: Towards Natural Language Interfaces to Web APIs

Authors:

Auriol Degbelo,

Ang SherpaAuthors Info & Claims

WWW '20: Companion Proceedings of the Web Conference 2020

Pages 703 - 710

https://doi.org/10.1145/3366424.3384363

Published: 20 April 2020 Publication History

Abstract

Open Government datasets have been flooding the Web recently, and Application Programming Interfaces (APIs) are key to the development of services on top of these datasets. An issue of current APIs worldwide is that their learnability is limited. This work has explored the potential of querying APIs using natural language terms to mitigate that issue. A user study with 20 participants has demonstrated that a natural-language-based, along with an order-agnostic approach to API design can produce easily learnable APIs for both novice and experienced API users. These insights can pave the way for a paradigm change on Web-API design for open geodata retrieval and beyond.

References

[1]

James F. Allen. 1983. Maintaining knowledge about temporal intervals. Commun. ACM 26, 11 (nov 1983), 832–843. https://doi.org/10.1145/182.358434

Digital Library

[2]

Saad Aloteibi and Mark Sanderson. 2014. Analyzing geographic query reformulation: An exploratory study. Journal of the Association for Information Science and Technology 65, 1 (jan 2014), 13–24. https://doi.org/10.1002/asi.22961

Digital Library

[3]

Luigi Atzori, Antonio Iera, and Giacomo Morabito. 2010. The internet of things: A survey. Computer Networks 54, 15 (oct 2010), 2787–2805. https://doi.org/10.1016/j.comnet.2010.05.010

Digital Library

[4]

Fernando Benitez-Paez, Auriol Degbelo, Sergio Trilles, and Joaquin Huerta. 2018. Roadblocks hindering the reuse of open geodata in Colombia and Spain: A data user’s perspective. ISPRS International Journal of Geo-Information 7, 1 (dec 2018), 6. https://doi.org/10.3390/ijgi7010006

[5]

Shima Dastgheib, Trish Whetzel, Amrapali Zaveri, Cyrus Afrasiabi, Pedro Assis, Paul Avillach, Kathleen Jagodnik, Gabor Korodi, Marcin Pilarczyk, Jeff De Pons, Stephan Schürer, Raymond Terryn, Ruben Verborgh, Chunlei Wu, and Michel Dumontier. 2017. The smartAPI ecosystem for making Web APIs FAIR. In Proceedings of the 16th International Semantic Web Conference: Posters and Demos. CEUR-WS.org, Vienna, Austria.

[6]

John M. Daughtry, Umer Farooq, Jeffrey Stylos, and Brad A. Myers. 2009. API usability: CHI’2009 special interest group meeting. In Proceedings of the 27th international conference extended abstracts on Human factors in computing systems - CHI EA ’09. ACM Press, Boston, Massachusetts, USA, 2771–2774. https://doi.org/10.1145/1520340.1520403

Digital Library

[7]

Cleidson R. B. de Souza and David F. Redmiles. 2009. On the roles of APIs in the coordination of collaborative software development. Computer Supported Cooperative Work 18, 5-6 (2009), 445–475. https://doi.org/10.1007/s10606-009-9101-3

Digital Library

[8]

Auriol Degbelo, Carlos Granell, Sergio Trilles, Devanjan Bhattacharya, Sven Casteleyn, and Christian Kray. 2016. Opening up smart cities: citizen-centric challenges and opportunities from GIScience. ISPRS International Journal of Geo-Information 5, 2(2016), 16. https://doi.org/10.3390/ijgi5020016

[9]

Auriol Degbelo, Carlos Granell, Sergio Trilles, Devanjan Bhattacharya, and Jonas Wissing. 2020. Tell me how my open Data is re-used: increasing transparency through the Open City Toolkit. In Open Cities | Open Data: Collaborative Cities in the Information Era. Palgrave Macmillan, Singapore, 311–330. https://doi.org/10.1007/978-981-13-6605-5_14

[10]

Auriol Degbelo and Tomi Kauppinen. 2018. Increasing transparency through web maps. In Companion of Proceedings of the Web Conference 2018 - WWW ’18. ACM Press, Lyon, France, 899–904. https://doi.org/10.1145/3184558.3191515

Digital Library

[11]

Auriol Degbelo, Sergio Trilles, Christian Kray, Devanjan Bhattacharya, Nicholas Schiestel, Jonas Wissing, and Carlos Granell. 2016. Designing semantic application programming interfaces for open government data. eJournal of eDemocracy and Open Government 8, 2 (2016), 21–58. https://doi.org/10.29379/jedem.v8i2.420

[12]

Auriol Degbelo, Jonas Wissing, and Tomi Kauppinen. 2018. A comparison of geovisualizations and data tables for transparency enablement in the open government data landscape. International Journal of Electronic Government Research 14, 4 (oct 2018), 39–64. https://doi.org/10.4018/IJEGR.2018100104

Digital Library

[13]

Anastasios Dimanidis, Kyriakos C. Chatzidimitriou, and Andreas L. Symeonidis. 2018. A natural language driven approach for automated web API development. In Companion of the The Web Conference 2018 on The Web Conference 2018 - WWW ’18. ACM Press, Lyon, France, 1869–1874. https://doi.org/10.1145/3184558.3191654

Digital Library

[14]

Wafeequa Dinah, Pheladi Tracy Lefika, and Bwalya Kelvin Joseph. 2019. The role of open data in smart cities: exploring status in resource-constrained countries. In Governance Models for Creating Public Value in Open Data Initiatives. Springer, Cham, 105–121. https://doi.org/10.1007/978-3-030-14446-3_5

[15]

Tiago Espinha, Andy Zaidman, and Hans-Gerhard Gross. 2015. Web API growing pains: Loosely coupled yet strongly tied. Journal of Systems and Software 100 (feb 2015), 27–43. https://doi.org/10.1016/j.jss.2014.10.014

[16]

Qingqing Gan, Josh Attenberg, Alexander Markowetz, and Torsten Suel. 2008. Analysis of geographic queries in a search engine log. In Proceedings of the first international workshop on Location and the web - LOCWEB ’08. ACM Press, Beijing, China, 49–56. https://doi.org/10.1145/1367798.1367806

Digital Library

[17]

Michael F. Goodchild, May Yuan, and Thomas J. Cova. 2007. Towards a general theory of geographic representation in GIS. International Journal of Geographical Information Science 21, 3 (mar 2007), 239–260. https://doi.org/10.1080/13658810600965271

Digital Library

[18]

Tovi Grossman, George Fitzmaurice, and Ramtin Attar. 2009. A survey of software learnability: metrics, methodologies and guidelines. In Proceedings of the 27th international conference on Human factors in computing systems - CHI 09. ACM Press, Boston, Massachusetts, USA, 649–658. https://doi.org/10.1145/1518701.1518803

Digital Library

[19]

Dominique Guinard, Iulia Ion, and Simon Mayer. 2011. In search of an Internet of Things service architecture: REST or WS-*? A developers’ perspective. In The Eighth Annual International Conference on Mobile and Ubiquitous Systems: Computing, Networking and Services (MobiQuitous 2011). Springer, Copenhagen, Denmark, 326–337. https://doi.org/10.1007/978-3-642-30973-1_32

[20]

Michi Henning. 2009. API design matters. Commun. ACM 52, 5 (2009), 25–36. https://doi.org/10.1145/1506409.1506424

Digital Library

[21]

Emilia Kacprzak, Laura Koesten, Luis-Daniel Ibáñez, Tom Blount, Jeni Tennison, and Elena Simperl. 2019. Characterising dataset search - An analysis of search logs and data requests. Journal of Web Semantics 55 (mar 2019), 37–55. https://doi.org/10.1016/j.websem.2018.11.003

[22]

Jacek Kopecký, Paul Fremantle, and Rich Boakes. 2014. A history and future of Web APIs. it - Information Technology 56, 3 (jan 2014). https://doi.org/10.1515/itit-2013-1035

[23]

Werner Kuhn and Andrea Ballatore. 2015. Designing a language for spatial computing. In AGILE 2015 - Geographic Information Science as an Enabler of Smarter Cities and Communities. Springer International Publishing, Lisbon, Portugal, 309–326. https://doi.org/10.1007/978-3-319-16787-9_18

[24]

Markus Lanthaler. 2013. Creating 3rd generation web APIs with hydra. In Proceedings of the 22nd International Conference on World Wide Web - WWW ’13 Companion. ACM Press, Rio de Janeiro, Brazil, 35–38. https://doi.org/10.1145/2487788.2487799

Digital Library

[25]

James R. Lewis. 2014. Usability: lessons learned ... and yet to be learned. International Journal of Human-Computer Interaction 30, 9(2014), 663–684. https://doi.org/10.1080/10447318.2014.930311

[26]

Mark Masse. 2011. REST API Design Rulebook: Designing Consistent RESTful Web Service Interfaces. O’Reilly Media, Inc.

[27]

Kris McGlinn, Darragh Blake, and Declan O’Sullivan. 2019. GViz - an interactive WebApp to support GeoSPARQL over integrated building information. In Companion Proceedings of The 2019 World Wide Web Conference on - WWW ’19. ACM Press, San Francisco, California, USA, 904–912. https://doi.org/10.1145/3308560.3316536

Digital Library

[28]

Franck Michel, Catherine Faron-Zucker, Olivier Corby, and Fabien Gandon. 2019. Enabling automatic discovery and querying of web APIs at web scale using linked data standards. In Companion Proceedings of The 2019 World Wide Web Conference on - WWW ’19. ACM Press, San Francisco, California, USA, 883–892. https://doi.org/10.1145/3308560.3317073

Digital Library

[29]

Franck Michel, Catherine Faron-Zucker, and Fabien Gandon. 2018. SPARQL Micro-Services: lightweight integration of Web APIs and linked data. In Workshop on Linked Data on the Web co-located with The Web Conference 2018, LDOW@WWW 2018, Lyon, France April 23rd, 2018, Vol. 2073. CEUR-WS.org. http://ceur-ws.org/Vol-2073

[30]

Andrea Molinari, Vincenzo Maltese, Lorenzino Vaccari, Andrea Almi, and Eleonora Bassi. 2014. Big data and open data for a smart city. IEEE-TN Smart Cities White Papers, Trento, Italy (2014).

[31]

Ibrahim Musa, Hyun Woo Park, Dingkun Li, and Keun Ryu. 2016. Highlighting current issues in API usage mining to enhance software reusability. In Proceedings of the 15th International Conference on Software Engineering, Parallel and Distributed Systems (SEPADS’16). Barcelona, Spain, 200–205.

[32]

Brad A Myers and Jeffrey Stylos. 2016. Improving API usability. Commun. ACM 59, 6 (2016), 62–69. https://doi.org/10.1145/2896587

Digital Library

[33]

A Ojo, E Curry, and F A Zeleti. 2015. A tale of open data innovations in five smart cities. In 48th Hawaii International Conference on System Sciences (HICSS 2015). IEEE, Kauai, Hawaii, 2326–2335.

Digital Library

[34]

Marco Piccioni, Carlo A. Furia, and Bertrand Meyer. 2013. An empirical study of API usability. In 2013 ACM / IEEE International Symposium on Empirical Software Engineering and Measurement (ESEM 2013). IEEE, Baltimore, Maryland, USA, 5–14. https://doi.org/10.1109/ESEM.2013.14

[35]

Ross S. Purves, Paul Clough, Christopher B. Jones, Mark H. Hall, and Vanessa Murdock. 2018. Geographic information retrieval: progress and challenges in spatial search of text. Foundations and Trends® in Information Retrieval 12, 2-3(2018), 164–318. https://doi.org/10.1561/1500000034

[36]

Leonard Richardson and Mike Amundsen. 2013. RESTful web APIs. O’Reilly Media, Inc. 379 pages.

[37]

Simon Scheider, Auriol Degbelo, Rob Lemmens, Corné van Elzakker, Peter Zimmerhof, Nemanja Kostic, Jim Jones, and Gautam Banhatti. 2017. Exploratory querying of SPARQL endpoints in space and time. Semantic Web 8, 1 (nov 2017), 65–86. https://doi.org/10.3233/SW-150211

[38]

Simon Scheider and Werner Kuhn. 2015. How to talk to each other via computers - Semantic interoperability as conceptual imitation. In Applications of Conceptual Spaces. Springer International Publishing, 97–122. https://doi.org/10.1007/978-3-319-15021-5_6

[39]

Jeffrey Stylos and Brad Myers. 2007. Mapping the space of API design decisions. In Proceedings of the IEEE Symposium on Visual Languages and Human-Centric Computing (VL/HCC 2007). IEEE, Coeur d’Alène, Idaho, USA, 50–57. https://doi.org/10.1109/VLHCC.2007.36

Digital Library

[40]

Yu Su, Ahmed Hassan Awadallah, Madian Khabsa, Patrick Pantel, Michael Gamon, and Mark Encarnacion. 2017. Building natural language interfaces to web APIs. In Proceedings of the 2017 ACM on Conference on Information and Knowledge Management - CIKM ’17. ACM Press, Singapore, Singapore, 177–186. https://doi.org/10.1145/3132847.3133009

Digital Library

[41]

Timothy Tambassi. 2017. A geographical taxonomy for geo-ontologies. Axiomathes 27, 4 (aug 2017), 355–374. https://doi.org/10.1007/s10516-016-9309-z

[42]

The World Wide Web Foundation. 2015. Open Data Barometer - Global Report(2nd ed.). The World Wide Web Foundation. 1–62 pages. https://opendatabarometer.org/2ndEdition/

[43]

The World Wide Web Foundation. 2016. Open Data Barometer - Global Report(3rd ed.). The World Wide Web Foundation. 1–47 pages. http://opendatabarometer.org/doc/3rdEdition/ODB-3rdEdition-GlobalReport.pdf

[44]

The World Wide Web Foundation. 2017. Open Data Barometer - Global Report(4th ed.). The World Wide Web Foundation. 1–36 pages. https://opendatabarometer.org/doc/4thEdition/ODB-4thEdition-GlobalReport.pdf

[45]

Barbara Ubaldi. 2013. Open government data: towards empirical analysis of open government data initiatives. 22 (2013). https://doi.org/https://doi.org/10.1787/5k46bj4f03s7-en

[46]

Behzad Vahedi, Werner Kuhn, and Andrea Ballatore. 2016. Question-based spatial computing - A case study. In 19th AGILE Conference on Geographic Information Science (AGILE 2016). Springer, Helsinki, Finland, 37–50. https://doi.org/10.1007/978-3-319-33783-8_3

[47]

Ruben Verborgh and Michel Dumontier. 2018. A web API ecosystem through feature-based reuse. IEEE Internet Computing 22, 3 (may 2018), 29–37. https://doi.org/10.1109/MIC.2018.032501515

[48]

Erik Wilde. 2018. Surfing the API Web: Web concepts. In Companion Proceedings of the Web Conference 2018 - WWW ’18. ACM Press, Lyon, France, 797–803. https://doi.org/10.1145/3184558.3188743

Digital Library

[49]

Amrapali Zaveri, Shima Dastgheib, Chunlei Wu, Trish Whetzel, Ruben Verborgh, Paul Avillach, Gabor Korodi, Raymond Terryn, Kathleen Jagodnik, Pedro Assis, and Michel Dumontier. 2017. smartAPI: towards a more intelligent network of web APIs. In The Semantic Web - 14th International Conference (ESWC 2017). Springer International Publishing, Portorož, Slovenia, 154–169. https://doi.org/10.1007/978-3-319-58451-5_11

Digital Library

[50]

Deze Zeng, Song Guo, and Zixue Cheng. 2011. The web of things: A survey (invited paper). Journal of Communications 6, 6 (sep 2011). https://doi.org/10.4304/jcm.6.6.424-438

Cited By

Ahlers DWilde ESchifanella RAlowibdi J(2021)Report on the tenth international workshop on location and the web (LocWeb 2020)ACM SIGIR Forum10.1145/3451964.345197254:1(1-8)Online publication date: 19-Feb-2021
https://dl.acm.org/doi/10.1145/3451964.3451972
Degbelo A(2021)FAIR geovisualizations: definitions, challenges, and the road aheadInternational Journal of Geographical Information Science10.1080/13658816.2021.198357936:6(1059-1099)Online publication date: 28-Oct-2021
https://doi.org/10.1080/13658816.2021.1983579

Index Terms

Open Geodata Reuse: Towards Natural Language Interfaces to Web APIs

Index terms have been assigned to the content through auto-classification.

Recommendations

What Makes APIs Hard to Learn? Answers from Developers

Most software projects reuse components exposed through APIs, which provide developers access to implemented functionality. APIs have grown large and diverse, which raises questions regarding their usability. This article reports on a study of the ...
Using concept maps to evaluate the usability of APIs
CHI EA '10: CHI '10 Extended Abstracts on Human Factors in Computing Systems

Application programming interfaces (APIs) are the interfaces to existing code structures, such as widgets, frameworks, or toolkits. Therefore, they very much do have an impact on the quality of the resulting system. So ensuring that developers can make ...
API usability peer reviews: a method for evaluating the usability of application programming interfaces
CHI '10: Proceedings of the SIGCHI Conference on Human Factors in Computing Systems

We describe a usability inspection method to evaluate Application Programming Interfaces (APIs). We found the method useful as it identified usability defects in Microsoft's .NET Framework, of which 59% were new and 21% were fixed. Based on a comparison ...

Comments

Please enable JavaScript to view thecomments powered by Disqus.

Information & Contributors

Information

Published In

cover image ACM Conferences

WWW '20: Companion Proceedings of the Web Conference 2020

April 2020

854 pages

ISBN:9781450370240

DOI:10.1145/3366424

Editors:
Amal El Fallah Seghrouchni
Sorbonne University, France
,
Gita Sukthankar
University of Central Florida, United States
,
Tie-Yan Liu
Microsoft Research Asia, China
,
Maarten van Steen
University of Twente, Netherlands

Copyright © 2020 ACM.

Permission to make digital or hard copies of all or part of this work for personal or classroom use is granted without fee provided that copies are not made or distributed for profit or commercial advantage and that copies bear this notice and the full citation on the first page. Copyrights for components of this work owned by others than ACM must be honored. Abstracting with credit is permitted. To copy otherwise, or republish, to post on servers or to redistribute to lists, requires prior specific permission and/or a fee. Request permissions from [email protected]

Sponsors

SIGWEB: ACM Special Interest Group on Hypertext, Hypermedia, and Web

Publisher

Association for Computing Machinery

New York, NY, United States

Publication History

Published: 20 April 2020

Permissions

Request permissions for this article.

Request Permissions

Check for updates

Author Tags

Qualifiers

Research-article
Research
Refereed limited

Conference

WWW '20

Sponsor:

SIGWEB

WWW '20: The Web Conference 2020

April 20 - 24, 2020

Taipei, Taiwan

Acceptance Rates

Overall Acceptance Rate 1,899 of 8,196 submissions, 23%

Contributors

Other Metrics

View Article Metrics

Bibliometrics & Citations

Bibliometrics

Article Metrics

2
Total Citations
View Citations
153
Total Downloads

Downloads (Last 12 months)11
Downloads (Last 6 weeks)1

Reflects downloads up to 16 Nov 2024

Other Metrics

View Author Metrics

Citations

Cited By

Ahlers DWilde ESchifanella RAlowibdi J(2021)Report on the tenth international workshop on location and the web (LocWeb 2020)ACM SIGIR Forum10.1145/3451964.345197254:1(1-8)Online publication date: 19-Feb-2021
https://dl.acm.org/doi/10.1145/3451964.3451972
Degbelo A(2021)FAIR geovisualizations: definitions, challenges, and the road aheadInternational Journal of Geographical Information Science10.1080/13658816.2021.198357936:6(1059-1099)Online publication date: 28-Oct-2021
https://doi.org/10.1080/13658816.2021.1983579

View Options

Login options

Check if you have access through your login credentials or your institution to get full access on this article.

Full Access

Get this Publication

View options

PDF

View or Download as a PDF file.

eReader

View online with eReader.

HTML Format

View this article in HTML Format.

Media

Figures

Other

Tables

View Table of Contents