Laravel Places Scout

A Laravel client for Google Places Text Search and Place Details. Responses are returned as typed data objects.

Requires PHP 8.3+ and Laravel 12 or 13.

Install

composer require eloquage/laravel-places-scout
php artisan vendor:publish --tag=places-scout-config

Set your Google Places API key in .env:

GOOGLE_PLACES_API_KEY=your-api-key

Search for places

use IllumaLaw\PlacesScout\Facades\PlacesScout;

$response = PlacesScout::textSearch('coffee shops in Lisbon');

foreach ($response?->results ?? [] as $place) {
    echo $place->name;
    echo $place->formattedAddress;
}

Get place details

$place = PlacesScout::getPlaceDetails('ChIJ...');

if ($place !== null) {
    echo $place->name;
    echo $place->website;
}

Both methods return null when the Google API request fails. You can pass withApiKey($key) before either method to use a per-request key.

Tests

composer test
composer analyse
composer format -- --test

License

MIT. See LICENSE.md.