@maccesar/titools 2.0.7 → 2.2.0

package/skills/ti-howtos/references/ios-platform-deep-dives.md

@@ -1,68 +1,5 @@
 # iOS Platform Deep Dives
 
-## Table of Contents
-
-- [iOS Platform Deep Dives](#ios-platform-deep-dives)
-  - [Table of Contents](#table-of-contents)
-  - [1. iOS 17+ Privacy Requirements (Critical)](#1-ios-17-privacy-requirements-critical)
-    - [PrivacyInfo.xcprivacy File](#privacyinfoxcprivacy-file)
-  - [2. Background Services \& Silent Push](#2-background-services--silent-push)
-    - [Overview](#overview)
-    - [Silent Push (Background Update)](#silent-push-background-update)
-  - [3. iCloud Services \& Backup Control](#3-icloud-services--backup-control)
-    - [Disable Individual Backup (Best Practice)](#disable-individual-backup-best-practice)
-    - [Recursive Folder Backup Disable](#recursive-folder-backup-disable)
-  - [4. WatchKit \& Ti.WatchSession](#4-watchkit--tiwatchsession)
-    - [Activate Session](#activate-session)
-    - [Send Message (Immediate)](#send-message-immediate)
-    - [Receive Data from Watch](#receive-data-from-watch)
-  - [5. SiriKit \& Siri Intents](#5-sirikit--siri-intents)
-    - [Configuration in tiapp.xml](#configuration-in-tiappxml)
-    - [Siri Extensions](#siri-extensions)
-  - [6. Spotlight Search (Core Spotlight)](#6-spotlight-search-core-spotlight)
-  - [7. Core Motion Module](#7-core-motion-module)
-    - [Overview](#overview-1)
-    - [Basic Workflow](#basic-workflow)
-    - [Coordinate System](#coordinate-system)
-    - [Accelerometer](#accelerometer)
-    - [Gyroscope](#gyroscope)
-    - [Magnetometer](#magnetometer)
-    - [Device Motion](#device-motion)
-    - [Activity API](#activity-api)
-    - [Pedometer](#pedometer)
-    - [Core Motion Best Practices](#core-motion-best-practices)
-  - [3. Spotlight Search](#3-spotlight-search)
-    - [Overview](#overview-2)
-    - [Creating Searchable Items](#creating-searchable-items)
-    - [Indexing Items](#indexing-items)
-    - [Deleting from Index](#deleting-from-index)
-    - [Handling Search Results](#handling-search-results)
-    - [Best Practices](#best-practices)
-  - [8. Handoff User Activities](#8-handoff-user-activities)
-    - [Handling Incoming Handoff](#handling-incoming-handoff)
-    - [Invalidating Activities](#invalidating-activities)
-    - [Declaring Activity Types in tiapp.xml](#declaring-activity-types-in-tiappxml)
-  - [5. iCloud Services](#5-icloud-services)
-    - [Keychain Storage](#keychain-storage)
-    - [Document Picker](#document-picker)
-    - [CloudKit](#cloudkit)
-  - [6. WatchKit Integration](#6-watchkit-integration)
-    - [Overview](#overview-3)
-    - [Integration Steps](#integration-steps)
-    - [Watch Connectivity](#watch-connectivity)
-  - [7. SiriKit Integration](#7-sirikit-integration)
-    - [Overview](#overview-4)
-    - [Supported Intents (iOS 10+)](#supported-intents-ios-10)
-    - [Implementation](#implementation)
-    - [Voice Shortcuts (iOS 12+)](#voice-shortcuts-ios-12)
-  - [8. Additional iOS Features](#8-additional-ios-features)
-    - [3D Touch (Force Touch)](#3d-touch-force-touch)
-    - [Haptic Feedback](#haptic-feedback)
-    - [Document Interaction](#document-interaction)
-  - [Best Practices Summary](#best-practices-summary)
-
----
-
 ## 1. iOS 17+ Privacy Requirements (Critical)
 Apple requires declaring the use of certain APIs to prevent "fingerprinting".
 
@@ -108,12 +45,71 @@ Allows waking up the app to download content without showing a notification to t
 Ti.App.iOS.addEventListener('silentpush', (e) => {
     // Start download or update
     Ti.API.info(`Data received: ${JSON.stringify(e)}`);
-    
+
     // Mandatory to call upon completion (max 30 seconds)
     Ti.App.iOS.endBackgroundHandler(e.handlerId);
 });
 ```
 
+### Background Fetch
+```javascript
+// Enable in tiapp.xml:
+// <key>UIBackgroundModes</key>
+// <array><string>fetch</string></array>
+
+// Set minimum fetch interval
+Ti.App.iOS.setMinimumBackgroundFetchInterval(Ti.App.iOS.BACKGROUNDFETCHINTERVAL_MIN);
+
+Ti.App.iOS.addEventListener('backgroundfetch', (e) => {
+    // Fetch new data
+    Ti.API.info('Background fetch triggered');
+
+    // Must call endBackgroundHandler when done (max 30 seconds)
+    Ti.App.iOS.endBackgroundHandler(e.handlerId);
+});
+
+// To disable background fetch:
+// Ti.App.iOS.setMinimumBackgroundFetchInterval(Ti.App.iOS.BACKGROUNDFETCHINTERVAL_NEVER);
+```
+
+### URL Session Module
+For large downloads that continue even if the app is suspended, use the `com.titaniumsdk.urlSession` module:
+
+```javascript
+const urlSession = require('com.titaniumsdk.urlSession');
+
+const config = urlSession.createSessionConfiguration({
+    identifier: 'com.myapp.downloads'
+});
+
+const session = urlSession.createSession({
+    configuration: config
+});
+
+// Start a download task
+session.downloadTask({
+    url: 'https://example.com/largefile.zip'
+});
+
+// Monitor progress
+session.addEventListener('downloadprogress', (e) => {
+    Ti.API.info(`Progress: ${e.totalBytesWritten}/${e.totalBytesExpectedToWrite}`);
+});
+
+session.addEventListener('downloadcompleted', (e) => {
+    Ti.API.info(`Download saved to: ${e.data}`);
+});
+
+session.addEventListener('sessioncompleted', (e) => {
+    if (!e.success) {
+        Ti.API.error(`Session error: ${e.errorDescription}`);
+    }
+});
+
+// Invalidate session when no longer needed
+session.invalidateAndCancel();
+```
+
 ## 3. iCloud Services & Backup Control
 
 ### Disable Individual Backup (Best Practice)
@@ -165,6 +161,25 @@ Ti.WatchSession.addEventListener('receivemessage', (e) => {
 });
 ```
 
+### Provisioning Profiles for Watch
+Both the iOS app and WatchKit extension need separate provisioning profiles. Configure in tiapp.xml:
+```xml
+<ios>
+    <extensions>
+        <extension projectPath="extensions/WatchApp/WatchApp.xcodeproj">
+            <target name="WatchApp Extension">
+                <provisioning-profiles>
+                    <device>WATCH_DEV_PROFILE_UUID</device>
+                    <dist-appstore>WATCH_DIST_PROFILE_UUID</dist-appstore>
+                </provisioning-profiles>
+            </target>
+        </extension>
+    </extensions>
+</ios>
+```
+
+> **Note**: For Xcode 8+, ensure your Team ID matches across all targets.
+
 ## 5. SiriKit & Siri Intents
 
 Allows your app to respond to Siri voice commands (Messaging, Payments, Workouts).
@@ -191,6 +206,16 @@ Requires creating an **Intents Extension** in Xcode and adding it to the `extens
 </ios>
 ```
 
+### Implementation Steps
+1. **Register App ID** with SiriKit capability in Apple Developer Portal
+2. **Create Intent Extension** in Xcode (File > New > Target > Intents Extension)
+3. **Configure entitlements** — add `com.apple.developer.siri` entitlement
+4. **Add extension to project** — place in `extensions/` folder
+5. **Register in tiapp.xml** with provisioning profiles for the extension target
+6. **Handle intents** in the native extension code (Swift/Objective-C)
+
+> **Note**: SiriKit requires native code in the Intent Extension. The Titanium app receives results via `continueactivity` events.
+
 ## 6. Spotlight Search (Core Spotlight)
 
 Indexes your app's content to appear in global iOS search results.
@@ -417,7 +442,6 @@ MotionActivity.queryActivity({
 ```javascript
 const Pedometer = CoreMotion.createPedometer();
 
-
 if (Pedometer.isStepCountingAvailable()) {
   // Start live updates
   Pedometer.startPedometerUpdates({
@@ -452,105 +476,6 @@ Pedometer.queryPedometerData({
 4. **Handle errors gracefully** - Sensor may fail or be unavailable
 5. **Test on physical device** - Sensors don't work in simulator
 
-## 3. Spotlight Search
-
-### Overview
-Spotlight Search allows iOS to index your app's content, making it searchable from the home screen.
-
-### Creating Searchable Items
-
-```javascript
-var SearchableItem = Ti.App.iOS.SearchableItem;
-
-var item1 = SearchableItem.createSearchableItem({
-  uniqueIdentifier: 'article-123',
-  domainIdentifier: 'articles',
-  title: 'Titanium SDK Guide',
-  contentDescription: 'Complete guide to Titanium SDK development',
-  thumbnail: articleThumbnailImage,  // Ti.Blob
-  keywords: ['titanium', 'mobile', 'javascript', 'ios', 'android']
-});
-
-var item2 = SearchableItem.createSearchableItem({
-  uniqueIdentifier: 'product-456',
-  domainIdentifier: 'products',
-  title: 'Product Name',
-  contentDescription: 'Product description here',
-  keywords: ['product', 'shopping']
-});
-```
-
-### Indexing Items
-
-```javascript
-var SearchableIndex = Ti.App.iOS.SearchableIndex;
-
-SearchableIndex.indexSearchableItems([item1, item2], function(e) {
-  if (e.success) {
-    Ti.API.info('Indexing successful');
-  } else {
-    Ti.API.error('Indexing failed: ' + e.error);
-  }
-});
-```
-
-### Deleting from Index
-
-```javascript
-// Delete specific items
-SearchableIndex.deleteSearchableItemsWithIdentifiers(['article-123'], function(e) {
-  if (e.success) {
-    Ti.API.info('Deleted successfully');
-  }
-});
-
-// Delete all items in domain
-SearchableIndex.deleteSearchableItemsWithDomainIdentifiers(['articles'], function(e) {
-  if (e.success) {
-    Ti.API.info('Deleted all articles');
-  }
-});
-
-// Delete all
-SearchableIndex.deleteAllSearchableItems(function(e) {
-  if (e.success) {
-    Ti.API.info('Cleared index');
-  }
-});
-```
-
-### Handling Search Results
-
-When user taps a Spotlight result, your app opens with the `continueactivity` event:
-
-```javascript
-Ti.App.iOS.addEventListener('continueactivity', function(e) {
-  if (e.activityType === 'com.apple.core SpotlightQuery') {
-    var identifier = e.userInfo.identifier;
-    var domain = e.userInfo.domainIdentifier;
-
-    Ti.API.info('Spotlight search selected: ' + identifier);
-
-    // Navigate to appropriate content
-    if (domain === 'articles') {
-      openArticle(identifier);
-    } else if (domain === 'products') {
-      openProduct(identifier);
-    }
-  }
-});
-```
-
-**Important**: Use `NSUserActivityTypes` in tiapp.xml to declare supported activity types.
-
-### Best Practices
-
-1. **Index relevant content** - Don't index everything
-2. **Use meaningful keywords** - Help users find content
-3. **Provide thumbnails** - Improve visual recognition
-4. **Keep index updated** - Re-index when content changes
-5. **Delete obsolete items** - Don't clutter search results
-
 ## 8. Handoff User Activities
 
 ```javascript
@@ -601,126 +526,13 @@ UserActivity.invalidate();
 </array>
 ```
 
-## 5. iCloud Services
-
-### Keychain Storage
-
-Securely sync small pieces of data (passwords, tokens) across user's devices.
-
-```javascript
-// Store value
-Ti.App.iOS.setKeychainItem('username', 'john@example.com');
-Ti.App.iOS.setKeychainItem('authToken', 'abc123token');
-
-// Retrieve value
-var username = Ti.App.iOS.getKeychainItem('username');
-
-// Remove value
-Ti.App.iOS.removeKeychainItem('authToken');
-```
-
-**Use for**: Syncing user credentials, preferences, small data.
-
-**Requires** iCloud capability enabled in Xcode project.
-
-### Document Picker
-
-```javascript
-const DocumentPicker = Ti.UI.iOS.createDocumentPicker({
-  mode: Ti.UI.iOS.DOCUMENT_PICKER_MODE_OPEN
-});
-
-DocumentPicker.addEventListener('select', (e) => {
-  const url = e.url;  // File URL
-  Ti.API.info(`Selected: ${url}`);
-
-  // Read file
-  const file = Ti.Filesystem.getFile(url);
-  const contents = file.read();
-});
-
-DocumentPicker.addEventListener('cancel', function(e) {
-  Ti.API.info('Document picker canceled');
-});
-
-// Show picker
-DocumentPicker.show();
-```
-
-**Modes**:
-- `DOCUMENT_PICKER_MODE_OPEN` - Open existing document
-- `DOCUMENT_PICKER_MODE_EXPORT` - Export to document provider
-- `DOCUMENT_PICKER_MODE_IMPORT` - Import copy of document
-- `DOCUMENT_PICKER_MODE_MOVE` - Move document to app's sandbox
-
-### CloudKit
-
-For more complex iCloud data sync, consider using CloudKit modules or Hyperloop.
-
-## 6. WatchKit Integration
-
-### Overview
-Integrate Apple Watch apps built in Xcode with Titanium app.
-
-### Integration Steps
-
-1. **Create WatchKit app** in Xcode
-2. **Add App Group** to both iOS and Watch targets
-3. **Use App Group** for shared data:
-
-```javascript
-// In Titanium app, use App Group container
-var container = 'group.com.myapp.shared';
-var sharedDefaults = Ti.App.iOS.createUserDefaults({ suiteName: container });
-
-sharedDefaults.setString('watchData', JSON.stringify(data));
-```
-
-4. **Watch app reads shared data** using same App Group container
-
-### Watch Connectivity
-
-For bidirectional communication, use Watch Connectivity framework via Hyperloop or modules.
-
-## 7. SiriKit Integration
-
-### Overview
-SiriKit allows your app to handle specific intents via Siri voice commands.
-
-### Supported Intents (iOS 10+)
-- Messaging (send/read messages)
-- Payments (send/request money)
-- Workouts (start/stop/pause/resume)
-- Rides (book ride)
-- Photo (search/send photos)
-- VoIP calling
-
-### Implementation
-
-Requires native module or Hyperloop to implement Intent Extension.
-
-**Basic steps**:
-1. Define supported intents in tiapp.xml
-2. Create Intent Extension in Xcode
-3. Handle intents in extension code
-4. Provide UI for Siri interaction
-
-### Voice Shortcuts (iOS 12+)
-
-Add custom voice shortcuts for app actions:
-
-```javascript
-var INVoiceShortcut = Ti.UI.iOS.createINVoiceShortcut({
-  phrase: 'Open My Article',
-  activityType: 'com.myapp.reading-article',
-  userInfo: { articleId: '123' }
-});
-
-// Present to user for recording
-INVoiceShortcut.present();
-```
+### Requirements
+- Both devices must be signed into the same iCloud account
+- Bluetooth LE must be enabled on both devices
+- Both devices must be on the same Wi-Fi network
+- Test with Safari first to verify Handoff works between your devices
 
-## 8. Additional iOS Features
+## 9. Additional iOS Features
 
 ### 3D Touch (Force Touch)
 

package/skills/ti-howtos/references/local-data-sources.md

@@ -1,41 +1,5 @@
 # Local Data Sources
 
-## Table of Contents
-
-- [Local Data Sources](#local-data-sources)
-  - [Table of Contents](#table-of-contents)
-  - [1. Filesystem Access and Storage](#1-filesystem-access-and-storage)
-    - [Modules Overview](#modules-overview)
-    - [Storage Locations](#storage-locations)
-    - [File Operations](#file-operations)
-      - [Getting a File Handle](#getting-a-file-handle)
-      - [Writing Files](#writing-files)
-      - [Reading Files](#reading-files)
-      - [Appending](#appending)
-      - [Creating/Copying](#creatingcopying)
-      - [Renaming](#renaming)
-      - [Deleting](#deleting)
-    - [Directory Operations](#directory-operations)
-    - [Case Sensitivity Warning](#case-sensitivity-warning)
-  - [2. SQLite Database](#2-sqlite-database)
-    - [Opening Databases](#opening-databases)
-    - [Querying Data](#querying-data)
-    - [Parameterized Queries](#parameterized-queries)
-    - [Data Modification](#data-modification)
-    - [**CRITICAL**: Always Close Connections](#critical-always-close-connections)
-  - [3. Properties API (Ti.App.Properties)](#3-properties-api-tiappproperties)
-    - [Overview](#overview)
-    - [Data Type Methods](#data-type-methods)
-    - [Usage Examples](#usage-examples)
-    - [Storing Complex Objects as JSON](#storing-complex-objects-as-json)
-    - [Platform Storage](#platform-storage)
-  - [4. Advanced Data Manipulation (Buffer, Codec, and Streams)](#4-advanced-data-manipulation-buffer-codec-and-streams)
-  - [5. Choosing a Persistence Strategy](#5-choosing-a-persistence-strategy)
-    - [Decision Guide](#decision-guide)
-    - [Best Practices](#best-practices)
-
----
-
 ## 1. Filesystem Access and Storage
 
 ### Modules Overview
@@ -140,6 +104,14 @@ Android and Mobile Web use case-sensitive filesystems. File names referenced in
 
 ## 2. SQLite Database
 
+### Installing a Pre-populated Database
+Ship a database with your app and install it on first launch:
+```javascript
+// Copies db from Resources/ (or app/assets/) to applicationDataDirectory
+const db = Ti.Database.install('seeds/mydata.sqlite', 'mydata');
+// On subsequent launches, install() just opens the existing database
+```
+
 ### Opening Databases
 
 ```javascript
@@ -188,7 +160,8 @@ db.execute(`INSERT INTO users (name, age) VALUES ('${name}', ${age})`);
 ```javascript
 // INSERT
 db.execute('INSERT INTO users (name, age) VALUES (?, ?)', ['Jane', 30]);
-const lastId = db.lastInsertRowId;  // Get inserted ID
+const lastId = db.lastInsertRowId;    // ID of the last inserted row
+const affected = db.rowsAffected;     // number of rows changed by last statement
 
 // UPDATE
 db.execute('UPDATE users SET age = ? WHERE name = ?', [31, 'Jane']);
@@ -198,6 +171,41 @@ const rowsAffected = db.rowsAffected;
 db.execute('DELETE FROM users WHERE age < ?', [18]);
 ```
 
+### Transactions for Batch Operations
+Use transactions to dramatically improve performance for multiple inserts/updates:
+```javascript
+const db = Ti.Database.open('mydb');
+db.execute('BEGIN');
+try {
+    for (let i = 0; i < items.length; i++) {
+        db.execute('INSERT INTO products (name, price) VALUES (?, ?)', items[i].name, items[i].price);
+    }
+    db.execute('COMMIT');
+} catch (e) {
+    db.execute('ROLLBACK');
+    Ti.API.error(`Transaction failed: ${e.message}`);
+}
+db.close();
+```
+
+> **Performance**: Wrapping 1000 inserts in a transaction can be 10-100x faster than individual inserts.
+
+### SQLite Limitations
+- No `FULL OUTER JOIN` support — use `LEFT JOIN` with `UNION`
+- Limited `ALTER TABLE` — can only `ADD COLUMN` or `RENAME TABLE`, cannot drop/modify columns
+- No built-in referential integrity (foreign key enforcement) — enable with `PRAGMA foreign_keys = ON`
+- No native boolean type — use INTEGER (0/1)
+
+### Disable iCloud Backup for Databases (iOS)
+iOS automatically backs up databases to iCloud. For large or recreatable databases, disable this:
+```javascript
+const db = Ti.Database.open('mydb');
+db.file.setRemoteBackup(false);
+db.close();
+```
+
+> **Important**: Apple may reject apps that back up large recreatable data to iCloud.
+
 ### **CRITICAL**: Always Close Connections
 
 ```javascript

package/skills/ti-howtos/references/location-and-maps.md

@@ -1,33 +1,5 @@
 # Location Services and Maps
 
-## Table of Contents
-
-- [Location Services and Maps](#location-services-and-maps)
-  - [Table of Contents](#table-of-contents)
-  - [1. GPS Position Tracking](#1-gps-position-tracking)
-    - [FusedLocationProvider (Android)](#fusedlocationprovider-android)
-    - [Accuracy Configuration](#accuracy-configuration)
-    - [Android Configuration Modes](#android-configuration-modes)
-    - [One-Time Position](#one-time-position)
-    - [Continuous Monitoring](#continuous-monitoring)
-    - [Lifecycle Management (Critical for Battery)](#lifecycle-management-critical-for-battery)
-    - [Compass/Heading](#compassheading)
-  - [Geocoding](#geocoding)
-    - [Forward Geocoding (Address → Coordinates)](#forward-geocoding-address--coordinates)
-    - [Reverse Geocoding (Coordinates → Places)](#reverse-geocoding-coordinates--places)
-  - [2. Native Maps (Platform-Specific Details)](#2-native-maps-platform-specific-details)
-  - [Common Map Patterns](#common-map-patterns)
-    - [Add Annotation After Map Creation](#add-annotation-after-map-creation)
-    - [Remove Annotation](#remove-annotation)
-    - [Remove All Annotations](#remove-all-annotations)
-    - [Select Annotation Programmatically](#select-annotation-programmatically)
-    - [Deselect Annotation](#deselect-annotation)
-    - [Set Region with Animation](#set-region-with-animation)
-    - [Zoom to Annotations](#zoom-to-annotations)
-    - [Best Practices](#best-practices)
-
----
-
 ## 1. GPS Position Tracking
 
 ### FusedLocationProvider (Android)
@@ -51,6 +23,8 @@ Ti.Geolocation.headingFilter = 5;   // degrees - only fire if heading changed X
 Ti.Geolocation.preferredProvider = Ti.Geolocation.PROVIDER_GPS; // or PROVIDER_NETWORK
 ```
 
+> **Note**: On many Android devices, a low-precision "passive" location provider is always enabled, even when the user disables GPS and Network providers. Therefore `Ti.Geolocation.locationServicesEnabled` may always return `true` on these devices.
+
 ### Android Configuration Modes
 
 **Simple Mode** (ACCURACY_HIGH/LOW):
@@ -69,6 +43,34 @@ Ti.Geolocation.Android.addLocationProvider(providerGps);
 Ti.Geolocation.Android.manualMode = true;
 ```
 
+### Location Permissions
+
+```javascript
+// Check permissions
+if (Ti.Geolocation.hasLocationPermissions(Ti.Geolocation.AUTHORIZATION_WHEN_IN_USE)) {
+    startTracking();
+} else {
+    Ti.Geolocation.requestLocationPermissions(Ti.Geolocation.AUTHORIZATION_WHEN_IN_USE, (e) => {
+        if (e.success) {
+            startTracking();
+        } else {
+            Ti.API.error(`Permission denied: ${e.error}`);
+        }
+    });
+}
+```
+
+**iOS plist keys** (tiapp.xml):
+```xml
+<key>NSLocationWhenInUseUsageDescription</key>
+<string>We need your location to show nearby places</string>
+<!-- For background location: -->
+<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
+<string>We need background location for navigation</string>
+```
+
+> **Note (iOS 11+)**: You must include `NSLocationAlwaysAndWhenInUseUsageDescription` even when requesting "Always" permission. Users can still choose "When in Use" even if your app requests "Always".
+
 ### One-Time Position
 
 ```javascript
@@ -147,6 +149,12 @@ Ti.Geolocation.addEventListener('heading', (e) => {
 });
 ```
 
+The heading event object includes:
+- `heading.magneticHeading` — degrees relative to magnetic north
+- `heading.trueHeading` — degrees relative to true north (requires location)
+- `heading.accuracy` — deviation in degrees (lower is better)
+- `heading.x`, `heading.y`, `heading.z` — raw magnetometer data (microteslas)
+
 ---
 
 ## Geocoding
@@ -161,6 +169,17 @@ Ti.Geolocation.forwardGeocoder('440 Bernardo Ave Mountain View CA', (e) => {
 });
 ```
 
+**With error handling:**
+```javascript
+Ti.Geolocation.forwardGeocoder('1600 Amphitheatre Pkwy, Mountain View, CA', (e) => {
+    if (!e.success || e.error) {
+        Ti.API.error(`Geocoding failed: ${e.error}`);
+        return;
+    }
+    Ti.API.info(`Lat: ${e.latitude}, Lng: ${e.longitude}`);
+});
+```
+
 ### Reverse Geocoding (Coordinates → Places)
 
 ```javascript