@maccesar/titools 2.10.1 → 3.2.0

package/skills/ti-howtos/references/google-maps-v2.md

@@ -1,172 +0,0 @@
-# Google Maps v2 for Android
-
-Guide to implementing native maps on Android using the `ti.map` module (v2).
-
-## 1. Initial configuration
-
-### Module installation
-Add the module to `tiapp.xml`:
-
-```xml
-<modules>
-    <module platform="android">ti.map</module>
-</modules>
-```
-
-### Obtaining an API key (Google Cloud Console)
-1. Create a project in the Google Cloud Console.
-2. Enable "Maps SDK for Android".
-3. Generate an API key. You will need the application ID from your `tiapp.xml` and the SHA-1 fingerprint from your keystore.
-
-#### Get SHA-1 (debug)
-```bash
-keytool -list -v -keystore ~/Library/Application\ Support/titanium/mobilesdk/osx/<VERSION>/android/dev_keystore
-```
-Default password: empty (press Enter).
-
-### Configure tiapp.xml
-Add the API key in the Android section:
-
-```xml
-<android xmlns:android="http://schemas.android.com/apk/res/android">
-    <manifest>
-        <application>
-            <meta-data android:name="com.google.android.maps.v2.API_KEY" android:value="YOUR_API_KEY_HERE"/>
-        </application>
-    </manifest>
-</android>
-```
-
-## 2. Google Play Services verification
-
-Verify availability before rendering the map:
-
-```javascript
-const MapModule = require('ti.map');
-const rc = MapModule.isGooglePlayServicesAvailable();
-
-switch (rc) {
-  case MapModule.SUCCESS:
-    Ti.API.info('Google Play Services available');
-    break;
-  case MapModule.SERVICE_MISSING:
-    Ti.API.error('Google Play Services is missing');
-    break;
-  case MapModule.SERVICE_VERSION_UPDATE_REQUIRED:
-    Ti.API.error('Google Play Services needs update');
-    break;
-  case MapModule.SERVICE_DISABLED:
-    Ti.API.error('Google Play Services is disabled');
-    break;
-  case MapModule.SERVICE_INVALID:
-    Ti.API.error('Google Play Services is invalid');
-    break;
-}
-```
-
-## 3. Using the map view
-
-### Basic creation
-```javascript
-const MapModule = require('ti.map');
-const mapView = MapModule.createView({
-  mapType: MapModule.NORMAL_TYPE,
-  userLocation: true,
-  traffic: true, // Show real-time traffic
-  animate: true,
-  region: {
-    latitude: -33.87365,
-    longitude: 151.20689,
-    latitudeDelta: 0.1,
-    longitudeDelta: 0.1
-  }
-});
-```
-
-### Map types
-- `MapModule.NORMAL_TYPE`: standard map
-- `MapModule.SATELLITE_TYPE`: satellite imagery
-- `MapModule.TERRAIN_TYPE`: terrain map
-- `MapModule.HYBRID_TYPE`: satellite with labels
-
-## 4. Advanced annotations (pins)
-
-```javascript
-const opera = MapModule.createAnnotation({
-  latitude: -33.8569,
-  longitude: 151.2153,
-  title: 'Sydney Opera House',
-  subtitle: 'NSW, Australia',
-  pincolor: MapModule.ANNOTATION_VIOLET,
-  image: 'custom_pin.png', // Custom image
-  draggable: true, // Allow pin dragging
-  // Complete custom view (replaces the pin)
-  customView: Ti.UI.createLabel({ text: 'Pin', backgroundColor: 'white' })
-});
-
-mapView.addAnnotation(opera);
-```
-
-### Additional annotation properties
-- `customView`: a `Ti.UI.View` that replaces the entire annotation (takes precedence over `image`)
-- `centerOffset`: `{x, y}` offset for the annotation relative to the coordinate
-- `canShowCallout`: whether tapping shows the info bubble (default: `true`)
-
-Precedence: `customView` > `image` > default pin. For buttons: `leftView`/`rightView` take precedence over `leftButton`/`rightButton`.
-
-### Available pin colors
-`ANNOTATION_AZURE`, `BLUE`, `CYAN`, `GREEN`, `MAGENTA`, `ORANGE`, `RED`, `ROSE`, `VIOLET`, `YELLOW`.
-
-## 5. Routes (polylines)
-
-```javascript
-const route = MapModule.createRoute({
-  width: 5,
-  color: '#f00',
-  points: [
-    { latitude: -33.8569, longitude: 151.2153 },
-    { latitude: -33.8522, longitude: 151.2105 }
-  ]
-});
-
-mapView.addRoute(route);
-```
-
-## 6. Critical events
-
-```javascript
-// Detect click on annotation or its buttons
-mapView.addEventListener('click', (e) => {
-  if (e.clicksource === 'pin') {
-    Ti.API.info(`Pin clicked: ${e.title}`);
-  }
-});
-
-// Detect drag state changes
-// e.newState holds the drag state constant; e.annotation holds the annotation object
-mapView.addEventListener('pinchangedragstate', (e) => {
-  if (e.newState === MapModule.ANNOTATION_DRAG_STATE_END) {
-    Ti.API.info(`Dropped at: ${e.annotation.latitude}, ${e.annotation.longitude}`);
-  }
-});
-// Drag states: ANNOTATION_DRAG_STATE_START, ANNOTATION_DRAG_STATE_END
-
-// Detect region changes
-mapView.addEventListener('regionchanged', (e) => {
-  Ti.API.info(`New region: ${e.latitude}, ${e.longitude} (delta: ${e.latitudeDelta}, ${e.longitudeDelta})`);
-});
-
-// Detect complete rendering
-mapView.addEventListener('complete', (e) => {
-  Ti.API.info('Map loaded');
-});
-```
-
-## 7. Migration from legacy Titanium.Map
-
-The `ti.map` module replaced the legacy `Titanium.Map` API. Key differences: use `NORMAL_TYPE` instead of `STANDARD_TYPE`, `ANNOTATION_VIOLET` instead of `ANNOTATION_PURPLE`, and routes are created with `Map.createRoute()` instead of abstract data types. Multiple MapView instances are supported.
-
-## 8. Limitations and troubleshooting
-- Single map: Android (legacy) only allows one MapView instance per application. v2 allows multiple views.
-- Blank map: verify the API key and make sure `android:anyDensity` is not set to true in the manifest if you use old resolutions.
-- Simulator: Google Maps v2 is not compatible with the standard emulator without x86 Google Play Services. Test on a real device.

package/skills/ti-howtos/references/ios-map-kit.md

@@ -1,149 +0,0 @@
-# iOS Map Kit
-
-Guide to implementing native maps on iOS with the `ti.map` module.
-
-## 1. Initial configuration
-
-### Module installation
-Add the module to `tiapp.xml`:
-
-```xml
-<modules>
-    <module platform="iphone">ti.map</module>
-</modules>
-```
-
-### Location permissions (Info.plist)
-Add the required usage descriptions in `tiapp.xml`:
-
-```xml
-<ios>
-    <plist>
-        <dict>
-            <key>NSLocationWhenInUseUsageDescription</key>
-            <string>We need your location to show it on the map.</string>
-            <key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
-            <string>We need continuous location access for navigation.</string>
-        </dict>
-    </plist>
-</ios>
-```
-
-iOS 11+: include both `NSLocationWhenInUseUsageDescription` and `NSLocationAlwaysAndWhenInUseUsageDescription`. Users can still choose "When in Use" even if you request "Always".
-
-## 2. Using the map view
-
-### Basic creation
-```javascript
-const MapModule = require('ti.map');
-const mapView = MapModule.createView({
-  mapType: MapModule.NORMAL_TYPE, // Also: SATELLITE_TYPE, HYBRID_TYPE, STANDARD_TYPE (alias for NORMAL_TYPE with labels)
-  userLocation: true,
-  rotatesEnabled: true, // Allow two-finger rotation
-  region: {
-    latitude: 48.8582,
-    longitude: 2.2945,
-    latitudeDelta: 0.02,
-    longitudeDelta: 0.02
-  }
-});
-```
-
-## 3. 3D camera (perspective)
-
-iOS lets you tilt and rotate the map for 3D views.
-
-Important: the map must be visible on screen before using camera APIs. Wait for the `complete` event before calling `animateCamera()` or setting camera properties.
-
-```javascript
-const myCam = MapModule.createCamera({
-  altitude: 300, // meters above ground
-  centerCoordinate: { latitude: 48.8582, longitude: 2.2945 },
-  heading: -45, // angle relative to North
-  pitch: 60 // tilt angle downward
-});
-
-// Apply camera with animation
-mapView.animateCamera({
-  camera: myCam,
-  curve: Ti.UI.ANIMATION_CURVE_EASE_IN,
-  duration: 1000
-});
-
-// Additional 3D view properties
-mapView.pitchEnabled = true;
-mapView.showsBuildings = true; // 3D buildings
-```
-
-## 4. iOS annotations
-
-### iOS pin colors
-iOS supports only three pin color constants (unlike Android's ten):
-- `MapModule.ANNOTATION_GREEN`
-- `MapModule.ANNOTATION_PURPLE`
-- `MapModule.ANNOTATION_RED`
-
-### System buttons and callouts
-iOS allows native buttons in the pin callout (popup window).
-
-```javascript
-const bridge = MapModule.createAnnotation({
-  latitude: -33.8522,
-  longitude: 151.2105,
-  title: 'Harbour Bridge',
-  subtitle: 'Port Jackson',
-  pincolor: MapModule.ANNOTATION_PURPLE,
-  // iOS system buttons in the callout
-  leftButton: Ti.UI.iOS.SystemButton.INFO_DARK,
-  rightButton: Ti.UI.iOS.SystemButton.CONTACT_ADD,
-  canShowCallout: true // Controls whether tapping the annotation shows the callout bubble (default: true)
-});
-
-mapView.addAnnotation(bridge);
-```
-
-### Center offset
-If you use a custom pin image that is not centered:
-
-```javascript
-const customPin = MapModule.createAnnotation({
-  image: 'flag.png',
-  centerOffset: { x: 10, y: -20 } // Visually moves the pin
-});
-```
-
-## 5. Advanced routes
-
-### Overlay levels
-Control whether the route appears above labels or above roads.
-
-```javascript
-const route = MapModule.createRoute({
-  points: routePoints,
-  color: '#00f',
-  width: 4,
-  level: MapModule.OVERLAY_LEVEL_ABOVE_LABELS // default
-  // or MapModule.OVERLAY_LEVEL_ABOVE_ROADS (below labels)
-});
-```
-
-## 6. Events
-
-Key map events: `click`, `complete` (map loaded), `regionchanged`, `pinchangedragstate`.
-
-Same as Android, but with specialized `clicksource` values for system buttons:
-
-```javascript
-mapView.addEventListener('click', (e) => {
-  if (e.clicksource === 'leftButton' || e.clicksource === 'rightButton') {
-    Ti.API.info('Callout button clicked');
-  }
-});
-
-// e.newState holds the drag state constant; e.annotation holds the annotation object
-mapView.addEventListener('pinchangedragstate', (e) => {
-  if (e.newState === MapModule.ANNOTATION_DRAG_STATE_END) {
-    Ti.API.info(`Dropped at: ${e.annotation.latitude}, ${e.annotation.longitude}`);
-  }
-});
-```