README

Laravel Google Geo Targets

Import all GeoTargets from Google into your Laravel project.

This dataset contains all the geo locations from Google. We update the source when Google publishes a new one and you can reseed your data. By default only the Netherlands is imported, but you can change this in the config if you want to.

Installation

Install the package via Composer:

composer require marshmallow/dataset-google-geotargets

The service provider is registered automatically through Laravel package discovery.

Publish and run the migrations

Before you run the migration, publish the migrations first:

php artisan vendor:publish --provider="Marshmallow\Datasets\GoogleGeoTargets\ServiceProvider" --tag="migrations"

Run the migrations to create the database schema:

php artisan migrate

Publish the config

Publish the config so you are able to choose which countries will be seeded to the table and which data types will be seeded. By default this is set to the Netherlands and all data types. If the defaults work for you, you don't need to publish the config.

php artisan vendor:publish --provider="Marshmallow\Datasets\GoogleGeoTargets\ServiceProvider"

Configuration

The published config/google-geotargets.php file exposes the following options:

Key	Default	Description
`countries`	`['NL']`	Alpha-2 country codes you wish to sync. An empty array seeds all countries.
`types`	All `GoogleGeoTarget` type constants	The geo target types you wish to sync.

The available type constants live on Marshmallow\Datasets\GoogleGeoTargets\Models\GoogleGeoTarget, for example GoogleGeoTarget::CITY, GoogleGeoTarget::PROVINCE, GoogleGeoTarget::COUNTRY, GoogleGeoTarget::AIRPORT and more.

Seed the tables

You need to seed two tables: the country table and the Google Geo Target table.

# Seed the country table.
php artisan db:seed --class="Marshmallow\Datasets\Country\Seeders\CountrySeeder"

# Seed the Google Geo Target table.
php artisan db:seed --class="Marshmallow\Datasets\GoogleGeoTargets\Seeds\GoogleGeoTargetsSeeder"

Usage

Each GoogleGeoTarget is related to its type, its parent, and its child cities:

use Marshmallow\Datasets\Country\Models\Country;
use Marshmallow\Datasets\GoogleGeoTargets\Models\GoogleGeoTarget;

$country = Country::alpha2('NL');
$country->provinces->first()->cities->first()->name;

// Resolve the type of a geo target.
$target = GoogleGeoTarget::first();
$target->type->name;

Security Vulnerabilities

Please report security vulnerabilities by email to stef@marshmallow.dev rather than via the public issue tracker.

Credits

License

The MIT License (MIT). Please see the License File for more information.

marshmallow / dataset-google-geotargets

Maintainers

Package info

Statistics

Security