Socket
Socket
Sign inDemoInstall

instantsearch-googlemaps

Package Overview
Dependencies
115
Maintainers
1
Versions
14
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

    instantsearch-googlemaps

algolia/instantsearch.js widget to display your Algolia geo hits on a map using Google Maps APIs


Version published
Weekly downloads
2
Maintainers
1
Install size
1.71 MB
Created
Weekly downloads
 

Changelog

Source

1.2.6 (2016-07-19)

Bug Fixes

  • hits: do no try to render hits with no _geoloc (7b20e2e), closes #9

<a name="1.2.5"></a>

Readme

Source

instantsearch-googlemaps BETA

algolia/instantsearch.js widget to display your Algolia geo hits on a map using Google Maps APIs

Version Build Status License Downloads

Table of Contents generated with DocToc

Features

  • display your objects on a Google Map
  • refine search on zoom or drag as an option
  • adjust the map on window resize if needed

Demo of the instantsearchGoogleMaps widget

Install

From a CDN

instantsearch-googlemaps is available on jsDelivr:

Add the instantsearch CSS to the <head>:

<link rel="stylesheet" type="text/css" href="//cdn.jsdelivr.net/instantsearch.js/1/instantsearch.min.css" />

Load the JavaScript files where relevant:

<!-- https://developers.google.com/maps/documentation/javascript/tutorial -->
<script src="//maps.googleapis.com/maps/api/js?key=YOUR_API_KEY"></script>
<script src="//cdn.jsdelivr.net/instantsearch.js/1/instantsearch.min.js"></script>
<script src="//cdn.jsdelivr.net/instantsearch-googlemaps/1/instantsearch-googlemaps.min.js"></script>

With npm, browserify, webpack

npm install instantsearch-googlemaps --save

Usage

Algolia requirements

To display your objects on a map, they will need to have a _geoloc attribute.

{
  "_geoloc": {"lat": 33.636719, "lng": -84.428067}
}

<script>

var search = instantsearch({...});
search.addWidget(
  instantsearch.widgets.googleMaps({
    container: document.querySelector('#map'),
    // prepareMarkerData
  })
);

npm

var instantsearch = require('instantsearch.js');
var instantsearchGoogleMaps = require('instantsearch-googlemaps');
var search = instantsearch({...});
search.addWidget(
  instantsearchGoogleMaps({
    container: document.querySelector('#map'),
    // prepareMarkerData
  })
);

API

options.container | DOMELement (required)

Where to insert the map in the document. This is required.

options.prepareMarkerData | function

Called for every hit, this is the moment where you can select the label and title for the marker. This function should return an object in the form of {label, title}.

Example:

function prepareMarkerData(hit, index, hits) {
  return {
    label: hit.name,
    title: hit.description
  }
}

The label first letter will be displayed on the marker on the map.

The title will be displayed when hovering the marker.

By default we use the current hit index in the results as the label and the hit ObjectID for the title.

options.refineOnMapInteraction | boolean

Should we refine the search on map interaction, default to false.

Development

npm install
npm run dev

Testing

npm install
npm test

Publish

SEMVER_TOKEN=minor npm run release

FAQs

Last updated on 19 Jul 2016

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc