Location

• Introduction
• Sponsorware
• Setup
  • Get A Google Api Key
• Maps Field
  • Store Place Attributes

Introduction

The location package ships with a google maps field that let's you benefit from the extensive places api, to search for location's or pick one from the map.

Sponsorware

Bladesmith was created by Lennart Carstens-Behrens under the Sponsorware license.

Setup

Add the Litstack repository to your application's composer.json file:

"repositories": [
    {
        "type": "composer",
        "url": "https://store.litstack.io"
    }
],

composer require litstack/location

Get A Google Api Key

Now you need to get an api key to make use of google maps in your litstack project.

• Go to the Google credentials page.
• Create an Api Key.
• Enable the following libraries for your newly generated API Key (Maps Javascript API, Places API)

The api key must now be added to your config under lit.location.google_api_key:

'location' => [
    'google_api_key' => env('GOOGLE_MAPS_API_KEY'),
],

Maps Field

The maps field let's the user pick location by searching for it or clicking somewhere on the map.

The map field requires 2 parameters, the first one is the name of the latitude attribute, the second parameter is the longitute attribute name.

$form->map('lat', 'lng');

Store Place Attributes

The maps field let's you store additional information about places to your Model. This can be achieved by passing an array as a third parameter to the maps field, containting the desired attributes and the database column in which the attribute should be stored. In the following example the formatted_address would be stored in the street column.

$form->map('lat', 'lng', [
    'formatted_address' => 'street',
]);

The following attributes are available: