Without the facade

The facade is the recommended default, not the only way in. In most packages there are three equivalent entry points — the facade, the manager injected through the constructor, and single-purpose action classes. google-places is a remote-API client, so it has no action classes: the client’s methods are the use cases. That leaves two:

• The GooglePlaces facade — the shortest form.
• The client, injected through the constructor — the same API with an explicit dependency and no static calls. The facade root is the RoundlyConsulting\GooglePlaces\Contracts\PlacesClient contract, bound as a singleton to the RoundlyConsulting\GooglePlaces\Places implementation.

Injecting the client

The facade and the contract resolve the same singleton, and GooglePlaces::fake() replaces both — so type-hint the contract, not the concrete Places class, in code you want to fake:

use RoundlyConsulting\GooglePlaces\Contracts\PlacesClient;

final class NearbyCafes
{
    public function __construct(private PlacesClient $places) {}

    public function __invoke(string $query): array
    {
        return $this->places->textSearch($query)->all();
    }
}

Handles built by an injected client call back into that client, so they are faked too:

use RoundlyConsulting\GooglePlaces\Contracts\PlacesClient;

final class PlacePhotos
{
    public function __construct(private PlacesClient $places) {}

    public function hero(string $placeId): ?string
    {
        $place = $this->places->details($placeId);

        if ($place === null || $place->photos === []) {
            return null;
        }

        return $this->places->photo($place->photos[0])->url();
    }
}

Facade method → client method

Every facade call maps one-to-one to the same method on PlacesClient: