This repository contains Firebase Cloud Functions that create and complete trips and manage orders for Ridesharing apps for iOS and Android.

• Requirements
• Add to your project
• Documentation
• FAQs
• Contribute
• Support

Firebase Cloud Functions require a paid account to make outbound API calls. This includes API calls to HyperTrack APIs. We recommend using the Blaze plan. It gives a lot of bandwidth for free, which is more then enough to internally test the app.

1. Clone the repo.

git clone https://github.com/hypertrack/ridesharing-firebase.git
cd ridesharing-firebase

2. Install Firebase tools CLI

npm install -g firebase-tools

3. Login to your account and choose your project

firebase login
firebase use --add

Select the project from dropdown menu. You can use any alias for the project.

4. Install function dependencies

cd functions ; npm install ; cd ..

5. Configure functions with HyperTrack API Keys

Copy AccountId and SecretKey from HyperTrack's dashboard setup page. Paste them in /functions/index.js file into placeholders on line 9. Keep the : separator between them.

6. Deploy functions into your Firebase Ridesharing project

firebase deploy --only functions

7. Setup webhooks from HyperTrack to Cloud Functions

• Open the Functions > Dashboard tab in your Firebase project
• Copy the trigger URL for onTripUpdate function
• Go to HyperTrack's dashboard setup page and add this URL as a webhook URL.
• Go back to Firebase and open the Logs tab. Search for onTripUpdate function's log with SubscriptionConfirmation message. Open the SubscribeURL in browser (XML file will appear). The webhook activation can take a few minutes. Refresh the dashboard's setup page to make sure, that activation was successful.

8. Your Cloud Functions backend is now ready to interface with HyperTrack APIs.

For detailed documentation of the APIs, customizations and what all you can build using HyperTrack, please visit the official docs.

• No project active
• Error parsing triggers: Cannot find module 'moment'

No project active. Run with --project <projectId> or define an alias by
running firebase use --add

This error while deploying functions means that you need to select the project first. Run firebase use --add and select your project from dropdown menu, then add any alias to the project.

This error can happen when your didn't run npm install from the functions directory. Run cd functions ; npm install ; cd .. from the projects directory or execute the commands one by one:

cd functions
npm install
cd ..

Feel free to clone, use, and contribute back via pull requests. We'd love to see your pull requests - send them in! Please use the issues tracker to raise bug reports and feature requests.

We are excited to see what live location feature you build in your app using this project. Do ping us at [email protected] once you build one, and we would love to feature your app on our blog!

Join our Slack community for instant responses. You can also email us at [email protected].