@happy-gastro/gplaces-finder

Google Places finder

@happy-gastro/gplaces-finder is a Node.js library that simplifies the process of fetching information about restaurants and bars using the Google Places API. It provides methods to retrieve a list of restaurants and bars near a specified location, as well as additional details for each place.

Installation

npm install @happy-gastro/gplaces-finder

Usage

const GooglePlacesClient = require('@happy-gastro/gplaces-finder');  
  
// Create a new instance of GooglePlacesClient with your API key  
const apiKey = 'YOUR_API_KEY';  
const placesClient = new GooglePlacesClient(apiKey);  
  
// Define location and radius for the search  
const location = '47.4844144,19.0816307'; // Budapest coordinates  
const radius = 150000;  
  
// Fetch details for restaurants and bars near the specified location  
placesClient.fetchRestaurantsAndBars(location, radius)  
 .then(places => { places.forEach(place => { console.log('Name:', place.name); console.log('Address:', place.formatted_address); console.log('Phone:', place.formatted_phone_number || 'N/A'); console.log('Website:', place.website || 'N/A'); console.log('----------------------'); }); }) .catch(error => { console.error('Error:', error); });  

API

GooglePlacesClient(apiKey)

Creates a new instance of GooglePlacesClient with the specified Google Maps API key.

• apiKey (string): Your Google Maps API key.

fetchRestaurantsAndBars(location, radius)

Fetches details for restaurants and bars near a specified location.

• location (string): The latitude and longitude coordinates (comma-separated) of the location.
• radius (number): The radius (in meters) around the location to search for places.
• Returns: A promise that resolves to an array of place objects with additional details.

fetchPlaces(location, radius, types)

Fetches a list of places (restaurants and bars) near a specified location.

• location (string): The latitude and longitude coordinates (comma-separated) of the location.
• radius (number): The radius (in meters) around the location to search for places.
• types (string): The types of places to search for (e.g., 'restaurant|bar').
• Returns: A promise that resolves to an array of place objects.

fetchPlaceDetails(placeId)

Fetches details for a specific place based on its place ID.

• placeId (string): The unique place ID.
• Returns: A promise that resolves to the details of the place.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Author

This project is developed and maintained by Farkas Ferenc.

• Name: Farkas Ferenc
• Email: [e-mail]
• Website: www.happygastro.hu

Company

Happy Gastro Ltd.

License

MIT