@googlemaps/js-samples

js-samples

Description

Samples for the Google Maps JavaScript API.

The samples can be demoed on the GitHub demo page or at the official documentation site.

Initialize an app from a sample

# install the package
npm i -g @googlemaps/js-samples

# extract a sample to a destination folder
googlemaps-js-samples init map-simple destFolder

# run the sample
cd destFolder
npm i
npm run dev

Replace map-simple with the path to another sample in this repository.

Development

Build

1. npm i Install dependencies.
2. npm run build Build all targets and update dist/ folder.

Test

1. npm run lint Optionaly fix lint issues with npm run format
2. npm test Test outputs.

Run

1. Start a server with all samples using npm start or bazel run serve (or ibazel for faster live reload)
2. Start a specific sample with bazel run samples/map-simple:devserver (or ibazel for faster live reload)

Caching

It may be possible to enable remote caching with Bazel to speed builds. This will require running gcloud auth application-default login. This requires access to a specific GCS bucket that most developers do not have.

Inputs and outputs

The following table identifies the inputs and outputs.

File	Edit	jsFiddle	Description
samples/*/src/index.js	Y	N	JavaScript for sample for JS tab
samples/*/src/index.njk	Y	N	HTML template for sample
samples/*/src/style.scss	Y	N	SCSS style for sample
shared/layout.njk	Y	N	Shared HTML template to extend
shared/scss/*	Y	N	Shared SCSS styles
dist/samples/*/index.html	N	N	Inline HTML, CSS, JS with development key and transpiled for >1%, ie11
dist/samples/*/iframe.html	N	N	Inline HTML, CSS, JS for iframe without html, head, body tags transpiled for ie11 and >1%, ie11
dist/samples/*/inline.html	N	N	Inline HTML, CSS, JS for All tab transpiled for >3%
dist/samples/*/jsfiddle.html	N	Y	HTML without CSS or JS for in jsFiddle
dist/samples/*/sample.html	N	N	HTML without CSS or JS for HTML tab
dist/samples/*/style.css	N	Y	CSS output from SCSS for CSS tab

Other resources

• Google Maps JavaScript API Documentation
• Google Maps JavaScript API Reference Documentation
• Google Maps Typings - npm i -D @types/google.maps
• Google Maps Utilitiies

Support

These libraries are community supported. We're comfortable enough with the stability and features of the libraries that we want you to build real production applications on it.

If you find a bug, or have a feature suggestion, please log an issue. If you'd like to contribute, please read How to Contribute.