Gazetteer Service - Application Profile of the Web Feature Service Best Practice
Total Page:16
File Type:pdf, Size:1020Kb
Best Practices Document Open Geospatial Consortium Approval Date: 2012-01-30 Publication Date: 2012-02-17 External identifier of this OGC® document: http://www.opengis.net/doc/wfs-gaz-ap ® Reference number of this OGC document: OGC 11-122r1 Version 1.0 ® Category: OGC Best Practice Editors: Jeff Harrison, Panagiotis (Peter) A. Vretanos Gazetteer Service - Application Profile of the Web Feature Service Best Practice Copyright © 2012 Open Geospatial Consortium To obtain additional rights of use, visit http://www.opengeospatial.org/legal/ Warning This document defines an OGC Best Practices on a particular technology or approach related to an OGC standard. This document is not an OGC Standard and may not be referred to as an OGC Standard. This document is subject to change without notice. However, this document is an official position of the OGC membership on this particular technology topic. Document type: OGC® Best Practice Paper Document subtype: Application Profile Document stage: Approved Document language: English OGC 11-122r1 Contents Page 1 Scope ..................................................................................................................... 13 2 Conformance ......................................................................................................... 14 3 Normative references ............................................................................................ 14 4 Terms and definitions ........................................................................................... 15 5 Conventions .......................................................................................................... 15 5.1 Abbreviated terms ................................................................................................. 15 5.2 UML notation ........................................................................................................ 16 5.3 Document terms and definitions ........................................................................... 16 6 Gazetteer Service overview .................................................................................. 16 6.1 Processing Requests .............................................................................................. 16 7 Shared aspects ....................................................................................................... 17 7.1 Introduction ........................................................................................................... 17 7.2 Operation request encoding .................................................................................. 17 8 GetCapabilities operation (required) ..................................................................... 18 8.1 Introduction ........................................................................................................... 18 8.2 Operation request .................................................................................................. 18 8.3 GetCapabilities operation response ....................................................................... 19 Normal response ......................................................................................................... 19 9 DescribeFeatureType operation (required) ........................................................... 19 9.1 Introduction ........................................................................................................... 19 9.2 Examples ............................................................................................................... 19 10 GetFeature operation (required) ............................................................................ 22 10.1 Introduction ........................................................................................................... 22 10.2 Examples ............................................................................................................... 23 Example 1 - Get all entries in a gazetteer (empty filter) ............................................. 23 Example 2 - Get an entry by name. ............................................................................. 23 Example 3 - Get an entry by id. .................................................................................. 23 Example 4 - Get entries within a BBOX .................................................................... 24 11 Transaction operation (optional) ........................................................................... 29 11.1 Insert, Update and Delete Examples ..................................................................... 29 Example: Insert .............................................................................................................. 29 Example: Update ............................................................................................................ 31 Example: Delete ............................................................................................................. 32 11.2 Response ............................................................................................................... 33 11.3 Exceptions ............................................................................................................. 33 Annex A: Abstract test suite ............................................................................................. 34 Copyright © 2012 Open Geospatial Consortium OGC 11-122r1 A.1 Test module for general capabilities ..................................................................... 34 A.1.1 General capabilities .......................................................................................... 34 A.1.2 Required capabilities ........................................................................................ 34 A.2 Test module for Accessible Content conformance ............................................... 34 A.2.1 Gazetteer Service advertised ............................................................................ 34 A.2.2 SI_Gazetteer Feature Type response conformance .......................................... 35 A.2.2 Gazetteers refer to available feature types ........................................................ 35 A.2.2 SI_LocationInstance conformance ................................................................... 35 A.2.2 SI_LocationInstance extensions conformance ................................................. 36 Annex B: XML schemas ................................................................................................... 37 Annex C: Dictionaries ....................................................................................................... 52 Annex D: Use Cases ....................................................................................................... 150 D.1 Parent-Child Navigation Use Case ....................................................................... 150 D.2 Geographic Selection Use Case ............................................................................ 150 D.3 Integrated Query Use Case ................................................................................... 150 D.4 GeoSynchronization via Mobile Apps Use Case .................................................. 151 D.5 “Geocoding” Use Case .......................................................................................... 151 D.6 Service Invocation Use Case ................................................................................. 152 Annex E: Transliteration domains .................................................................................. 153 Annex F: Language and Script domains ......................................................................... 161 Annex G: Dialect domains .............................................................................................. 175 Figures Figure 1 - WFS-G Profile update process ........................................................................... 8 Figure 2 - Gazetteer class diagram (from ISO 19112) ...................................................... 13 Copyright © 2012 Open Geospatial Consortium OGC Best Practices Document OGC 11-122r1 License Agreement Permission is hereby granted by the Open Geospatial Consortium, Inc. ("Licensor"), free of charge and subject to the terms set forth below, to any person obtaining a copy of this Intellectual Property and any associated documentation, to deal in the Intellectual Property without restriction (except as set forth below), including without limitation the rights to implement, use, copy, modify, merge, publish, distribute, and/or sublicense copies of the Intellectual Property, and to permit persons to whom the Intellectual Property is furnished to do so, provided that all copyright notices on the intellectual property are retained intact and that each person to whom the Intellectual Property is furnished agrees to the terms of this Agreement. If you modify the Intellectual Property, all copies of the modified Intellectual Property must include, in addition to the above copyright notice, a notice that the Intellectual Property includes modifications that have not been approved or adopted by LICENSOR. THIS LICENSE IS A COPYRIGHT LICENSE ONLY, AND DOES NOT CONVEY ANY RIGHTS UNDER ANY PATENTS THAT MAY BE IN FORCE ANYWHERE IN THE WORLD. THE INTELLECTUAL PROPERTY IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT