feat(laravel-google-maps-client): initial commit (#378)

abenevaut · Copilot · web-flow · commit 03d428881c66 · 2025-09-21T09:26:43.000+02:00
* feat(laravel-google-maps): initial commit

* Update laravel-google-maps/src/Providers/GoogleMapsServiceProvider.php

Co-authored-by: Copilot &lt;175728472+Copilot@users.noreply.github.com&gt;

* Update laravel-google-maps/composer.json

Co-authored-by: Copilot &lt;175728472+Copilot@users.noreply.github.com&gt;

* Update laravel-google-maps/README.md

Co-authored-by: Copilot &lt;175728472+Copilot@users.noreply.github.com&gt;

* update readme and add scope

* move to correct directory

* fix pipeline

---------

Co-authored-by: Copilot &lt;175728472+Copilot@users.noreply.github.com&gt;
diff --git a/.github/workflows/laravel-google-maps-client-release.yml b/.github/workflows/laravel-google-maps-client-release.yml
@@ -0,0 +1,40 @@
+name: laravel-google-maps-client-release
+
+on:
+  push:
+    tags:
+      - laravel-google-maps-client-*
+
+defaults:
+  run:
+    working-directory: ./laravel-google-maps-client
+
+jobs:
+
+  release:
+    runs-on: ubuntu-latest
+    environment:
+      name: laravel-google-maps-client
+      url: https://github.com/abenevaut/laravel-google-maps-client
+    concurrency:
+      group: laravel-google-maps-client-release-${{ github.workflow }}-${{ github.ref }}
+      cancel-in-progress: false
+    steps:
+
+      - name: Checkout project
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Get current release tag
+        id: branch-name
+        run: echo "SOURCE_TAG=${GITHUB_REF#refs/tags/laravel-google-maps-client-}" >> $GITHUB_OUTPUT
+
+      - name: Publish to readonly repository abenevaut/laravel-google-maps-client
+        uses: s0/git-publish-subdir-action@develop
+        env:
+          REPO: git@github.com:abenevaut/laravel-google-maps-client.git
+          BRANCH: master
+          FOLDER: laravel-google-maps-client
+          SSH_PRIVATE_KEY: ${{ secrets.PRIVATE_KEY_LARAVEL_GOOGLE_MAPS_CLIENT }}
+          TAG: ${{ steps.branch-name.outputs.SOURCE_TAG }}
diff --git a/.github/workflows/laravel-google-maps-client-test.yml b/.github/workflows/laravel-google-maps-client-test.yml
@@ -0,0 +1,56 @@
+name: laravel-google-maps-client-test
+
+on:
+  push:
+    branches: [ master ]
+    paths:
+      - 'laravel-google-maps-client/**'
+  pull_request:
+    branches: [ master ]
+    paths:
+      - 'laravel-google-maps-client/**'
+
+defaults:
+  run:
+    working-directory: ./laravel-google-maps-client
+
+jobs:
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: true
+      matrix:
+        php_version: [ 83, 84 ]
+        include:
+          - php_version: 83
+            record_coverage: false
+          - php_version: 84
+            record_coverage: false
+    concurrency:
+      group: laravel-google-maps-client-test-${{ github.workflow }}-${{ github.ref }}-${{ matrix.php_version }}
+      cancel-in-progress: true
+    container:
+      image: ghcr.io/abenevaut/vapor-ci:php${{ matrix.php_version }}
+      env:
+        php_xdebug_log: /var/task/xdebug-errors.log
+    steps:
+
+      - name: Checkout project
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 2
+
+      - name: Composer install
+        run: composer install -o --no-interaction --prefer-dist
+
+      - name: Run tests
+        run: |
+          vendor/bin/phpstan analyse
+          vendor/bin/phpcs --standard=PSR12 src
+
+      - name: Send coverage
+        if: ${{ matrix.record_coverage }}
+        run: codecov -Z -f coverage/clover.xml -F laravel-google-maps-client
+        env:
+          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
diff --git a/.idea/scopes/laravel_google_maps.xml b/.idea/scopes/laravel_google_maps.xml
diff --git a/laravel-google-maps-client/.gitattributes b/laravel-google-maps-client/.gitattributes
@@ -0,0 +1,8 @@
+.gitattributes      export-ignore
+.gitignore          export-ignore
+.travis.yml         export-ignore
+CHANGELOG.md        export-ignore
+CONTRIBUTING.md     export-ignore
+phpunit.xml         export-ignore
+README.md           export-ignore
+tests               export-ignore
diff --git a/laravel-google-maps-client/.github/CODEOWNERS b/laravel-google-maps-client/.github/CODEOWNERS
@@ -0,0 +1 @@
+* @abenevaut
diff --git a/laravel-google-maps-client/.github/CODE_OF_CONDUCT.md b/laravel-google-maps-client/.github/CODE_OF_CONDUCT.md
@@ -0,0 +1,5 @@
+Be free to fork this project.
+All inspired code or re-used code have to be licensed to GNU GPLv3.
+No contribution is accepted on this READ ONLY repository. Please contribute on https://github.com/abenevaut/opensource.
+
+Roadmap: https://github.com/users/abenevaut/projects/14
diff --git a/laravel-google-maps-client/.github/CONTRIBUTING.md b/laravel-google-maps-client/.github/CONTRIBUTING.md
@@ -0,0 +1,3 @@
+No contribution is accepted on this READ ONLY repository. Please contribute on https://github.com/abenevaut/opensource.
+
+Roadmap: https://github.com/users/abenevaut/projects/14
diff --git a/laravel-google-maps-client/.github/ISSUE_TEMPLATE.md b/laravel-google-maps-client/.github/ISSUE_TEMPLATE.md
@@ -0,0 +1,7 @@
+| Q | A |
+| :--- | :---: |
+| Do you experience this problem multiple times? | Yes / No |
+
+## How to reproduce it ?
+
+Explain here how to reproduce it ?
diff --git a/laravel-google-maps-client/.github/PULL_REQUEST_TEMPLATE.md b/laravel-google-maps-client/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1 @@
+No contribution is accepted on this READ ONLY repository. Please contribute on https://github.com/abenevaut/opensource.
diff --git a/laravel-google-maps-client/.github/workflows/close-pr.yml b/laravel-google-maps-client/.github/workflows/close-pr.yml
@@ -0,0 +1,13 @@
+name: Close PR
+
+on:
+  pull_request_target:
+    types: [opened]
+
+jobs:
+  run:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: superbrothers/close-pull-request@v3
+      with:
+        comment: "No contribution is accepted on this READ ONLY repository. Please contribute on https://github.com/abenevaut/opensource."
diff --git a/laravel-google-maps-client/.github/workflows/docs-release.yml b/laravel-google-maps-client/.github/workflows/docs-release.yml
@@ -0,0 +1,34 @@
+name: docs-release
+
+on:
+  push:
+    branches: [ master ]
+    paths:
+      - 'docs/**'
+
+defaults:
+  run:
+    working-directory: ./docs
+
+jobs:
+
+  release:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+    concurrency:
+      group: docs-release
+      cancel-in-progress: true
+    steps:
+
+      - name: Checkout project
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Publish to wiki
+        uses: SwiftDocOrg/github-wiki-publish-action@v1
+        with:
+          path: "docs"
+        env:
+          GH_PERSONAL_ACCESS_TOKEN: ${{ secrets.ABENEVAUT_GITHUB_TOKEN }}
diff --git a/laravel-google-maps-client/.gitignore b/laravel-google-maps-client/.gitignore
@@ -0,0 +1,5 @@
+.phpunit.cache
+composer.lock
+coverage
+vendor
+xdebug-errors.log
diff --git a/laravel-google-maps-client/README.md b/laravel-google-maps-client/README.md
@@ -0,0 +1,34 @@
+# laravel-google-maps
+
+## Installation
+
+You can install the package via composer:
+
+```bash
+composer require abenevaut/laravel-google-maps
+```
+
+Add GoogleMaps service to your `config/services.php` file:
+
+```php
+'googlemaps' => [
+    'baseUrl' => env('GOOGLE_MAPS_URL', 'https://places.googleapis.com'),
+    'api_key' => env('GOOGLE_MAPS_API_KEY'),
+    'debug' => env('GOOGLE_MAPS_DEBUG', false),
+],
+```
+
+## Usage
+
+```php
+use abenevaut\GoogleMaps\Facades\GoogleMaps;
+
+// Example: Search for nearby places
+$results = GoogleMaps::placesNearby([
+    'location' => '48.8588443,2.2943506', // Eiffel Tower
+    'radius' => 1500,
+    'type' => 'restaurant',
+]);
+
+// ... to be continued
+```
diff --git a/laravel-google-maps-client/composer.json b/laravel-google-maps-client/composer.json
@@ -0,0 +1,39 @@
+{
+    "name": "abenevaut/laravel-google-maps",
+    "type": "library",
+    "description": "Google Maps integration and utilities for Laravel applications.",
+    "keywords": [
+        "laravel",
+        "client",
+        "infrastructure",
+        "hexagonal architecture"
+    ],
+    "license": "GPL-3.0-only",
+    "authors": [
+        {
+            "name": "Antoine Benevaut",
+            "email": "antoine@benevaut.fr"
+        }
+    ],
+    "require": {
+        "php": "^8.3",
+        "abenevaut/laravel-infrastructure": "^0.4.0",
+        "abenevaut/laravel-client-infrastructure": "^0.0.2",
+        "illuminate/container": "^12.0",
+        "illuminate/support": "^12.0",
+        "illuminate/http": "^12.0"
+    },
+    "require-dev": {
+        "phpunit/phpunit": "^10.5",
+        "mockery/mockery": "^1.6",
+        "squizlabs/php_codesniffer": "^3.11",
+        "phpstan/phpstan": "^2.1",
+        "nikic/php-parser": "^5.0",
+        "fakerphp/faker": "^1.24"
+    },
+    "autoload": {
+        "psr-4": {
+            "abenevaut\\GoogleMaps\\": "src/"
+        }
+    }
+}
diff --git a/laravel-google-maps-client/docs/Contribute.md b/laravel-google-maps-client/docs/Contribute.md
@@ -0,0 +1,9 @@
+# How to contribute
+
+## Build
+
+Maintain composer packages with php 8.3
+
+```bash
+docker-compose up -d
+```
diff --git a/laravel-google-maps-client/docs/Home.md b/laravel-google-maps-client/docs/Home.md
@@ -0,0 +1 @@
+## laravel-google-maps
diff --git a/laravel-google-maps-client/docs/_Footer.md b/laravel-google-maps-client/docs/_Footer.md
@@ -0,0 +1 @@
+[< Back to home](https://github.com/abenevaut/laravel-google-maps/wiki)
diff --git a/laravel-google-maps-client/phpstan.neon b/laravel-google-maps-client/phpstan.neon
@@ -0,0 +1,5 @@
+parameters:
+  level: 1
+  editorUrl: 'phpstorm://open?file=%%file%%&line=%%line%%'
+  paths:
+    - src
diff --git a/laravel-google-maps-client/src/Client/AccessToken.php b/laravel-google-maps-client/src/Client/AccessToken.php
@@ -0,0 +1,18 @@
+<?php
+
+namespace abenevaut\GoogleMaps\Client;
+
+use abenevaut\Infrastructure\Client\AccessTokenInterface;
+
+final class AccessToken implements AccessTokenInterface
+{
+    public function __construct(
+        private readonly string $apiKey
+    ) {
+    }
+
+    public function getAccessToken(): string
+    {
+        return $this->apiKey;
+    }
+}
diff --git a/laravel-google-maps-client/src/Client/GoogleMapsClient.php b/laravel-google-maps-client/src/Client/GoogleMapsClient.php
@@ -0,0 +1,41 @@
+<?php
+
+namespace abenevaut\GoogleMaps\Client;
+
+use abenevaut\Infrastructure\Client\AuthenticatedClientAbstract;
+use abenevaut\Infrastructure\Client\AccessTokenInterface;
+use Illuminate\Http\Client\PendingRequest;
+
+final class GoogleMapsClient extends AuthenticatedClientAbstract
+{
+    public function __construct(
+        string $baseUrl,
+        AccessTokenInterface $accessToken,
+        bool $debug = false
+    ) {
+        parent::__construct($baseUrl, $accessToken, $debug);
+    }
+
+    public function searchNearby(array $requestBody, array $fieldMaskParts = []): array
+    {
+        $response = $this->request();
+
+        if (!empty($fieldMaskParts)) {
+            $response->withHeaders([
+                'X-Goog-FieldMask' => implode(',', $fieldMaskParts)
+            ]);
+        }
+
+        return $response
+            ->post('v1/places:searchNearby', $requestBody)
+            ->throw()
+            ->json();
+    }
+
+    protected function authenticate(PendingRequest $pendingRequest): void
+    {
+        if ($this->accessToken) {
+            $pendingRequest->withHeader('X-Goog-Api-Key', $this->accessToken->getAccessToken());
+        }
+    }
+}
diff --git a/laravel-google-maps-client/src/Facades/GoogleMaps.php b/laravel-google-maps-client/src/Facades/GoogleMaps.php
@@ -0,0 +1,14 @@
+<?php
+
+namespace abenevaut\GoogleMaps\Facades;
+
+use abenevaut\GoogleMaps\Client\GoogleMapsClient as GoogleMapsClient;
+use Illuminate\Support\Facades\Facade;
+
+class GoogleMaps extends Facade
+{
+    protected static function getFacadeAccessor()
+    {
+        return GoogleMapsClient::class;
+    }
+}
diff --git a/laravel-google-maps-client/src/Providers/GoogleMapsServiceProvider.php b/laravel-google-maps-client/src/Providers/GoogleMapsServiceProvider.php

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+No contribution is accepted on this READ ONLY repository. Please contribute on https://github.com/abenevaut/opensource.`
	`2`	`+`
	`3`	`+Roadmap: https://github.com/users/abenevaut/projects/14`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+No contribution is accepted on this READ ONLY repository. Please contribute on https://github.com/abenevaut/opensource.`