<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

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

4. Dependencies on Other Framework Components

• Zend_Http
• Zend_Json
• Zend_Exception

5. Theory of Operation

6. Milestones / Tasks

• Milestone 1: design notes will be published here
• Milestone 2: Working prototype checked into the incubator supporting use cases #1, #2, ...
• Milestone 3: Working prototype checked into the incubator supporting use cases #3 and #4.
• Milestone 4: Unit tests exist, work, and are checked into SVN.
• Milestone 5: Initial documentation exists.

7. Class Index

• Zend_Service_Geonames
• Zend_Service_Geonames_Exception

8. Use Cases

9. Class Skeletons