Geo-SDKs Backstage. Mit Domänenmodellen Grenzen überwinden. Wiebke Krasting / Masanori Fujita

Transkript

1 Geo-SDKs Backstage Mit Domänenmodellen Grenzen überwinden Wiebke Krasting / Masanori Fujita

2 Über NAVTEQ NAVTEQ ist der führende Anbieter digitaler Karten-, Verkehrs- und Positionsdaten auf dem globalen Wachstumsmarkt in Silicon Valley (Kalifornien) gegründet Seit %ige Tochtergesellschaft der Nokia Corporation NAVTEQ Headquarter in Chicago, Illinois, USA >5100 Mitarbeiter in 212 Büros in 48 Ländern Mehr als 1100 NAVTEQ-Geoanalysten legen jedes Jahr Millionen von Kilometern im Straßennetz zurück. 2

3 Über Zühlke Technologie- und Beratungshaus Gründung 1968, im Besitz von Partnern Standorte in Zürich, Bern, Frankfurt, Hannover, München, London Mehr als 4000 Projekte in Europa realisiert ISO 9001 und zertifiziert

4 Ausgangslage: Viele unterschiedliche APIs Client SDKs Qt Mobility JavaME JS Location API Smart iphone Smart Android Backend Services Routing Search Traffic Map Rendering Vision The API is the product. They need to be the same. 4

5 Das Domänenmodell als gemeinsame Sprache Domänenmodel Route - waypoints: Waypoint [2..n] +firstsegment 1 RouteSegment - shape: GeoPolyline - length: Distance - traveltime: Duration +maneuver nextsegment alternativesegments 0..* erleichtert die interne Kommunikation (Produkt Management, Entwicklung, Test) +firstmaneuver 1 Maneuver - position: GeoCoordinate - instruction: String +nextmaneuver 0..1 erhöht Interoperabilität minimiert den Einarbeitungsaufwand für Entwickler beim Umstieg zwischen Plattformen reduziert Dokumentationskosten 5 Image: jscreationzs / FreeDigitalPhotos.net

6 Ein Muss: Gemeinsame Basistypen Einfache Datentypen: Latitue, Longitude, Distance, Speed Komplexe Datentypen: class Common - Data Types «platform» GeoCoordinate + latitude: Latitude + longitude: Longitude + altitude: Altitude [0..1] + distance(coord :GeoCoordinate) : Distance +topleft 1 +bottomright 1 1+center GeoBoundingBox + coverall(coord :GeoCoordinate[]) : GeoBoundingBox + merge(bboxes :GeoBoundingBox[]) : GeoBoundingBox + contains(coord :GeoCoordinate) : boolean + contains(bbox :GeoBoundingBox) : boolean + intersects(bbox :GeoBoundingBox) : boolean + isempty() : boolean + getcenter() : GeoCoordinate + getwidth() : double + getheight() : double + resizetocenter(center :GeoCoordinate) : GeoBoundingBox GeoProximity + radius: Distance GeoCorridor «interface» GeoArea + line: GeoPolyline + width: Distance 6

7 Challenge #1: Heterogene Rahmenbedingungen Web Mobile Automotive B2B Services Datenvolumen Prozessor Leistungsfähigkeit GPS Internet Connectivity Display Größe Audio Support B2C Services 7 Image: renjith krishnan / FreeDigitalPhotos.net

8 Eine Stippvisite in die Domäne Routing Überbrückung von offline Phasen während der Navigation Einführung eines Korridors um die Basis Route, der Navigationsinformationen zum Ziel für Streckenabschnitte abseits der Basis Route enthält Basis Route Level 1 Korridor Level 2 Korridor 8

9 Eine Stippvisite in die Domäne Routing Beispiel eines Korridors vom Level 2-4 Konfigurationsoptionen erlauben eine detaillierte Spezifikation des Korridorumfangs, um ein ausgewogenes Verhältnis zwischen Datenvolumen und Autonomität herzustellen 9

10 Eine Stippvisite in die Domäne Routing Haupt Entitäten: Route: Errechneter optimaler Pfad zwischen mehreren Wegpunkten RouteSegment: Streckenabschnitt im Routing-Netzwerk Maneuver: Handlungsanweisung, um der Route zu folgen Route - waypoints: Waypoint [2..n] +firstsegment 1 RouteSegment - shape: GeoPolyline - length: Distance - travelt ime: Duration Optimaler Pfad +nextsegment alternativesegments 0..* Alternative Pfade +maneuver firstmaneuver 1 Maneuv er - position: GeoCoordinate - instruction: String +nextmaneuver

