Ember Google Maps

[![Latest version][npm-version-badge]][npm-url]
[![npm][npm-downloads-badge]][npm-url]
[![Ember Observer Score][ember-observer-badge]][ember-observer-url]
[![Build Status][ci-badge]][ci-url]

A friendly [Ember][ember-url] addon for working with [Google Maps][google-maps-url].

- Create and draw on your maps using Ember components.
- Automatically load the Google Maps API on demand and safely access it across your entire app.

> #### Thanks for using the addon!
>
> ember-google-maps is over 3 years old now. In that time, I’ve completely rewritten it multiple times over to support changes in both Ember and Google Maps. I’d love to keep working on this addon in my free time, but could use your support.
>
> If you use ember-google-maps in your commercial work or find it valuable, consider leaving a donation to support on-going maintenance and API costs.
>
> 
>
> Thank you! 🙌🙌🙌\
> — @sandydoo

- Documentation
- Quick start
- Compatibility
- Examples
- Addons
- Maintainers
- Contributing
- License
- Disclaimer

Are you new to Ember? Learn how to use Ember and install addons →

Looking for a more general mapping solution? Check out ember-leaflet →.

📎 Documentation
--------------------------------------------------------------------------------

[Get started with ember-google-maps →][docs-url]

$3

1. Install the addon.

``sh
ember install ember-google-maps
`

2. Provide a Google Maps API key in config/environment.js. Learn how to create an API key →

`js
'ember-google-maps': {
key: ""
}
`

3. Make sure your map has a size, or you’ll end up staring at a blank screen. ember-google-map is the default class for all maps.

`css
.ember-google-map {
width: 500px;
height: 500px;
}
`

4. Draw a new map at some coordinates.

`hbs

`

5. Great! You’ve drawn a map.\
[Now keep reading the docs →][docs-url]


🔗 Compatibility
--------------------------------------------------------------------------------

$3

- Ember.js v3.28 or above
- Ember CLI v3.28 or above
- Node.js v18 or above

⭐ Examples
--------------------------------------------------------------------------------

Display a map centered around a set of coordinates.

`handlebars

`

Display an array of locations using markers 📍.

`handlebars

{{#each this.locations as |location|}}
@lat={{location.lat}}
@lng={{location.lng}}
@onClick={{fn this.showDetails location}} />
{{/each}}

`

Display a custom overlay, like a custom HTML marker using template blocks 😱.
This lets you do all sorts of fancy things, like adding CSS animations and binding data.

`handlebars

{{#each this.rentals as |rental|}}





{{/each}}

``

[Learn more →][docs-url]

🛒 Extra addons
--------------------------------------------------------------------------------

- MarkerClustererPlus — Add marker clustering to your maps with @googlemaps/markerclustererplus.

😇 Maintainers
--------------------------------------------------------------------------------

This addon is maintained by [Sander Melnikov][maintainer-url].

Contributing
--------------------------------------------------------------------------------

See the Contributing guide for details.

License
--------------------------------------------------------------------------------

[MIT][license-url] © [Sander Melnikov][maintainer-url].

Disclaimer
--------------------------------------------------------------------------------

This software is not endorsed, maintained, or supported by Google LLC.

© 2020 Google LLC All rights reserved. Google Maps™ is a trademark of Google LLC.

[npm-version-badge]: https://img.shields.io/npm/v/ember-google-maps.svg?label=latest
[npm-downloads-badge]: https://img.shields.io/npm/dt/ember-google-maps
[npm-url]: https://www.npmjs.org/package/ember-google-maps

[ci-badge]: https://github.com/sandydoo/ember-google-maps/workflows/CI/badge.svg?branch=main
[ci-url]: https://github.com/sandydoo/ember-google-maps/actions?query=workflow%3ACI

[ember-observer-badge]: https://emberobserver.com/badges/ember-google-maps.svg
[ember-observer-url]: https://emberobserver.com/addons/ember-google-maps

[ember-url]: https://emberjs.com
[google-maps-url]: https://developers.google.com/maps/documentation/javascript/overview

[docs-url]: https://ember-google-maps.sandydoo.me/docs/getting-started
[maintainer-url]: https://github.com/sandydoo
[license-url]: https://github.com/sandydoo/ember-google-maps/blob/main/LICENSE