Google Maps Places integration for Vulcan
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Vulcan Places


meteor add vulcan:places


This package enables two distinct features, which can be used separately or together:

  1. A PlaceControl autocomplete form component that lets users fill in a place via the Google Maps Places API.
  2. A Places collection that can optionally be used to store places as individual documents.

Both require setting your Google Maps API key in your settings.json file's public section:

"googlemaps": {
  "apiKey": "123foo"

And install npm packages :

npm install --save @google/maps react-places-autocomplete

Place Form Control


To use:

  1. Import PlaceControl from 'meteor/vulcan:places'
  2. Create a placeName custom field on one of your collections
  3. Set this field's control property to PlaceControl.
  4. Also create a placeId field on the same collection.
  5. Add placeName and placeId to the appropriate fragments.

Places Collection


The Places collection makes it easy to check for a placeId field on a newly inserted or edited document, and if present insert a new place document.

There are two distinct ways to use this collection:

  1. Associate a place with one or more documents from another collection, such as adding a location to individual photos.
  2. Build a Yelp-like directory of places by using the Places collection as a base and adding your own custom fields to it.


The package exports a checkAndAddPlace function that takes a placeId, checks the Places collection for any existing document with that id, and if none is found queries the Google Places API for the place details before inserting it in the database:

import { addCallback } from 'meteor/vulcan:core';
import { checkAndAddPlace } from 'meteor/vulcan:places';

function postsNewCheckForNewPlace (document, user) {
  if (document.placeId) checkAndAddPlace(document.placeId);
addCallback('', postsNewCheckForNewPlace);

function postsEditCheckForNewPlace (document) {
  if (document.placeId) checkAndAddPlace(document.placeId);
addCallback('posts.edit.async', postsEditCheckForNewPlace);


The package also creates resolvers for the Places collection.