The following tutorials walk you through the steps to create a simple iPhone application using the deCarta iPhone API.
Getting Started : Installing Software, Installing the deCarta Android API, Installing the Tutorials
This first lesson walks you walks you through the process of setting up the iOS SDK, downloading and installing the deCarta iOS API and Tutorials, and starting a new xcode project.
Note: These lessons assume that the /tutorials folder is in the same location on disk as the /iPhoneAPI folder.
Lesson 1 : Creating an App using the deCarta iOS API, Displaying a Map, Adding Map Controls
This first lesson walks you through the process of creating your first xcode project, using the deCarta iOS API and supporting frameworks, to display a draggable map.
Lesson 1b : Creating a MapViewController, Adding Map Controls
While Lesson 1 demonstrates the concepts for creating an iPhone App with a map, it is an oversimplification of how this would work in a real application. This lesson builds on Lesson 1 by encapsulating the map display in a UIViewController, and adding controls for interacting with the map (a button to toggle between satellite and map views, and zoom in/out buttons).
Lesson 2 : Handling Map Events, Adding Pins to the Map
The Map captures events such as TOUCH and LONGTOUCH events. This lesson adds a handler to the map which drops a pin on the map when the user holds down a point on the map (triggering the LONGTOUCH event). It also adds an event handler to the pin which displays the lat/lon location of the pin in an infowindow above the pin when the pin is touched.
This lesson demonstrates how to determine the lat/lon position of an address, and centers the map on that location.
This lesson demonstrates how to determine the address corresponding to a lat/lon position. This lesson modifies the pin dropped as the result of a LONGTOUCH event (from Lesson 2), replacing the infowindow text for that pin with the reverse geocoded address at the pin's location.
Lesson 5 : Point-of-Interest Search
This lesson demonstrates how to search in a specified area for points-of-interest (POIs) by name. The returned results are displayed on the map as a set of pins on the map.
Lesson 6 : Calculating a Route
This lesson demonstrates how to calculate a route between two points. It displays this route overlayed on the map, with pins marking the origin and destination points.
