{"_id":"@adobe/cordova-acpplacesmonitor","_rev":"95-e28578a365f03d0f3dfc203f8bc5f7d2","name":"@adobe/cordova-acpplacesmonitor","dist-tags":{"latest":"0.0.1"},"versions":{"0.0.1":{"name":"@adobe/cordova-acpplacesmonitor","version":"0.0.1","keywords":["ecosystem:cordova","adobe","places monitor","acpplacesmonitor","marketing","cordova-android","cordova-ios"],"author":{"name":"Adobe"},"license":"Apache-2.0","_id":"@adobe/cordova-acpplacesmonitor@0.0.1","maintainers":[{"name":"rymorale","email":"ryanmorales@gmail.com"},{"name":"amadt5","email":"amadt5@gmail.com"},{"name":"symanovi","email":"symanovi@adobe.com"},{"name":"mirea","email":"mirea@adobe.com"},{"name":"dgrossen","email":"dangrossen@gmail.com"},{"name":"tmathern","email":"mathern@adobe.com"},{"name":"dstrangio","email":"deirdra.strangio@gmail.com"},{"name":"cjchapman","email":"cchapman@adobe.com"},{"name":"addb","email":"arjun.d.bhadra@gmail.com"},{"name":"jdelbick","email":"jamie.delbick@gmail.com"},{"name":"sbenedicadb","email":"sbenedic@adobe.com"},{"name":"surajpindoria","email":"pindoria.suraj@gmail.com"},{"name":"jasonwaters","email":"watersj@gmail.com"},{"name":"alvarorahul","email":"alvarorahul@gmail.com"},{"name":"choffmann-adobe","email":"choffman@adobe.com"},{"name":"bgaurav","email":"FINDGAURAV@GMAIL.COM"},{"name":"sirugh","email":"stephenrugh@gmail.com"},{"name":"czerneck","email":"czerneck@adobe.com"},{"name":"sangeetha.krishnan","email":"sangeetha5491@gmail.com"},{"name":"aspro83","email":"danniintheus@gmail.com"},{"name":"devongovett","email":"devongovett@gmail.com"},{"name":"dompuiu","email":"dompuiu@gmail.com"},{"name":"bglowacki","email":"bartosz.glow@gmail.com"},{"name":"ronen","email":"ronen@barzel.org"},{"name":"fmeschbe","email":"fmeschbe@adobe.com"},{"name":"natebaldwin","email":"natebaldwindesign@gmail.com"},{"name":"msagolj","email":"msagolj@adobe.com"},{"name":"richardhand","email":"pid90611@adobe.com"},{"name":"jckautzmann","email":"jkautzma@adobe.com"},{"name":"andreea_dracea","email":"andreeadracea@yahoo.com"},{"name":"bpauli","email":"mail@bpauli.de"},{"name":"vladbailescu","email":"vlad@bailescu.ro"},{"name":"mfrisbey","email":"mark_f79@hotmail.com"},{"name":"himar","email":"himar@adobe.com"},{"name":"bbythewa","email":"bbythewa@adobe.com"},{"name":"dcpfsdk","email":"dcpfsdk@adobe.com"},{"name":"jianliao79","email":"jian.liao@gmail.com"},{"name":"ibaratz","email":"ibaratz@adobe.com"},{"name":"alexkli","email":"alexander@klimetschek.de"},{"name":"meryllblanchet","email":"meryll@adobeio.com"},{"name":"moritzraho","email":"raho.mr@gmail.com"},{"name":"justinedelson","email":"justin@justinedelson.com"},{"name":"icaraps","email":"icaraps@hotmail.com"},{"name":"ashryan","email":"sayhi@ashryan.io"},{"name":"korra","email":"npmjs.karo@cupdev.net"},{"name":"nporter-adbe","email":"nporter@adobe.com"},{"name":"aaronius","email":"aaron@aaronhardy.com"},{"name":"hirenoble","email":"hirenanandshah@outlook.com"},{"name":"benjamind","email":"ben@delarre.net"},{"name":"yoshikinoko","email":"yoshikinoko@gmail.com"},{"name":"goya","email":"brettrudd@gmail.com"},{"name":"rofe","email":"npm@rofe.com"},{"name":"purplecabbage","email":"purplecabbage@gmail.com"},{"name":"krisnye","email":"krisnye@gmail.com"},{"name":"kerrishotts","email":"kerrishotts@gmail.com"},{"name":"dpfister","email":"dominique.pfister@gmail.com"},{"name":"kptdobe","email":"kptdobe@gmail.com"},{"name":"macdonst","email":"simon.macdonald@gmail.com"},{"name":"shazron","email":"shazron@gmail.com"},{"name":"aemsites","email":"meyer@adobe.com"},{"name":"stefan-guggisberg","email":"sg@adobe.com"},{"name":"jfkhoury","email":"jfkhoury@gmail.com"},{"name":"marbec","email":"mabecker@adobe.com"},{"name":"tripod","email":"tripod@bocanegra.ch"},{"name":"garthdb","email":"garthdb@gmail.com"},{"name":"lazd","email":"lazdnet@gmail.com"},{"name":"adobe-admin","email":"grp-opensourceoffice@adobe.com"},{"name":"target-admin","email":"ciocanu@adobe.com"},{"name":"adobe-behance","email":"sedunn@adobe.com"},{"name":"trieloff","email":"lars@trieloff.net"}],"homepage":"https://github.com/adobe/cordova-acpplacesmonitor#readme","bugs":{"url":"https://github.com/adobe/cordova-acpplacesmonitor/issues"},"dist":{"shasum":"b6128eb805ddd1899d314db578fd477c125b965b","tarball":"https://registry.npmjs.org/@adobe/cordova-acpplacesmonitor/-/cordova-acpplacesmonitor-0.0.1.tgz","fileCount":17,"integrity":"sha512-Kjf/w8imeTMEUeBf5Db73RIrxMCmcuxtg31JGC600uYn0VR7NUsRk/yiT96u7bY2e8F+MRGK+t1xYSxMGE9T0Q==","signatures":[{"sig":"MEUCIQCngh6URZaPyLkcTOV9lbqXuCtS3B2Q1PRcpCr791CkVAIgHtx9jSwlylBzqyxPDWiZ6qaEB/J4Vh2pDbOFPerwhvY=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":53106,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJh1v66CRA9TVsSAnZWagAA848P/R8VS+2A9wsw1El4nZZz\npvZwtqCVBR9+EFdTezQWJKhq+5is9VRfoCcNZld8I5cLbZiO9vgHr9NrSKW+\nxT1lYdhT72xp7EnZf5zBszku4W/smQKlfFsGFwNCy//LSyqCle3X3mhJTZxl\nZOfATEEq5tVScP7xKM1Vwj6pTrHUJuMBzEQP4wC59xEzhyLeoghppv+dSpF5\nvHY+NWxgwYx9eRICb6FFkKZ8L1xybeMTLD039I1ruAZC84+GadKbi1d1XLGe\nooQD3KMR4ugZyV5kIWLhtY2cE4XKhrFxFVaKhREmaEfzwssl9hU94kkykhEB\nvs8tmaQsu1IFsqZTS9jt9dP830FKsWQB57ufYzZuSR7ZwyneiSIN6RmWU+fk\ndJRKwzkzz2Jv37BZgUFUPiShBWF/Jmfb8RaLE5UzxIVIi7WJaKlsHyNKuDw7\nhrRRFw1Xn8+XDkuBcdBE561bTs81Q+rDsjc/IaBBAWbjrH61w7tvHWZejsMF\nlyylSCFdNNEkqWDBi2cxwTppFHpQ62oxVsEoHIn+VfO6uFndDVLc8IO4CniW\nr53HQ+PrD3N5rTeKoZJvwnWrSrgwJHVpyEHBpCDH8X38PhwPfLmeGjDNVPbC\nYpLAa0cdZKsF69zbX6VO/WiF7lyphuF21m/SaJP/cafUcZA7WyaIUrZ/gxhl\nMuoj\r\n=0yjn\r\n-----END PGP SIGNATURE-----\r\n"},"cordova":{"id":"cordova-acpplacesmonitor","platforms":["android","ios"]},"gitHead":"f93dc15c1ef2064cfa42f324385e5336833ca35a","_npmUser":{"name":"rymorale","email":"ryanmorales@gmail.com"},"deprecated":"Package no longer supported (underlying SDK deprecated)","repository":{"url":"git+https://github.com/adobe/cordova-acpplacesmonitor.git","type":"git"},"_npmVersion":"6.12.1","description":"Adobe Experience Platform - Places Monitor plugin for Cordova apps.","directories":{},"_nodeVersion":"13.1.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cordova-acpplacesmonitor_0.0.1_1593038245343_0.048369623547053875","host":"s3://npm-registry-packages"}}},"time":{"created":"2020-06-24T22:37:25.089Z","modified":"2026-10-01T01:32:51.194Z","0.0.1":"2020-06-24T22:37:25.485Z"},"bugs":{"url":"https://github.com/adobe/cordova-acpplacesmonitor/issues"},"author":{"name":"Adobe"},"license":"Apache-2.0","homepage":"https://github.com/adobe/cordova-acpplacesmonitor#readme","keywords":["ecosystem:cordova","adobe","places monitor","acpplacesmonitor","marketing","cordova-android","cordova-ios"],"repository":{"url":"git+https://github.com/adobe/cordova-acpplacesmonitor.git","type":"git"},"description":"Adobe Experience Platform - Places Monitor plugin for Cordova apps.","maintainers":[{"email":"mabecker@adobe.com","name":"marbec"},{"email":"tripod@bocanegra.ch","name":"tripod"},{"email":"garthdb@gmail.com","name":"garthdb"},{"email":"lazdnet@gmail.com","name":"lazd"},{"email":"grp-opensourceoffice@adobe.com","name":"adobe-admin"},{"email":"patrickfulton@gmail.com","name":"patrickfulton"},{"email":"lars@trieloff.net","name":"trieloff"},{"email":"krisnye@gmail.com","name":"krisnye"},{"email":"dcpfsdk@adobe.com","name":"dcpfsdk"},{"email":"natebaldwindesign@gmail.com","name":"natebaldwin"},{"email":"devongovett@gmail.com","name":"devongovett"},{"email":"danniintheus@gmail.com","name":"aspro83"},{"email":"symanovi@adobe.com","name":"symanovi"},{"email":"dominique.pfister@gmail.com","name":"dpfister"},{"email":"sg@adobe.com","name":"stefan-guggisberg"},{"email":"npm@rofe.com","name":"rofe"},{"email":"kptdobe@gmail.com","name":"kptdobe"},{"email":"halls@adobe.com","name":"adobehalls"},{"email":"bradjohn@adobe.com","name":"fullcolorcoder"},{"email":"djaeggi@adobe.com","name":"djaeggi"},{"email":"dylandepass@gmail.com","name":"dylandepass"},{"email":"mhaack@adobe.com","name":"mhaack"},{"email":"amol@adobe.com","name":"amol-anand"},{"email":"stopp@adobe.com","name":"stopp-adobe"},{"email":"namarora@adobe.com","name":"namarora"},{"email":"doten@adobe.com","name":"doten"},{"email":"schmidt@adobe.com","name":"duh_schmidt"},{"email":"astha.bhargava23@gmail.com","name":"asthabh23"},{"email":"aljoseph@adobe.com","name":"aljoseph"},{"email":"zouhir.dahbi@outlook.com","name":"zdahbi"},{"email":"tuicu@adobe.com","name":"tuicu"},{"email":"fmeschbe@adobe.com","name":"fmeschbe"}],"readme":"\n# Adobe Experience Platform - Places Monitor plugin for Cordova apps\n\n[![CI](https://github.com/adobe/cordova-acpplacesmonitor/workflows/CI/badge.svg)](https://github.com/adobe/cordova-acpplacesmonitor/actions)\n[![npm](https://img.shields.io/npm/v/@adobe/cordova-acpplacesmonitor)](https://www.npmjs.com/package/@adobe/cordova-acpplacesmonitor)\n[![GitHub](https://img.shields.io/github/license/adobe/cordova-acpplacesmonitor)](https://github.com/adobe/cordova-acpplacesmonitor/blob/master/LICENSE)\n\n- [Prerequisites](#prerequisites)  \n- [Installation](#installation)\n- [Usage](#usage)  \n- [Running Tests](#running-tests)\n- [Sample App](#sample-app)\n- [Additional Cordova Plugins](#additional-cordova-plugins)\n- [Contributing](#contributing)  \n- [Licensing](#licensing)  \n\n## Prerequisites  \n\nCordova is distributed via [Node Package Management](https://www.npmjs.com/) (aka - `npm`).  \n\nIn order to install and build Cordova applications you will need to have `Node.js` installed. [Install Node.js](https://nodejs.org/en/).  \n\nOnce Node.js is installed, you can install the Cordova framework from terminal:  \n\n```  \nsudo npm install -g cordova  \n```\n\n## Installation\n\nTo start using the Places Monitor plugin for Cordova, navigate to the directory of your Cordova app and install the plugin:\n```\ncordova plugin add https://github.com/adobe/cordova-acpplacesmonitor.git\n```\nCheck out the documentation for help with APIs\n\n## Usage\n\n##### Getting the SDK version:\n```js\nACPPlacesMonitor.extensionVersion(function(version){  \n    console.log(version);\n}, function(error){  \n    console.log(error);  \n});\n```\n##### Registering the extension with ACPCore and starting the Places Monitor:  \n\n##### **iOS**\nWithin the App's application:didFinishLaunchingWithOptions, register the SDK extensions:\n```objective-c\n#import \"ACPCore.h\"\n#import \"ACPPlaces.h\"\n#import \"ACPPlacesMonitor.h\"\n\n- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions {\n    [ACPCore configureWithAppId:@\"yourAppId\"];\n    [ACPPlaces registerExtension]; //Register Places with Core\n    [ACPPlacesMonitor registerExtension]; //Register PlacesMonitor with Core\n    [ACPCore start: nil];\n\n    return YES;\n}\n```\nThe following updates are also neccessary for Places Monitor on iOS:\n\n- [Enable location updates in the background](https://docs.adobe.com/content/help/en/places/using/places-ext-aep-sdks/places-monitor-extension/using-places-monitor-extension.html#enable-location-updates-background)\n- [Add the keys NSLocationWhenInUseUsageDescription and NSLocationAlwaysAndWhenInUseUsageDescription to the app's plist file](https://docs.adobe.com/content/help/en/places/using/places-ext-aep-sdks/places-monitor-extension/using-places-monitor-extension.html#configuring-the-plist-keys)\n\n##### **Android**\n\nWithin the App's OnCreate method, register the SDK extensions and start the Places Monitor:\n```java\nimport com.adobe.marketing.mobile.MobileCore;\nimport com.adobe.marketing.mobile.Places;\nimport com.adobe.marketing.mobile.PlacesMonitor;\n\npublic class MobileApp extends Application {\n    @Override\n    public void onCreate() {\n        super.onCreate();\n        MobileCore.setApplication(this);\n        MobileCore.ConfigureWithAppId(\"yourAppId\");\n        try {\n            Places.registerExtension(); //Register Places with Core\n            PlacesMonitor.registerExtension(); //Register PlacesMonitor with Core\n            MobileCore.start(null);\n        } catch (Exception e) {\n            //Log the exception\n        }\n    }\n}\n```\nThe following update is also neccessary for Places Monitor on Android:\n\n- [Add location permissions to the app manifest](https://docs.adobe.com/content/help/en/places/using/places-ext-aep-sdks/places-monitor-extension/using-places-monitor-extension.html#add-permissions-to-the-manifest)\n\n##### Start the Places Monitor:\n\n```js\n// start the places monitor when the device ready event is heard\ndocument.addEventListener(\"deviceready\", function () {\n  ACPPlacesMonitor.start(function(response) {  \n    console.log(\"Successfully started the Places Monitor.\");\n  }, function(error){  \n    console.log(error);  \n  });\n}, function (error) {\n        console.log(error);\n});\n```\n##### Stop the Places Monitor:\n```js\nvar clearPlacesData = true;\nACPPlacesMonitor.stop(clearPlacesData, function(response) {  \n    console.log(\"Successfully stopped the Places Monitor.\");\n}, function(error){  \n    console.log(error);  \n});\n```\n##### Update the device's location:\n```js\nACPPlacesMonitor.updateLocation(function(response) {  \n    console.log(\"Successfully updated the location.\");\n}, function(error){  \n    console.log(error);  \n});\n```\n##### Set or upgrade the location permission request (Android) / request authorization level (iOS):\n```js\nACPPlacesMonitor.setRequestLocationPermission(ACPPlacesMonitor.LocationPermissionAlwaysAllow, function(response) {  \n    console.log(\"Successfully set the location permission request.\");\n}, function(error){  \n    console.log(error);  \n}); \n```\n##### Set the monitoring mode (iOS only):\n```js\nACPPlacesMonitor.setPlacesMonitorMode(ACPPlacesMonitor.MonitorModeContinuous, function(response) {  \n    console.log(\"Successfully set the places monitor mode.\");\n}, function(error){  \n    console.log(error);  \n}); \n```\n## Running Tests\nInstall cordova-paramedic `https://github.com/apache/cordova-paramedic`\n```bash\nnpm install -g cordova-paramedic\n```\n\nRun the tests\n```\ncordova-paramedic --platform ios --plugin . --verbose\n```\n```\ncordova-paramedic --platform android --plugin . --verbose\n```\n\n## Sample App\n\nA Cordova app for testing the Adobe SDK plugins is located at [https://github.com/adobe/cordova-acpsample](https://github.com/adobe/cordova-acpsample). The app is configured for both iOS and Android platforms.  \n\n## Additional Cordova Plugins\n\nBelow is a list of additional Cordova plugins from the AEP SDK suite:\n\n| Extension | GitHub | npm |\n|-----------|--------|-----|\n| Core SDK | https://github.com/adobe/cordova-acpcore | [![npm](https://img.shields.io/npm/v/@adobe/cordova-acpcore)](https://www.npmjs.com/package/@adobe/cordova-acpcore)\n| Adobe Analytics | https://github.com/adobe/cordova-acpanalytics | [![npm](https://img.shields.io/npm/v/@adobe/cordova-acpanalytics)](https://www.npmjs.com/package/@adobe/cordova-acpanalytics)\n| Places | https://github.com/adobe/cordova-acpplaces | [![npm](https://img.shields.io/npm/v/@adobe/cordova-acpplaces)](https://www.npmjs.com/package/@adobe/cordova-acpplaces)\n| Project Griffon (Beta) | https://github.com/adobe/cordova-acpgriffon | [![npm](https://img.shields.io/npm/v/@adobe/cordova-acpgriffon)](https://www.npmjs.com/package/@adobe/cordova-acpgriffon)\n| User Profile | https://github.com/adobe/cordova-acpuserprofile | [![npm](https://img.shields.io/npm/v/@adobe/cordova-acpuserprofile)](https://www.npmjs.com/package/@adobe/cordova-acpuserprofile)\n\n## Contributing\nLooking to contribute to this project? Please review our [Contributing guidelines](.github/CONTRIBUTING.md) prior to opening a pull request.\n\nWe look forward to working with you!\n\n## Licensing  \nThis project is licensed under the Apache V2 License. See [LICENSE](LICENSE) for more information.\n","readmeFilename":"README.md"}