Session 300 - Getting Around Using Map Kit

These are confidential sessions—please refrain from streaming, blogging, or taking pictures

Session 300 and 310

Getting Around with Map Kit

Brady LawSoftware Engineer - Maps Client Team

Agenda

• The new look of Map Kit

Agenda

• The new look of Map Kit• Launching Maps with MKMapItem

Agenda

• The new look of Map Kit• Launching Maps with MKMapItem• Developing routing apps

Powered by Apple MapsThe New Look of Map Kit

What does it take to get Apple Maps in my app?

Absolutely nothing.New Maps. Same API.

StandardMap Modes

SatelliteMap Modes

HybridMap Modes

Annotations

Overlays

With a Static MapPinch to Zoom

With a Dynamic MapPinch to Zoom

Setting the Map Region

• In iOS 5, region changes were adjusted to improve map display

• In iOS 5, region changes were adjusted to improve map display-setRegion:

• In iOS 5, region changes were adjusted to improve map display-setRegion:-setVisibleMapRect:

• No longer necessary in iOS 6

Heading Mode

Static Map (iOS 5)

Heading Mode

Static Map (iOS 5)

Heading Mode

Static Map (iOS 5) Dynamic Map (iOS 6)

Heading Mode

Static Map (iOS 5) Dynamic Map (iOS 6)

The New Look of Map Kit

• Map display APIs are the same

• Map display APIs are the same• Improved map rendering

• Map display APIs are the same• Improved map rendering• Re-link with iOS 6 to change regions with precision

• Map display APIs are the same• Improved map rendering• Re-link with iOS 6 to change regions with precision• Test your apps!

A new API in iOS 6Launching Maps with MKMapItem

Why Launch Maps?Getting directions

Why Launch Maps?

Contacts/Bookmarks ExploreDrop a Pin

Introducing MKMapItem

• Objective-C API

• Objective-C API• Open Maps with one or more pins

• Objective-C API• Open Maps with one or more pins• Jump directly into directions

• Objective-C API• Open Maps with one or more pins• Jump directly into directions• Customize the map display

Opening an Item in Maps

MKPlacemark

Location

MKPlacemark

LocationAddress Dictionary

MKMapItem

MKPlacemark

-openInMapsWithLaunchOptions:

MKMapItem

MKPlacemark

MKMapItem

MKPlacemark

MKMapItem *sfStore = [[MKMapItem alloc] initWithPlacemark:placemark];

[sfStore openInMapsWithLaunchOptions:nil];

Adding Item Details

MKPlacemark

Adding Item Details

MKMapItem

+name+phone+url

MKPlacemark

Adding Item Details

MKMapItem

+name+phone+url

MKPlacemark

Adding Item Details

MKMapItem

+name+phone+url

MKPlacemark

sfStore.name = @"Apple Store - San Francisco";sfStore.phoneNumber = @"+14153920202";sfStore.url = [NSURL URLWithString:@"http://www.apple.com/retail/"];

[sfStore openInMapsWithLaunchOptions:nil];

Adding Item Details

Opening Multiple Map Items

Opening Multiple Items in Maps

MKMapItem

NSArray

MKMapItem

+openMapsWithItems:launchOptions:

NSArray

MKMapItem

NSArray

MKMapItem

NSArray *storeItems = @[ sfStore, chestnutStore, bayStreetStore ];

[MKMapItem openMapsWithItems:storeItems launchOptions:nil];

+openMapsWithItems:launchOptions: +openMapsWithItems:launchOptions: +openMapsWithItems:launchOptions:

-openInMapsWithLaunchOptions: -openInMapsWithLaunchOptions: -openInMapsWithLaunchOptions:

Launch Options

+openMapsWithItems:launchOptions: +openMapsWithItems:launchOptions:

-openInMapsWithLaunchOptions: -openInMapsWithLaunchOptions:

Launch Options

Map type

Launch Options

Map type

Coordinate region

Launch Options

Map type

Coordinate region

Traffic

Map typeLaunch Options