11 Zu komplex? class Routing Adv anced API - Domain Model +mode Route - routeid: String - waypoints: Waypoint [2..n] - shape: GeoPolyline - boundingbox: GeoBoundingBox + getstart() : Waypoint + getdestination() : Waypoint + getmaneuvers() : Maneuver[] + getsegment(maneuver :Maneuver) : RouteSegment + getlinks() : RouteLink[] RouteSummary TruckRestrictions - trailerforbidden: boolean [0..1] - forbiddenhazardousgoods: HazardousGoodType [0..n] - permittedgrossweight: Weight [0..1] - limitedweight: Weight [0..1] - weightperaxle: Weight [0..1] - trailerweight: Weight [0..1] - height: double [0..1] - width: double [0..1] - length: double [0..1] 1 - distance: Distance - traffictime: Duration [0..1] - basetime: Duration - flags: RouteLinkFlag [0..n] RoutingMode - type: RoutingType - transportmodes: TransportMode [1..n] - trafficmode: TrafficMode [0..1] = "enabled" - features: HashMap<RouteFeature, RouteFeatureWeight> [0..1] +summary summarybycountry 0..* +truckrestrictions RouteSummaryByCountry - country: CountryCode Address + label: string + country: CountryCode + state: string [0..1] + county: string [0..1] + city: string [0..1] + district: string [0..1] + street: string [0..1] + housenumber: string [0..1] + postalcode: string [0..1] + floor: string [0..1] + suite: string [0..1] + additionaldata: HashMap [0..1] +legs 0..* +notes RouteLeg - start: Waypoint - end: Waypoint - length: Distance - traveltime: Duration 0..* RouteNote +address - type: RouteNoteType - code: RouteNoteCode - text: String - position: GeoCoordinate [0..1] - linkids: LinkId [0..n] - validityperiod: Period [0..1] - additionaldata: HashMap Priv atetransportlink - speedlimit: Speed [0..1] - externalresources: ExternalResource [0..n] - flags: RouteLinkFlag [0..n] - freewayexit: String [0..1] - freewayjunction: String [0..1] - roadnumber: String [0..1] - TMCCodes: TMCCode [0..n] - timezone: Timezone - corridorlevel: int [0..1] - functionalclass: FunctionalClass [0..1] +maneuvers +links +notes 0..* Priv atetransportmaneuv er RouteLink - linkid: LinkId - shape: GeoPolyline - length: Distance - additionaldata: HashMap [0..1] - remaindistance: Distance - remaintime: Duration 0..* 0..* +tolink 0..1 Maneuv er - position: GeoCoordinate - instruction: String - time: DateTime [0..1] +stubs 0..* +fromlink equipment: PlaceEquipment [0..n] PublicTransportLink - nextstopname: String +maneuver nextlink line nextmaneuver 0..1 PublicTransportManeuv er Incident - validityperiod: Period [0..1] - text: String - type: IncidentType - criticality: int [0..1] +incidents 0..* +dynamicspeedinfo 0..1 DynamicSpeedInfo - trafficspeed: Speed [0..1] - traffictime: Duration [0..1] - basespeed: Speed - basetime: Duration - jamfactor: double - jamfactortrend: double [0..1] - confidence: double [0..1] PublicTransportLine - linename: String - lineforeground: Color [0..1] - linebackground: Color [0..1] - linestyle: LineStyle [0..1] - companyname: String - companyshortname: String [0..1] - companylogo: ExternalResource [0..1] - destination: String - flags: PublicTransportLinkFlag [0..n] - type: PublicTransportType - typename: String [0..1] +line entries 0..* RouteSummaryEntry - label: String - distance: Distance RouteLane +lanes 0..* - direction: Direction [1..n] 0..* +selectedlanes - action: PrivateTransportAction - direction: Direction - signpost: String [0..1] - roadname: String - nextroadname: String [0..1] - roadnumber: String [0..1] - nextroadnumber: String [0..1] - roadtemplate: ExternalResource [0..1] - action: PublicTransportAction - stopname: String - platformname: String [0..1] - platformlevel: String [0..1] 11

