0.0.3 • Public • Published

    Google Places Collector

    Harness the power of the Google Maps API and its node.js libary to collect information for geographical locations within a city.

    The problem

    The Google Maps API exposes a powerful set of queries for working with locations and places but imposes limitations both in what is available to search and how much data you can collect per query. This library is an evolving effort to build on top of the existing API to make certain queries possible and others easier.


    This module is distributed via npm which is bundled with node and should be installed as one of your project's dependencies:

    npm install --save google-places-collector


    API Key

    Get an API Key from google here to gain permissions to the places data. Note that some of the methods exposed by this package might use quite a lot of queries in order to achieve the desired functionality. You should get 1500 free queries from Google per day but it is suggested that you verify your project (free but you need to submit a credit card for the verification) in order to get 150,000 queries per day.

    You can either define a property in a seperate .env file under GOOGLE_MAPS_KEY or set the variable in our environment's path.

    Collecting your data

    const gpc = require('google-places-collector');
    const getPlaces = async () => {
      const results = await gpc.getPlacesByType('Business Bay', 'restaurant');

    Results will be supplied by an async function with an array of place objects (in this case, a listing of all restraunts within Dubai's Business Bay area).

    Running additional checks

    The getPlacesByType method does its best to collect only places that are within the place requested. However, due to the internal algorithm used, you might notice that there are few discrepancies. This can be fixed! The method for ensuring that all places returned fall within the requested area consumes additional API queries and is therefore exposed as an option method.


    const gpc = require('google-places-collector');
    const getBusinessBayRestaurants = async () => {
      const areaName = 'Business Bay';
      // Get restaurants within Business Bay
      const bestGuessData = await gpc.getPlacesByType(areaName, 'restaurant');
      // Double check all the results and trim out any restaurants that are on
      // the edge of the Business Bay area but not actually within
      const bestData = await gpc.confirmPlaces(bestGuessData, areaName);

    forthebadge forthebadge


    npm i google-places-collector

    DownloadsWeekly Downloads






    Unpacked Size

    12.3 kB

    Total Files


    Last publish


    • tvthatsme