NSDictionary *options = @{

Map typeLaunch Options

NSDictionary *options = @{ MKLaunchOptionsMapTypeKey :

[NSNumber numberWithInteger:MKMapTypeSatellite],

Coordinate regionLaunch Options

MKLaunchOptionsMapCenterKey : [NSValue valueWithMKCoordinate:regionCenter],

MKLaunchOptionsMapSpanKey : [NSValue valueWithMKCoordinateSpan:regionSpan]

TrafficLaunch Options

MKLaunchOptionsShowsTrafficKey :@YES,

Getting Directions

mosconeItem

Getting Directions

mosconeItem

Getting Directions

DirectionsModeKey

Current Location

mosconeItem

Getting Directions

DirectionsModeKey

Current Location

mosconeItem

Getting Directions

DirectionsModeKey

MKMapItem *mosconeItem = ...

NSDictionary *options = @{ MKLaunchOptionsDirectionsModeKey : MKLaunchOptionsDirectionsModeDriving,};

[mosconeItem openInMapsWithLaunchOptions:options];

Getting DirectionsFrom your current location

mosconeItem

airportItem

Directions from a Custom Origin

DirectionsModeKey

NSArray

mosconeItem

airportItem

DirectionsModeKey

NSArray

mosconeItem

airportItem

DirectionsModeKey

mosconeItem

airportItem

DirectionsModeKey

mosconeItem

airportItem

DirectionsModeKey

NSArray *directionsItems = @[airportItem,mosconeWestItem];

NSDictionary *options = @{ MKLaunchOptionsDirectionsModeKey :

MKLaunchOptionsDirectionsModeDriving,};

[MKMapItem openMapsWithItems:directionsItems launchOptions:options];

Representing Current Location

MKMapItem *item = [MKMapItem mapItemForCurrentLocation];

• Current location item will NOT have a placemark

• Current location item will NOT have a placemarkmapItem.isCurrentLocation == YES

NSArray *directionsItems = @[mosconeWestItem,[MKMapItem mapItemForCurrentLocation]];

[MKMapItem openMapsWithItems:directionsItems launchOptions:options];

Launching Maps with MKMapItem

• Open Maps with minimal code

• Open Maps with minimal code• Offer quick access to navigation, bookmarks, and more

• Keep your app focused

Integrated routing powered by the app storeDeveloping Routing Apps

Transportation modesThe Many Faces of Routing

There is a black mask behind me! Make sure I stay here so animations look nice.

Red Circle instead of text

Add graphic to show these are relevant apps based on the origin and destination.

Installed Routing AppsRecommended apps for your start and endpoint.

Add graphic to show these are relevant apps based on the origin and destination.

App Store SuggestionsPurchase from inside of Maps.

Red circle

Add a slide to make it more clear that we are getting directions from Moscone to Apple, Inc.

Routing App Requirements

1. Declare your app as a routing app

1. Declare your app as a routing app2. Specify where your app is relevant geographically

1. Declare your app as a routing app2. Specify where your app is relevant geographically3. Handle launches from Maps

Declare Your App as a Routing App

Specifying Geographic CoverageWhere can your app provide routes?

Specifying Geographic CoverageRequirements

• GeoJSON file format (.geojson)

• GeoJSON file format (.geojson)• Provide one MultiPolygon

• GeoJSON file format (.geojson)• Provide one MultiPolygon• Keep it simple

■ Up to 20 polygons, 20 points per polygon

• Coverage file is NOT part of the app bundle

• Coverage file is NOT part of the app bundle■ Uploaded using iTunes Connect

• Coverage file is NOT part of the app bundle■ Uploaded using iTunes Connect■ Automatically updated

Testing Your Routing App

• Maps is now in the simulator

• Maps is now in the simulator• Verify your app appears when relevant

• Check the logs

• Check the logs■ Simulator—use Console

• Check the logs■ Simulator—use Console■ Device—use Xcode Organizer

DemoDeclaring your app as a routing app

1. Declare your app as a routing app2. Specify where your app is relevant geographically3. Handle launches from Maps

Handling Launches from Maps

MKMapItem

Current Location

MKDirectionsRequest

MKMapItem

Current Location

MKDirectionsRequest

MKMapItem

Current Location

MKDirectionsRequest

• Is it a MKDirectionsRequest URL?

MKDirectionsRequest

• Is it a MKDirectionsRequest URL?• If yes, instantiate the request using the URL

MKDirectionsRequest

Current Location

• Is it a MKDirectionsRequest URL?• If yes, instantiate the request using the URL@property MKMapItem *source;

MKDirectionsRequest

MKMapItem

Current Location

• Is it a MKDirectionsRequest URL?• If yes, instantiate the request using the URL@property MKMapItem *source;@property MKMapItem *destination;

MKDirectionsRequest

MKMapItem

Current Location

• Resolve the current location map item

MKDirectionsRequest

MKMapItem

Current Location

• Resolve the current location map item• Provide your route!

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation{

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation{ if ([MKDirectionsRequest isDirectionsRequestURL:url]) {

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation{ if ([MKDirectionsRequest isDirectionsRequestURL:url]) { MKDirectionsRequest *request = [[MKDirectionsRequest alloc]

initWithContentsOfURL:url];

MKMapItem *startItem = [request source]; MKMapItem *endItem = [request destination];

// YOUR CODE HERE}

DemoUsing the MKDirectionsRequest to provide a route

Best practicesMaking Great Routing Apps

• Minimize user input after launch

• Minimize user input after launch• Personalize display using MKMapItem data

• Minimize user input after launch• Personalize display using MKMapItem data• Be reasonable with geographic coverage

Routing Apps

• Integrate with Maps

Routing Apps

• Integrate with Maps• Increase traffic to your app

Routing Apps

• Integrate with Maps• Increase traffic to your app• Get promoted to users who care

Summary

New Maps. Same API.

Summary

New Maps. Same API. Open Maps with MKMapItem

Summary

New Maps. Same API. Open Maps with MKMapItem

Routing Apps

More Information

Paul MarcosApplication Services Evangelistpmarcos@apple.com

DocumentationMKMapViewhttp://developer.apple.com/library/ios/#documentation/MapKit/Reference/MKMapView_Class/

Location Awareness Programming Guidehttp://developer.apple.com/library/ios/#DOCUMENTATION/UserExperience/Conceptual/LocationAwarenessPG/

WWDC 2011“Visualizing Information Geographically with MapKit”

Apple Developer Forumshttp://devforums.apple.com

Related Sessions

Getting Around with Map Kit (Repeat) Pacific HeightsTuesday 3:15PM

Staying on Track with Location Services Nob HillWednesday 2:00PM

What’s new in iTunes Connect for App Developers Nob HillThursday 9:00AM

MapKit Lab #1 App Services Lab BTuesday 4:30PM

MapKit Lab #2 App Services Lab BThursday 11:30AM

Session 300 - Getting Around Using Map Kit

Documents

Getting around the site

Discrete Math Round, Round, Get Around… I Get Around Mathematics of Getting Around

Sage 300 Web Screens Getting Started Guide · PDF file( ). YouusetheEmailtabontheCompanyProfilewebscreentoenterdefaultemailsettingsthatare ... Sage 300 Web Screens Getting Started

Getting Past BS Around Game Investments

Getting Around - 6 October 2015

Optimal Living: Getting Around

Shopping Dining Getting There Getting Around Useful Contacts

Getting into and around in russia

SIEMENS S7-300 Getting Started Manual

Getting Around Prospect Objections

Getting your head around big data

Getting Around Our Country~

Getting Around Town

Getting Around…

Getting Around London Large Print

Getting Around on Foot

Getting Here & Getting Around - giievent.kr · Getting Here & Getting Around Transportation is easy in Phoenix and its surrounding communities. Phoenix Sky Harbor International Airport

‘Getting Around Bath’ – A Transport Strategy for Bath The ......‘Getting Around Bath’ – A Transport Strategy for Bath Getting around is important to most of us. The Council

Getting around campus

Transportation: Getting Around Dartmouth