12 Arbeiten Sie mit Scopes! class Routing Basic API - Domain Model Route - routeid: String - waypoints: Waypoint [2..n] - shape: GeoPolyline - boundingbox: GeoBoundingBox +mode 1 RoutingMode - type: RoutingType - transportmodes: TransportMode [1..n] - trafficmode: TrafficMode [0..1] = "enabled" «basic» - options: RoutingOption [0..n] + getstart() : Waypoint + getdestination() : Waypoint + getmaneuvers() : Maneuver[] + getsegment(maneuver) : RouteSegment +summary 0..1 RouteSummary - distance: Distance - traffictime: Duration [0..1] - basetime: Duration - flags: RouteLinkFlag [0..n] +legs 0..* RouteLeg - start: Waypoint - end: Waypoint - length: Distance - traveltime: Duration +maneuvers 0..* Maneuver - position: GeoCoordinate - instruction: String - time: DateTime [0..1] «basic» - type: ManeuverType - direction: Direction [0..1] Advanced API Basic API Nützlich: Stereotypen im Modell für gefilterte Views 12

13 Challenge #2: Heterogene Plattformen Javascript Objective C on iphone C++ using Qt Java on Android JavaME Enterprise Java Unterschiedliche Programmiermodelle/Paradigmen Unterschiedliche Basisbibliotheken Unterschiedliche Namenskonventionen Dynamische vs. statische Typisierung 13

14 Von der Domäne zur Implementierung Domänenmodell JavaScript Implementierungsmodell Objective-C Implementierungsmodell Qt Implementierungsmodell Implementierungsmodell Backend API Android Implementierungsmodell JavaME Implementierungsmodell 14

15 Code generieren? Domänenmodell Implementierungsmodell Plattformen sind speziell 15 Image: graur codrin, Arvind Balaraman / FreeDigitalPhotos.net

16 XML/Java Mismatch XSD <xs:complextype name="placetype"> <xs:sequence>... <xs:element name="location" type="locationtype" maxoccurs="unbounded"/>... </xs:sequence> </xs:complextype> <Place>... List<LocationType> { loclist = place.getlocation(); Location: [ XML <Location>...</Location> <Location>...</Location> <Location>...</Location>... JSON Java { }, { }, for(locationtype l in loclist) { } ] } </Place> 16

17 XML/Java Mismatch XSD <xs:complextype name="placetype"> <xs:sequence>... <xs:element name="locations > <xs:complextype> <xs:sequence> <xs:element name="location" type="locationtype" maxoccurs="unbounded"/> </xs:sequence> </xs:complextype> </xs:element>... </xs:sequence> </xs:complextype> XML <Place>... <Locations> <Location>...</Location> <Location>...</Location> </Locations> JSON Java PlaceType.Locations { locwrapper = place.getlocations(); Locations: { List<LocationType> loclist = Location: [{ }, { }, ] locwrapper.getlocation(); } } for(locationtype l in loclist) { }... </Place> 17

18 Sprachbarrieren Java boolean contains(geocoordinate c); boolean contains(geoboundingbox b); Objective-C -(BOOL)containsPoint:(LBSPGeoCoordinate *)coord; -(BOOL)contains:(LBSPGeoBoundingBox *)bbox; JavaScript contains: function( coordinate_or_bbox ) { } 18

19 XML/JSON Mismatch Längen von Bezeichnern XML <SearchResponse>... </SearchResponse> JavaScript { } SearchResponse: { } Effizienz von Datenstrukturen XML <Shape>lat1,long1 lat2,long2 lat3,long3</shape> JavaScript { } Shape: ["lat1,long1", "lat2,long2, "lat3,long3"] 19

20 Challenge #3: Heterogene Teams Fünf Länder, zwei Firmen, viele Sprachen und unterschiedliche Philosophien Product Management Mobile & Web NAVTEQ Chicago Illinois iphone & Android NAVTEQ Wayne Pennsylvania JavaME Nokia Kopenhagen Denmark LBSP Services & JS Location API NAVTEQ Eschborn Germany LBSP Services & Client Development Nokia Berlin Germany LBSP Services Development NAVTEQ Kosice Slovakia 20 Qt Mobility SDK Nokia Brisbane Australia

21 Organisatorischer Rahmen Anforderungen aufbereiten Design und Dokumentation Review Implementierung Design- Workshop Approval Produkt- Launch Anforderungen aufbereiten Design und Dokumentation Review Implementierung Design- Workshop Approval 21

22 Lessons Learned Domänenmodell und Implementierungsmodell trennen Laxe Formate wie JSON setzen sich durch Unterschiedliche Anforderungen in Scopes abbilden Stakeholder frühzeitig ins Boot holen Physische Workshops sind wichtig Viel darüber sprechen Fazit: Es hat sich gelohnt! 22