<ac:macro ac:name="unmigrated-inline-wiki-markup"><ac:plain-text-body><![CDATA[

Zend Framework: Zend_Service_Geonames Component Proposal

Table of Contents

1. Overview

Zend_Service_Geonames aims to provide full access to the Geonames.org API. Geonames.org provides many free geographic services such as POI lookups, Postal Code lookups, and regular/reverse geocoding.

2. References

• Geonames.org
• GeoNames Web Services Overview
• GeoNames Web Services Documentation
• GeoNames Web Services Exception

3. Component Requirements, Constraints, and Acceptance Criteria

• This component will provide full access to the Geonames.org API
• This component will abstract the interaction with Geonames.org's database and XML/Json responses
• This component will provide methods to return Wikipedia documents based on various geographic queries
• This component will provide programmatic access to Geonames.org's nearly 7 million POI's
• This component will handle Geonames.org web services errors and throw a Zend_Service_Geonames_Exception accordingly
• This component should handle failover servers
• This component will not manage web-service using other output than XML or JSON

4. Dependencies on Other Framework Components

• Zend_Rest
• Zend_Json
• Zend_Exception

5. Theory of Operation

6. Milestones / Tasks

• Milestone 1: Initial proposal
• Milestone 2: Class overview and method signature
• Milestone 3: Use cases
• Milestone 4: Working prototype
• Milestone 5: Acceptance
• Milestone 6: Unit tests exist, work
• Milestone 7: Initial documentation exists

7. Class Index

• Zend_Service_Geonames
• Zend_Service_Geonames_Exception

8. Use Cases

9. Class Skeletons