https://github.com/tentone/car-tracker-ionic
Mobile web based application to track car GPS position for A11, ST-901, GT01, and GT09 SMS based trackers.
https://github.com/tentone/car-tracker-ionic
car-tracker gps gps-tracker ionic mobile-app sms
Last synced: about 1 year ago
JSON representation
Mobile web based application to track car GPS position for A11, ST-901, GT01, and GT09 SMS based trackers.
- Host: GitHub
- URL: https://github.com/tentone/car-tracker-ionic
- Owner: tentone
- License: mit
- Created: 2019-12-01T14:39:05.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2022-02-07T22:14:10.000Z (over 4 years ago)
- Last Synced: 2025-03-31T17:24:44.124Z (about 1 year ago)
- Topics: car-tracker, gps, gps-tracker, ionic, mobile-app, sms
- Language: TypeScript
- Homepage:
- Size: 16.1 MB
- Stars: 7
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Car Tracker Ionic
- Mobile application to track car GPS position for SMS based Chinese tracker(s) marketed under the model number A11, ST-901, GT01 and GT09.
- Manage multiple GPS car trackers using SMS communication.
- Set multiple parameter of the tracker (e.g. speed limit, sleep time, password, distance alarm)
- Manage and list messages exchanged with the car tracker.
- Export stored data as file for backup as JSON.
- Dark and bright graphical user interface themes (including maps).
- Mock-up of the ST-901 device that can be used for development testing on the browser.
- Works with any Ionic compatible platform (may have problems on some platforms caused ionic native plugins compatibility).
- May be compatible with other SMS based trackers, but it was only tested with these mentioned above.
### Screenshots
### Development Environment
- Install [Java JDK 8](https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) and [Android development SDK](https://developer.android.com/studio#downloads), there is no need to install the Android Studio IDE, only the build tools are required.
- You may need to install [gradle](https://gradle.org/) [manually](https://gradle.org/install/#manually) and register it in your path.
- Ensure that you have the environment variables `GRADLE_HOME`, `JAVA_HOME` and `ANDROID_SDK_ROOT`, and have access to `java` and `gradle` from the your terminal (or command line in windows).
- `GRADLE_HOME` ...\Gradle\gradle-7.2
- `JAVA_HOME` ...\Java\jdk1.8.0_301
- `ANDROID_SDK_ROOT` ...\AppData\Local\Android\Sdk
- Install Android SDK Platform 28 tools from the android SDK manager.
- Install [NodeJS](https://nodejs.org/en/) and NPM and install dependencies
```bash
npm install -g @angular/cli
npm install -g @ionic/cli
npm install
npm run start
```
- The application can be built using Ionic Native for mobile devices using [Capacitor](https://capacitorjs.com/).
### Capacitor
- [Capacitor](https://capacitorjs.com/) is a replacement for [Cordova](https://cordova.apache.org/) developed by the Ionic team, that contains its own plugins for access to native functionalities.
- Install the capacitor CLI globally, and install the required dependencies for Android and iOS development.
```bash
# Add a native platform to the project run
npm i @capacitor/ios @capacitor/android
npx cap add android
npx cap add ios
# Check system requirements
npm install -g @capacitor/cli
capacitor doctor android
# Add new plugins to the application
npm install --save @capacitor/toast
npx cap sync
```
### SMS Commands
- Here is a list of all the commands that i have tested with the device alongside with the answers returned by the GPS tracker.
| Command | Function | Response Example |
| ---------------------- | :----------------------------------------------------------- | ------------------------------------------------------------ |
| admin[pw] [phone] | Set the admin phone number used for the GPS to return information. | admin ok |
| apn[pw] [value] | Set the APN value for the SIM card carrier | apn ok |
| password[pw] [newpw] | Change the password of the device, by default the password is 123456. | password ok |
| g1234 | Get the location of the tracker, car velocity, date and ACC status | http://maps.google.cn/maps?q=N40.93956,W008.53900 ID:9171072755 ACC:OFF GPS:A Speed:38.00KM/H 19-12-30 03:20:08 |
| 10[n]#[phone]# | Set SOS phone number slot n. Slots from 1 to 3 available. | ok |
| D10[n]# | Delete SOS phone number on slot n. | ok |
| C10# | List the SOS phone numbers registered in the device. | 101#[Phone1] 102#[Phone2] 103#[Phone3] |
| CXZT | Get the tracker firmware version, identifier, battery level, APN configuration GPS status etc. | XM_GT09_SW_33.0 2019/08/08 ID:9171072755 IP:27.aika168.com 8185 BAT:5 APN:internet GPS:V-13-9 GSM:22 ICCID:89351060000852459823 |
| format | Format the GPS tracker back to its factory values | 恢复出厂值成功，请从新绑定车主号码! |
| speed[pw] [speed] | Set the speed alarm value to reset the value set the speed to 0. Speed should be represented with 3 integer digits. | speed ok |
| 109# | Toggle the language between Chinese and English. | ok |
| sleep,[pw],[sleep] | Configure sleep time (in minutes) of the tracker. 0 means no sleep. | ok |
| zone[pw] [zone] | Set the time zone of the SMS tracker. (E02 means, E08, etc) | ok |
| accclock,[pw],[0 or 1] | Enable/disable ignition auto security, used for the tracker to send an SMS every time the ignition is switched. | - |
| pwrsms[pw],[0 or 1] | Enable/disable power SMS alarm sent if the alarm is disconnected from power. | - |
| pwrcall[pw],[0 or 1] | Enable/disable power call made by the tracker warning that it was disconnected from power. | - |
| 12[n]# | Enable/disable shake call alarm (2 to enable, and 1 to disable). | - |
| 12[n]# | Enable/disable SMS alarm (5 to enable and 6 to disable). | - |
### SMS Responses
- Sometimes the GPS tracker sends some responses that may differ from the expected due to malformation in the command send.
| Message | Function |
| ------------------------------------------------------------ | ------------------------------------------------- |
| 您的设备掉主电报警，请关注! | Device was powered off (disconnected from power). |
| 指令格式错误 | Unknown instruction |
| http://maps.google.cn/maps ID:9171072755 ACC:OFF GPS:V Speed:0 KM/H 19-12-29 23:22:22 | M |
### Android Permissions
- When new plugins are added to provide additional native functionality, the permissions list in the `AndroidManifest.xml` should be updated.
- It might be necessary to also request for permission during runtime before using the feature.
```xml
```
### License
- This project is distributed under MIT license. (Available on the project Git repository on GitHub).