https://github.com/googlesamples/functions-as-a-service
A demo showing Google Cloud Functions + Google Maps Platform
https://github.com/googlesamples/functions-as-a-service
Last synced: 4 months ago
JSON representation
A demo showing Google Cloud Functions + Google Maps Platform
- Host: GitHub
- URL: https://github.com/googlesamples/functions-as-a-service
- Owner: googlesamples
- License: apache-2.0
- Created: 2019-05-06T19:10:37.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2025-01-29T20:30:03.000Z (over 1 year ago)
- Last Synced: 2025-08-01T09:12:27.288Z (11 months ago)
- Language: TypeScript
- Homepage:
- Size: 432 KB
- Stars: 30
- Watchers: 5
- Forks: 14
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Functions as a Service
The demo shows calling Google Maps Platform APIs from Google Cloud Functions.
## Technologies
- Cloud Functions (Node 10)
- [Function Framework](https://github.com/GoogleCloudPlatform/functions-framework-nodejs) for local development.
- Google Maps Services ([Node.js Client](https://github.com/googlemaps/google-maps-services-js))
- Directions API
- TypeScript
- Google Maps Types: https://www.npmjs.com/package/@types/google__maps
- Google Cloud Functions Server (Express): https://www.npmjs.com/package/@types/express
## Develop
First install dependencies:
```sh
npm i
```
Then in one tab continually build the project with this command:
```sh
npm run build
```
In another tab, start the web server (and watch if the source code changes):
```sh
API_KEY= npm run watch
```
This uses [`npm-watch`](https://www.npmjs.com/package/npm-watch) with the [`functions-framework`](https://www.npmjs.com/package/@google-cloud/functions-framework) to auto re-build the server after changes.
### Test locally
Go to `http://localhost:8080` to run your Google Cloud Function locally.
Here are some example URL requests:
```
http://localhost:8080/directions?mode=driving&origin=37.7841393,-122.404467
http://localhost:8080/origins?origin=6
http://localhost:8080/places?origin=37.7841393,-122.114167
```
### API Key
To create an API key, use the Cloud Console credentials page:
https://console.cloud.google.com/apis/credentials
More detailed instructions can be found in the ["Get API Key" guide](https://developers.google.com/maps/documentation/javascript/get-api-key#detailed_guide).
After creating an API key, enable these APIs:
- [Directions API](http://console.cloud.google.com/google/maps-apis/apis/directions-backend.googleapis.com)
- [Places API](http://console.cloud.google.com/google/maps-apis/apis/places-backend.googleapis.com)
### Deploy
You must create a `.env.yaml` with your API Key:
```env
API_KEY=AIsdfyCnTEiLTroDN14NTtpPm1n7jrBR844ID4A
```
You can deploy this project to Google Cloud Functions by running the following script:
```sh
gcloud config set project $MY_PROJECT
sh deploy.sh
```