PHPackages                             mauricewijnia/nova-maps-address - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. mauricewijnia/nova-maps-address

ActiveLibrary[Utility & Helpers](/categories/utility)

mauricewijnia/nova-maps-address
===============================

A Laravel Nova Google Maps Field.

v2.0.1(11mo ago)642.9k↓37%3[2 issues](https://github.com/mauricewijnia/nova-maps-address/issues)[3 PRs](https://github.com/mauricewijnia/nova-maps-address/pulls)MITJavaScriptPHP >=7.1.0

Since Sep 10Pushed 11mo ago1 watchersCompare

[ Source](https://github.com/mauricewijnia/nova-maps-address)[ Packagist](https://packagist.org/packages/mauricewijnia/nova-maps-address)[ RSS](/packages/mauricewijnia-nova-maps-address/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (7)Dependencies (1)Versions (9)Used By (0)

Nova Maps Address
=================

[](#nova-maps-address)

Nova Maps Address is a Nova field that allows the user to select an adress using the Google Places API and store it in a JSON column.

Table of Contents
-----------------

[](#table-of-contents)

1. [Installation](#installation)
2. [Usage](#usage)

Installation
------------

[](#installation)

To install the field simply run:

```
composer require mauricewijnia/nova-maps-address

```

You will need a Google Maps API key with access to the Maps, Places and Geocoding API. You can place the key in your `.env` file like this:

```
NOVA_MAPS_ADDRESS_KEY="your_key_here"

```

Usage
-----

[](#usage)

This fields stores its data as JSON in your column, so we will have to cast our column to an array.

To add the field to your resource you can do:

```
use Mauricewijnia\NovaMapsAddress\MapsAddress;
...
public function fields(Request $request) {
    return [
        ...
        MapsAddress::make(__('Address'), 'address'),
        ...
    ];
}
```

And in our model:

```
protected $casts = [
    'address' => 'array'
]
```

The resulting data will have this format:

```
{
    street_name: string,
    street_number: string,
    postal_code: string,
    city: string,
    country: string,
    formatted_address: string,
    latitude: float,
    longitude: float
    address_components: array // https://developers.google.com/maps/documentation/javascript/geocoding#GeocodingAddressTypes
}

```

Options
-------

[](#options)

You can change some of the settings for the map by call the respective option method:

```
MapsAddress::make(__('Address'), 'address')
    ->zoom(5)
    ->center(['lat' => 55.5, 'lng' => 5.5])
    ->types(['address' ,'establishment']);
```

You can also pass parameters to Map js request and all options available for map/autocomplete/geocoder class. For example to specify a language and regions and filter the components:

```
MapsAddress::make(__('shop_admin.places.address'), 'address')->types([])
                    ->scriptUrlParams(['region' => 'jp', 'language' => 'ja'])
                    ->autoCompleteOptions(['componentRestrictions' => ['country' => ['jp']]])
                    ->mapOptions(['componentRestrictions' => ['country' => ['jp']]])
```

OptionDescriptionDefaultzoomSet the default zoom level of the map10centerSet the initial centering point of the map`['lat' => 52.370216, 'lng' => 4.895168]`typesSet the type of places that should be shown options are: establishment, address, geocode`['address']`allowMapClickAllow user to click on the map to get the addresstrueautoCompleteOptionsSet options for AutoComplete class initialization. N/AgeocodeOptionsSet options for Geocoder class initialization. N/AmapOptionsSet options for Map class initialization. N/AscriptUrlParamsSet parameters during the request of Google Map API js. N/A

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance45

Moderate activity, may be stable

Popularity34

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 93.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~289 days

Recently: every ~429 days

Total

7

Last Release

342d ago

Major Versions

v1.3.0 → v2.0.02025-06-10

### Community

Maintainers

![](https://www.gravatar.com/avatar/3ad84a5c4c4e1873137925fd52c8e0388076791672018519c404c2c53bd086e2?d=identicon)[mauricewijnia](/maintainers/mauricewijnia)

---

Top Contributors

[![mauricewijnia](https://avatars.githubusercontent.com/u/8679682?v=4)](https://github.com/mauricewijnia "mauricewijnia (14 commits)")[![dnwjn](https://avatars.githubusercontent.com/u/57711725?v=4)](https://github.com/dnwjn "dnwjn (1 commits)")

---

Tags

laravelgooglemapsnova

### Embed Badge

![Health badge](/badges/mauricewijnia-nova-maps-address/health.svg)

```
[![Health](https://phpackages.com/badges/mauricewijnia-nova-maps-address/health.svg)](https://phpackages.com/packages/mauricewijnia-nova-maps-address)
```

###  Alternatives

[optimistdigital/nova-sortable

This Laravel Nova package allows you to reorder models in a Nova resource's index view using drag & drop.

2872.1M6](/packages/optimistdigital-nova-sortable)[outl1ne/nova-sortable

This Laravel Nova package allows you to reorder models in a Nova resource's index view using drag & drop.

2861.8M9](/packages/outl1ne-nova-sortable)[cornford/googlmapper

An easy way to integrate Google Maps with Laravel.

457447.9k4](/packages/cornford-googlmapper)[optimistdigital/nova-multiselect-field

A multiple select field for Laravel Nova.

3403.5M7](/packages/optimistdigital-nova-multiselect-field)[sbine/route-viewer

A Laravel Nova tool to view your registered routes.

57215.9k](/packages/sbine-route-viewer)[yieldstudio/nova-google-autocomplete

A Laravel Nova Google autocomplete field.

12218.4k](/packages/yieldstudio-nova-google-autocomplete)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)