Skip to main

Google Maps Place Details (Reviews)

The PlaceDetails class is a part of the Designbycode namespace and is used to fetch reviews, rating, and user ratings total of a place using the Google Places API. It requires a Google Maps API key and a Google Maps place ID to make requests.

Package Documentation

This package provides a simple and easy-to-use interface for fetching place details from the Google Maps Place Details API.

Please note the package only return 5 reviews at most.

If you want to fetch more reviews, please use the Google Maps Place Search API

Installation

To install the package, use composer:

composer require designbycode/google-maps-place-details

Usage

To use the package, you need to provide a Google Maps API key and a place ID:

use Designbycode\GoogleMapsPlaceDetails\PlaceDetails;

$placeDetails = new PlaceDetails('YOUR_API_KEY', 'YOUR_PLACE_ID');

You can then fetch the full result set from the Google Maps API:

$results = $placeDetails->getResults();

Or you can fetch specific data, such as reviews, rating, and user ratings total:

$reviews = $placeDetails->getReviews();
$rating = $placeDetails->getRating();
$userRatingTotal = $placeDetails->getUserRatingTotal();

Fields

The package supports the following fields:

  • reviews
  • rating
  • user_ratings_total
$placeDetails = new PlaceDetails('YOUR_API_KEY', 'YOUR_PLACE_ID');

Results Class

The Results class is responsible for handling the results of a Google Maps Place Details API request. It provides the following methods:

  • reviews(): Returns an array of reviews from the API response.
  • rating(): Returns the rating from the API response, or null if not present.
  • userRatingsTotal(): Returns the total number of user ratings from the API response, or null if not present.

Example

$placeDetails = new PlaceDetails('YOUR_API_KEY', 'YOUR_PLACE_ID');

$placeDetails->getResults()->reviews();

Enum Class

The Field enum class is used to define the fields that can be fetched from the Google Maps Place Details API. It supports the following fields:

  • reviews
  • rating
  • user_ratings_total

Testing

composer test

Contributors

contrib

License

This project is licensed under the MIT License - see the LICENSE file for details.

©2024 DesignByCode, Inc. All rights reserved.

Design & Developed by DesignByCode