### Install Httplug Adapters with Composer

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/installation.md

These commands install the necessary Httplug components for making HTTP requests and handling responses. It includes a specific adapter (Guzzle7) and a message factory.

```bash
composer require php-http/guzzle7-adapter
composer require php-http/message
```

--------------------------------

### Start Docker Services for Testing

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/development_environment.md

Starts the Docker services in detached mode, preparing the environment for running tests. This command is typically used before executing test suites.

```bash
docker-compose up -d
```

--------------------------------

### Install Composer Dependencies

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/development_environment.md

Installs project dependencies using Composer within a Docker container. This command ensures all necessary PHP libraries are available for the project.

```bash
docker-compose run --rm php composer install
```

--------------------------------

### Install Ivory Serializer with Composer

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/installation.md

This command installs the Ivory Serializer library, which is required for deserializing HTTP responses when using services like geocoders or directions.

```bash
composer require egeloen/serializer
```

--------------------------------

### Install and Configure HTTP Plugins for Services

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/service.md

Installs and configures recommended HTTPlug plugins for improved performance and error handling, including Retry, Http Error, Google Error, and Cache plugins. Requires 'php-http/client-common', 'php-http/cache-plugin', and 'symfony/cache'.

```bash
composer require php-http/client-common
composer require php-http/cache-plugin
composer require symfony/cache
```

--------------------------------

### Include Autoloader in PHP Script

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/installation.md

This PHP code snippet demonstrates how to include the Composer autoloader file, making the installed Ivory Google Map library classes available for use in your project.

```php
<?php

require __DIR__.'/vendor/autoload.php';

use Ivory\GoogleMap;

// ...

```

--------------------------------

### Accessing Place Details

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/place/base/place.md

Examples of how to retrieve specific details from a Place object using its methods.

```APIDOC
## Accessing Place Details

### Description
Examples of how to retrieve specific details from a Place object using its methods.

### Methods

- **getId()**: Returns the unique stable identifier of the place.
- **getPlaceId()**: Returns the textual place ID.
- **getName()**: Returns the human-readable name of the place.
- **getFormattedAddress()**: Returns the formatted address string.
- **getFormattedPhoneNumber()**: Returns the formatted phone number.
- **getInternationalPhoneNumber()**: Returns the international phone number.
- **getUrl()**: Returns the URL of the official Google page.
- **getIcon()**: Returns the URL of the suggested icon.
- **getScope()**: Returns the scope of the place.
- **getPriceLevel()**: Returns the price level (0-4).
- **getRating()**: Returns the place's rating (1.0-5.0).
- **getUtcOffset()**: Returns the UTC offset in minutes.
- **getVicinity()**: Returns the vicinity address.
- **getWebsite()**: Returns the authoritative website URL.
- **getGeometry()**: Returns the geometry information.
- **getOpeningHours()**: Returns the opening hours information.
- **getAddressComponents(type?: string)**: Returns all address components or filters by type.
- **getPhotos()**: Returns an array of photo objects.
- **getAlternatePlaceIds()**: Returns an array of alternate place IDs.
- **getReviews()**: Returns an array of reviews.
- **getTypes()**: Returns an array of feature types.
- **isPermanentlyClose()**: Returns a boolean indicating if the place is permanently closed.

### Code Examples

```php
// Get the place ID
$placeId = $place->getPlaceId();

// Get the formatted address
$formattedAddress = $place->getFormattedAddress();

// Get the rating
$rating = $place->getRating();

// Get address components filtered by type 'route'
$routeComponents = $place->getAddressComponents('route');
```
```

--------------------------------

### Build Docker Project

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/development_environment.md

Builds the Docker images and services defined in the 'docker-compose.yml' file. This command should be run after configuring the environment variables.

```bash
docker-compose build
```

--------------------------------

### Install Ivory Google Map using Composer

Source: https://github.com/bresam/ivory-google-map/blob/master/README.md

This command installs the core Ivory Google Map library using Composer, the dependency manager for PHP. Ensure Composer is installed and accessible in your project's root directory.

```bash
composer require ivory/google-map
```

--------------------------------

### Configure Serializer

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/service.md

Sets the serializer for the service. This example uses the default Ivory Serializer.

```php
use Ivory\Serializer\Serializer;

$service->setSerializer(new Serializer());
```

--------------------------------

### Get Place Reviews

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/place/base/place.md

Retrieves an array of up to five reviews for the place. Consult the review documentation for more information on each review object.

```php
$reviews = $place->getReviews();
```

--------------------------------

### Get Place Opening Hours

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/place/base/place.md

Retrieves information about the place's opening hours. Consult the opening hours documentation for more details.

```php
$openingHours = $place->getOpeningHours();
```

--------------------------------

### Configure HTTP Client with Guzzle7

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/service.md

Allows updating the HTTP client for services. This example uses the Guzzle7 adapter, but any HTTPlug-compliant client can be used.

```php
use Http\Adapter\Guzzle7\Client;

$service->setClient(new Client());
```

--------------------------------

### Get Start Address (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/direction/direction_response.md

Retrieves the human-readable street address for the start location of a leg.

```php
$startAddress = $leg->getStartAddress();
```

--------------------------------

### Get Start Location (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/direction/direction_response.md

Retrieves the starting coordinate of a leg. This is represented by a Coordinate object.

```php
$startLocation = $leg->getStartLocation();
```

--------------------------------

### Get Place Website

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/place/base/place.md

Retrieves the authoritative website for the place, typically the business's homepage. This provides a direct link to the official online presence.

```php
$website = $place->getWebsite();
```

--------------------------------

### Get Step Start Location (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/direction/direction_response.md

Retrieves the starting coordinate for a specific step. This is represented by a Coordinate object.

```php
$startLocation = $step->getStartLocation();
```

--------------------------------

### Build Rectangle with Bound and Options (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/overlay/rectangle.md

Shows how to initialize a Rectangle with a Bound and an array of options. The options can be used to configure properties like 'clickable' directly during construction.

```php
use Ivory\GoogleMap\Base\Base;
use Ivory\GoogleMap\Base\Coordinate;
use Ivory\GoogleMap\Overlay\Rectangle;

$rectangle = new Rectangle(
    new Bound(
        new Coordinate(-1, -1), 
        new Coordinate(1, 1)
    ),
    ['clickable' => false]
);
```

--------------------------------

### Get Address Components

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/place/base/place.md

Retrieves an array of separate address components that form the place's address. This allows for granular access to address details.

```php
$addressComponents = $place->getAddressComponents();
```

--------------------------------

### Configure Project Environment Variables

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/development_environment.md

Copies default configuration files for environment variables and PHPUnit. Users should then update the 'phpunit.xml' file with their specific credentials. This step is crucial before building or running the project.

```bash
cp .env.dist .env
cp phpunit.xml.dist phpunit.xml
```

--------------------------------

### Configure Message Factory with Guzzle

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/service.md

Updates the message factory for services. This example uses Guzzle's message factory, but any HTTPlug-compliant factory can be substituted.

```php
use Http\Message\MessageFactory\GuzzleMessageFactory;

$service->setMessageFactory(new GuzzleMessageFactory());
```

--------------------------------

### Get Place Photos

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/place/base/place.md

Retrieves an array of photo objects, each containing a reference to an image associated with the place. Refer to the photo documentation for more details.

```php
$photos = $place->getPhotos();
```

--------------------------------

### Build InfoWindow with Content (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/overlay/info_window.md

Creates a new InfoWindow instance with basic content. This is the fundamental step for displaying information on the map.

```php
use Ivory\GoogleMap\Overlay\InfoWindow;

$infoWindow = new InfoWindow('content');
```

--------------------------------

### Build a Google Map Instance

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/map.md

Initializes a new Google Map object. This is the first step to rendering a map. No external dependencies are required beyond the Ivory Google Map library itself.

```php
use Ivory\GoogleMap\Map;

$map = new Map();
```

--------------------------------

### Get Prediction Match Offset

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/place/autocomplete/place_autocomplete_response.md

Retrieves the starting offset of a matched term within the prediction result text. This indicates the position where the match begins.

```php
$offset = $match->getOffset();
```

--------------------------------

### Get Rating from Review (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/place/base/review.md

Retrieves the user's overall rating for the place. The rating is a numerical value ranging from 1 to 5.

```php
$rating = $review->getRating();
```

--------------------------------

### Get Prediction Term Offset

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/place/autocomplete/place_autocomplete_response.md

Retrieves the starting offset of a term within the prediction's description. This indicates the position of the term in Unicode characters.

```php
$offset = $term->getOffset();
```

--------------------------------

### Build InfoWindow with Advanced Options (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/overlay/info_window.md

Constructs an InfoWindow with specified content, type, and initial position. Allows for more precise control over the InfoWindow's appearance and placement from the start.

```php
use Ivory\GoogleMap\Base\Coordinate;
use Ivory\GoogleMap\Overlay\InfoWindow;
use Ivory\GoogleMap\Overlay\InfoWindowType;

$infoWindow = new InfoWindow('content', InfoWindowType::INFO_BOX, new Coordinate());
```

--------------------------------

### Get Prediction Types

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/place/autocomplete/place_autocomplete_response.md

Retrieves an array of tags identifying the type of feature returned in the prediction result. For example, 'locality' for a city or 'political' for a political entity.

```php
$types = $prediction->getTypes();
```

--------------------------------

### Build an Icon Object (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/overlay/icon.md

Demonstrates how to instantiate an Icon object in PHP. The constructor can optionally accept parameters for URL, anchor, origin, scaled size, and size.

```php
use Ivory\GoogleMap\Overlay\Icon;

$icon = new Icon();
```

```php
use Ivory\GoogleMap\Base\Point;
use Ivory\GoogleMap\Base\Size;
use Ivory\GoogleMap\Overlay\Icon;

$icon = new Icon(
    Icon::DEFAULT_URL,
    new Point(20, 34),
    new Point(0, 0),
    new Size(20, 34),
    new Size(40, 68)
);
```

--------------------------------

### Build GeoJSON Layer with URL and Options (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/layer/geo_json_layer.md

Shows how to instantiate a GeoJsonLayer with both the GeoJSON data URL and an array of configuration options. This allows for immediate customization upon creation.

```php
use Ivory\GoogleMap\Layer\GeoJsonLayer;

$geoJsonLayer = new GeoJsonLayer(
    'https://storage.googleapis.com/mapsdevsite/json/google.json',
    ['idPropertyName' => 'id']
);
```

--------------------------------

### Get Available Travel Modes (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/direction/direction_response.md

Retrieves an array of available travel modes for the given waypoints. This is useful when a request specifies a travel mode but gets no results.

```php
$availableTravelModes = $response->getAvailableTravelModes();
```

--------------------------------

### Run PHPUnit Tests

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/development_environment.md

Executes the PHPUnit test suite within the running Docker container. This command is used to verify the project's functionality and identify any issues.

```bash
docker exec ivory-google-map_php_1 vendor/bin/phpunit
```

--------------------------------

### Build a Detailed Marker with All Options

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/overlay/marker.md

Shows how to construct a marker with all possible parameters, including animation, icon, symbol, shape, and additional options. If both an icon and a symbol are provided, the icon takes precedence.

```php
use Ivory\GoogleMap\Base\Coordinate;
use Ivory\GoogleMap\Overlay\Animation;
use Ivory\GoogleMap\Overlay\Icon;
use Ivory\GoogleMap\Overlay\Marker;
use Ivory\GoogleMap\Overlay\MarkerShape;
use Ivory\GoogleMap\Overlay\MarkerShapeType;
use Ivory\GoogleMap\Overlay\Symbol;
use Ivory\GoogleMap\Overlay\SymbolPath;

$marker = new Marker(
    new Coordinate(),
    Animation::BOUNCE,
    new Icon(),
    new Symbol(SymbolPath::CIRCLE),
    new MarkerShape(MarkerShapeType::CIRCLE, [1.1, 2.1, 1.4]),
    ['clickable' => false]
);
```

--------------------------------

### Get Next Page Token for Place Search Pagination (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/place/search/place_search_response.md

This code demonstrates how to get the next page token from a PlaceSearchResponse in PHP. This token is used internally by the iterator to handle pagination of search results.

```php
$nextPageToken = $response->getNextPageToken();
```

--------------------------------

### Build Circle with Default Options

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/overlay/circle.md

Demonstrates how to create a new Circle object with a default coordinate for its center. This is the basic initialization for a circle.

```php
use Ivory\GoogleMap\Base\Coordinate;
use Ivory\GoogleMap\Overlay\Circle;

$circle = new Circle(new Coordinate());
```

--------------------------------

### Install Ivory Google Map Bundle for Symfony

Source: https://github.com/bresam/ivory-google-map/blob/master/README.md

This command installs the Ivory Google Map Bundle for Symfony using Composer. This bundle provides integration with the Symfony framework, simplifying map management within Symfony applications.

```bash
composer require ivory/google-map-bundle
```

--------------------------------

### Build Fullscreen Control - PHP

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/control/fullscreen.md

Demonstrates how to instantiate a FullscreenControl object in PHP. The constructor can optionally accept a ControlPosition argument to set the initial placement of the control on the map.

```php
use Ivory\GoogleMap\Control\FullscreenControl;

$fullscreenControl = new FullscreenControl();
```

```php
use Ivory\GoogleMap\Control\ControlPosition;
use Ivory\GoogleMap\Control\FullscreenControl;

$fullscreenControl = new FullscreenControl(ControlPosition::TOP_LEFT);
```

--------------------------------

### Build Circle with Custom Radius and Options

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/overlay/circle.md

Shows how to instantiate a Circle object with a specified radius and an array of options. The options allow for customization of the circle's appearance and behavior.

```php
use Ivory\GoogleMap\Base\Coordinate;
use Ivory\GoogleMap\Overlay\Circle;

$circle = new Circle(new Coordinate(), 10, ['clickable' => false]);
```

--------------------------------

### Get End Address (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/direction/direction_response.md

Retrieves the human-readable street address for the end location of a leg.

```php
$endAddress = $leg->getEndAddress();
```

--------------------------------

### Get End Location (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/direction/direction_response.md

Retrieves the ending coordinate of a leg. This is represented by a Coordinate object.

```php
$endLocation = $leg->getEndLocation();
```

--------------------------------

### Build Polyline with Parameters - PHP

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/overlay/polyline.md

Shows how to build a Polyline object with initial coordinates, icon sequences, and options using the constructor in PHP. This allows for immediate configuration upon creation.

```php
use Ivory\GoogleMap\Base\Coordinate;
use Ivory\GoogleMap\Overlay\IconSequence;
use Ivory\GoogleMap\Overlay\Polyline;
use Ivory\GoogleMap\Overlay\Symbol;
use Ivory\GoogleMap\Overlay\SymbolPath;

$polyline = new Polyline(
    [
        new Coordinate(25.774, -80.190),
        new Coordinate(18.466, -66.118),
        new Coordinate(32.321, -64.757),
        new Coordinate(25.774, -80.190),
    ],
    [
        new IconSequence(new Symbol(SymbolPath::FORWARD_OPEN_ARROW)),
    ],
    ['fillOpacity' => 0.5]
);
```

--------------------------------

### Build Static Map Helper - PHP

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/helper/static_map.md

Initializes and builds a static map helper using Ivory's StaticMapHelperBuilder. This is the first step to rendering static Google Maps. It requires the Ivory Google Map library.

```php
use Ivory\GoogleMap\Helper\Builder\StaticMapHelperBuilder;

$staticMapHelperBuilder = StaticMapHelperBuilder::create(); 
$staticMapHelper = $staticMapHelperBuilder->build();
```

--------------------------------

### Get Route Warnings (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/direction/direction_response.md

Retrieves an array of warnings associated with the route that should be displayed to the user.

```php
$warnings = $route->getWarnings();
```

--------------------------------

### Build Heatmap Layer (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/layer/heatmap_layer.md

Initializes a new HeatmapLayer object. The constructor can optionally accept an array of Coordinates and an array of options for initial configuration. If no arguments are provided, default empty arrays are used.

```php
use Ivory\GoogleMap\Layer\HeatmapLayer;

$heatmapLayer = new HeatmapLayer();
```

--------------------------------

### Get Route Summary (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/direction/direction_response.md

Retrieves a short textual description of the route, suitable for display.

```php
$summary = $route->getSummary();
```

--------------------------------

### Build API Helper - PHP

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/helper/api.md

Demonstrates how to build an API helper using ApiHelperBuilder in PHP. This is the initial step for API rendering, allowing configuration of various aspects like JSON builder, formatter, API key, language, and subscribers.

```php
use Ivory\GoogleMap\Helper\Builder\ApiHelperBuilder;

$apiHelperBuilder = ApiHelperBuilder::create();
$apiHelper = $apiHelperBuilder->build();
```

--------------------------------

### Get Route Fare (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/direction/direction_response.md

Retrieves the total fare for the route, if available and applicable for transit requests.

```php
$fare = $route->getFare();
```

--------------------------------

### Get Route Copyrights (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/direction/direction_response.md

Retrieves the copyright information for the route. This text must be displayed by the user.

```php
$copyrights = $route->getCopyrights();
```

--------------------------------

### Get Geocoded Waypoints (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/direction/direction_response.md

Retrieves an array containing details about the geocoding of origin, destination, and waypoints.

```php
$geocodedWaypoints = $response->getGeocodedWaypoints();
```

--------------------------------

### Build Scale Control - PHP

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/control/scale.md

Demonstrates how to create a new ScaleControl object. The constructor can optionally accept position and style parameters.

```php
use Ivory\GoogleMap\Control\ScaleControl;

$scaleControl = new ScaleControl();
```

```php
use Ivory\GoogleMap\Control\ControlPosition;
use Ivory\GoogleMap\Control\ScaleControl;
use Ivory\GoogleMap\Control\ScaleControlStyle;

$scaleControl = new ScaleControl(
    ControlPosition::BOTTOM_LEFT,
    ScaleControlStyle::DEFAULT_
);
```

--------------------------------

### Get Geometry Location

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/base/geometry.md

Retrieves the location of the geometry as a Coordinate object. This method is part of the Geometry class.

```php
$location = $geometry->getLocation();
```

--------------------------------

### Build Polyline - PHP

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/overlay/polyline.md

Demonstrates how to instantiate a Polyline object in PHP. The constructor can optionally accept initial coordinates, icon sequences, and options.

```php
use Ivory\GoogleMap\Overlay\Polyline;

$polyline = new Polyline();
```

--------------------------------

### Build a Basic Marker

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/overlay/marker.md

Demonstrates the basic construction of a marker using its coordinate. The constructor requires a Coordinate object to define the marker's position.

```php
use Ivory\GoogleMap\Base\Coordinate;
use Ivory\GoogleMap\Overlay\Marker;

$marker = new Marker(new Coordinate());
```

--------------------------------

### Build Place Detail Service (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/place/detail/place_detail.md

Initializes the PlaceDetailService with an HTTP client and message factory. It relies on Httplug for HTTP communication and supports various client implementations. The constructor requires an HttpClient and a MessageFactory.

```php
use Ivory\GoogleMap\Service\Place\Detail\PlaceDetailService;
use Http\Adapter\Guzzle7\Client;
use Http\Message\MessageFactory\GuzzleMessageFactory;

$detail = new PlaceDetailService(new Client(), new GuzzleMessageFactory());
```

--------------------------------

### Get Step Instructions (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/direction/direction_response.md

Retrieves the formatted instructions for a specific step, provided as an HTML text string.

```php
$instructions = $step->getInstructions();
```

--------------------------------

### Get Step End Location (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/direction/direction_response.md

Retrieves the ending coordinate for a specific step. This is represented by a Coordinate object.

```php
$endLocation = $step->getEndLocation();
```

--------------------------------

### Build GeoJSON Layer with URL (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/layer/geo_json_layer.md

Demonstrates how to create a new GeoJsonLayer instance by providing a URL to the GeoJSON data. This is the initial step for rendering geospatial data on a map.

```php
use Ivory\GoogleMap\Layer\GeoJsonLayer;

$geoJsonLayer = new GeoJsonLayer('https://storage.googleapis.com/mapsdevsite/json/google.json');
```

--------------------------------

### Get Leg Duration (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/direction/direction_response.md

Retrieves the Duration object representing the total duration of a specific leg of the route.

```php
$duration = $leg->getDuration();
```

--------------------------------

### Get Route Bound (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/direction/direction_response.md

Retrieves the bound object, which defines the viewport bounding box for a specific route.

```php
$bound = $route->getBound();
```

--------------------------------

### Build Icon Sequence with Symbols and Options - PHP

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/overlay/icon_sequence.md

Shows how to create an IconSequence in PHP, providing both an array of symbols and an options array to the constructor. This allows for immediate configuration of properties like 'offset'.

```php
use Ivory\GoogleMap\Overlay\IconSequence;
use Ivory\GoogleMap\Overlay\Symbol;
use Ivory\GoogleMap\Overlay\SymbolPath;

$iconSequence = new IconSequence(
    [new Symbol(SymbolPath::FORWARD_OPEN_ARROW)], 
    ['offset' => '100%']
);
```

--------------------------------

### Get Place Geometry

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/place/base/place.md

Retrieves technical geographic information about the place. For more details, refer to the geometry documentation.

```php
$geometry = $place->getGeometry();
```

--------------------------------

### Build Zoom Control - PHP

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/control/zoom.md

This snippet demonstrates how to instantiate a new Zoom Control object in PHP. The constructor can optionally accept parameters for position and style.

```php
use Ivory\GoogleMap\Control\ZoomControl;

$zoomControl = new ZoomControl();
```

```php
use Ivory\GoogleMap\Control\ControlPosition;
use Ivory\GoogleMap\Control\ZoomControl;
use Ivory\GoogleMap\Control\ZoomControlStyle;

$zoomControl = new ZoomControl(
    ControlPosition::TOP_LEFT,
    ZoomControlStyle::DEFAULT_
);
```

--------------------------------

### Build Rotate Control (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/control/rotate.md

Demonstrates how to instantiate a Rotate Control object in PHP. The constructor can optionally accept a ControlPosition argument to set the initial placement of the control on the map.

```php
use Ivory\GoogleMap\Control\RotateControl;

$rotateControl = new RotateControl();
```

```php
use Ivory\GoogleMap\Control\ControlPosition;
use Ivory\GoogleMap\Control\RotateControl;

$rotateControl = new RotateControl(ControlPosition::TOP_LEFT);
```

--------------------------------

### Get Formatted Address

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/place/base/place.md

Retrieves the complete human-readable address of the place. This string includes all components of the address.

```php
$formattedAddress = $place->getFormattedAddress();
```

--------------------------------

### Get Place Name

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/place/base/place.md

Retrieves the human-readable name of the place. This is the primary name displayed for the search result.

```php
$name = $place->getName();
```

--------------------------------

### Build Heatmap Layer with Coordinates and Options (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/layer/heatmap_layer.md

Constructs a HeatmapLayer with initial data points (coordinates) and configuration options. This allows for immediate visualization of heatmap intensity at specified geographical locations with specific rendering properties like 'dissipating'.

```php
use Ivory\GoogleMap\Base\Coordinate;
use Ivory\GoogleMap\Layer\HeatmapLayer;

$heatmapLayer = new HeatmapLayer(
    [
        new Coordinate(37.782551, -122.445368),
        new Coordinate(37.782745, -122.444586),
        new Coordinate(37.782842, -122.443688),
        new Coordinate(37.782919, -122.442815),
        new Coordinate(37.782992, -122.442112),
        new Coordinate(37.783100, -122.441461),
        new Coordinate(37.783206, -122.440829),
        new Coordinate(37.783273, -122.440324),
        new Coordinate(37.783316, -122.440023),
        new Coordinate(37.783357, -122.439794),
        new Coordinate(37.783371, -122.439687),
        new Coordinate(37.783368, -122.439666),
        new Coordinate(37.783383, -122.439594),
        new Coordinate(37.783508, -122.439525),
        new Coordinate(37.783842, -122.439591),
        // ...
    ],
    ['dissipating' => true]
);
```

--------------------------------

### Get Review Submission Time (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/place/base/review.md

Retrieves the time when the review was submitted. The returned value is a DateTime object.

```php
$time = $review->getTime();
```

--------------------------------

### Build Street View Control (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/control/street_view.md

Demonstrates how to instantiate a Street View control object using the Ivory Google Map library. The constructor can optionally accept a control position.

```php
use Ivory\GoogleMap\Control\StreetViewControl;

$streetViewControl = new StreetViewControl();
```

```php
use Ivory\GoogleMap\Control\ControlPosition;
use Ivory\GoogleMap\Control\StreetViewControl;

$streetViewControl = new StreetViewControl(ControlPosition::TOP_LEFT);
```

--------------------------------

### Get Leg Distance (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/direction/direction_response.md

Retrieves the Distance object representing the total distance covered by a specific leg of the route.

```php
$duration = $leg->getDistance();
```

--------------------------------

### Get Route Overview Polyline (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/direction/direction_response.md

Retrieves the encoded polyline string representing the route's overview path.

```php
$overviewPolyline = $route->getOverviewPolyline();
```

--------------------------------

### Configure Google Maps Event Properties (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/event.md

Provides examples for configuring individual properties of a Google Maps event instance. This includes setting the target instance, event name, JavaScript handle, and the capture flag.

```php
$event->setInstance($instance);
```

```php
$event->setEventName($eventName);
```

```php
$event->setHandle($handle);
```

```php
$event->setCapture(true);
```

--------------------------------

### Build Basic Symbol (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/overlay/symbol.md

Demonstrates how to create a basic symbol using the SymbolPath::CIRCLE constant in PHP. This is the initial step for rendering a symbol on a map.

```php
use Ivory\GoogleMap\Overlay\Symbol;
use Ivory\GoogleMap\Overlay\SymbolPath;

$symbol = new Symbol(SymbolPath::CIRCLE);
```

--------------------------------

### Get Route Legs (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/direction/direction_response.md

Retrieves an array of leg objects for the route. Each leg represents a segment between waypoints or the destination.

```php
$legs = $route->getLegs();
```

--------------------------------

### Get Place Scope

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/place/base/place.md

Retrieves the scope of the place, indicating its nature. The available values are defined by the PlaceScope constants.

```php
$scope = $place->getScope();
```

--------------------------------

### Configure InfoWindow Open State (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/overlay/info_window.md

Determines whether the InfoWindow is visible when the map initially loads. Setting this to true makes the InfoWindow appear by default.

```php
$infoWindow->setOpen(true);
```

--------------------------------

### Get Transit Agency URL - PHP

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/direction/direction_transit_details.md

Fetches the URL for the transit agency from a DirectionTransitAgency object.

```php
$url = $agency->getUrl();
```

--------------------------------

### Configure Rectangle Option (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/overlay/rectangle.md

Illustrates how to set individual options for a Rectangle object after its creation using the `setOption` method. This allows for dynamic configuration of properties like 'clickable'.

```php
$rectangle->setOption('clickable', false);
```

--------------------------------

### Get Transit Agency Name - PHP

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/direction/direction_transit_details.md

Extracts the name of the transit agency from a DirectionTransitAgency object.

```php
$name = $agency->getName();
```

--------------------------------

### Build a Polygon Object

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/overlay/polygon.md

Demonstrates the basic construction of a Polygon object. The constructor can optionally accept an array of coordinates and an options array.

```php
use Ivory\GoogleMap\Overlay\Polygon;

$polygon = new Polygon();
```

```php
use Ivory\GoogleMap\Base\Coordinate;
use Ivory\GoogleMap\Overlay\Polygon;

$polygon = new Polygon(
    [
        new Coordinate(25.774, -80.190),
        new Coordinate(18.466, -66.118),
        new Coordinate(32.321, -64.757),
        new Coordinate(25.774, -80.190),
    ],
    ['fillOpacity' => 0.5]
);
```

--------------------------------

### Get Geometry Viewport

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/base/geometry.md

Retrieves the recommended viewport for the returned result as a Bound object. This is useful for displaying the geometry on a map.

```php
$viewport = $geometry->getViewport();
```

--------------------------------

### Get Step Encoded Polyline (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/direction/direction_response.md

Retrieves the encoded polyline representation of a specific step, used for drawing the route on a map.

```php
$encodedPolyline = $step->getEncodedPolyline();
```

--------------------------------

### Configure Debugging - PHP

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/helper/api.md

Demonstrates how to enable and configure debugging for the generated code using the ApiHelperBuilder's formatter in PHP. This helps in easily debugging the output.

```php
$apiHelperBuilder->getFormatter()->setDebug(true);
$apiHelperBuilder->getFormatter()->setIndentationStep(4);
```

--------------------------------

### Get Step Distance (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/direction/direction_response.md

Retrieves the distance covered by a specific step until the next step. This field can be null if the distance is unknown.

```php
$distance = $step->getDistance();
```

--------------------------------

### Get Place Types

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/place/base/place.md

Retrieves an array of feature types that describe the place. The available types are defined by the PlaceType constants.

```php
$types = $place->getTypes();
```

--------------------------------

### Create Basic Google Map with PHP

Source: https://context7.com/bresam/ivory-google-map/llms.txt

This snippet demonstrates how to create a basic Google Map instance using the Ivory Google Map library. It configures the map's center, zoom level, map type, and container styling. It also shows how to build and render the necessary HTML and JavaScript for map display using helper builders.

```php
use Ivory\GoogleMap\Base\Coordinate;
use Ivory\GoogleMap\Helper\Builder\ApiHelperBuilder;
use Ivory\GoogleMap\Helper\Builder\MapHelperBuilder;
use Ivory\GoogleMap\Map;
use Ivory\GoogleMap\MapTypeId;

// Create a new map instance
$map = new Map();

// Configure the map
$map->setHtmlId('my_map_canvas');
$map->setAutoZoom(false);
$map->setCenter(new Coordinate(48.8566, 2.3522)); // Paris coordinates
$map->setMapOption('zoom', 12);
$map->setMapOption('mapTypeId', MapTypeId::ROADMAP);

// Configure map container styling
$map->setStylesheet('width', '800px');
$map->setStylesheet('height', '600px');
$map->setHtmlAttribute('class', 'google-map-container');

// Build the helpers
$mapHelper = MapHelperBuilder::create()->build();
$apiHelper = ApiHelperBuilder::create()
    ->setKey('YOUR_GOOGLE_MAPS_API_KEY')
    ->setLanguage('en')
    ->build();

// Render the map
echo $mapHelper->render($map);  // Outputs: <style>, <div>, and map <script>
echo $apiHelper->render([$map]); // Outputs: Google API loader script
```

--------------------------------

### Get Routes from Direction Response (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/direction/direction_response.md

Retrieves an array of DirectionRoute objects from the direction response. A request can return multiple routes.

```php
$routes = $reponse->getRoutes();
```

--------------------------------

### Build Ground Overlay with URL and Bound - PHP

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/overlay/ground_overlay.md

Constructs a GroundOverlay object with a specified image URL and geographical bounds. The constructor requires the image URL and a Bound object, which defines the overlay's area on the map. Additional options can be passed as an associative array.

```php
use Ivory\GoogleMap\Overlay\GroundOverlay;
use Ivory\GoogleMap\Helper\Bound;
use Ivory\GoogleMap\Helper\Coordinate;

$groundOverlay = new GroundOverlay(
    'https://www.lib.utexas.edu/maps/historical/newark_nj_1922.jpg',
    new Bound(new Coordinate(40.712216, -74.22655), new Coordinate(40.773941, -74.12544))
);
```

```php
use Ivory\GoogleMap\Overlay\GroundOverlay;
use Ivory\GoogleMap\Helper\Bound;
use Ivory\GoogleMap\Helper\Coordinate;

$groundOverlay = new GroundOverlay(
    'https://www.lib.utexas.edu/maps/historical/newark_nj_1922.jpg',
    new Bound(new Coordinate(40.712216, -74.22655), new Coordinate(40.773941, -74.12544)),
    ['clickable' => false]
);
```

--------------------------------

### Build a Google Maps Event (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/event.md

Demonstrates how to create a new event instance for the Google Maps API. This includes specifying the target variable, event name, and the JavaScript function to handle the event. An optional capture flag can also be set.

```php
use Ivory\GoogleMap\Event\Event;

$event = new Event(
    $marker->getVariable(),
    'click',
    'function(){alert("Marker clicked!");}'
);
```

```php
use Ivory\GoogleMap\Event\Event;

$event = new Event(
    $marker->getVariable(),
    'click',
    'function(){alert("Marker clicked!");}',
    true
);
```

--------------------------------

### Build Place Autocomplete Helper - PHP

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/helper/place_autocomplete.md

Demonstrates how to build a place autocomplete helper using the PlaceAutocompleteHelperBuilder. This helper is essential for rendering place autocompletes and can be configured with JSON builders, formatters, and subscribers.

```php
use Ivory\GoogleMap\Helper\Builder\PlaceAutocompleteHelperBuilder;

$placeAutocompleteHelperBuilder = PlaceAutocompleteHelperBuilder::create();
$placeAutocompleteHelper = $placeAutocompleteHelperBuilder->build();
```

--------------------------------

### Get Geocoded Waypoint Place ID (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/direction/direction_response.md

Retrieves the unique Place ID for a geocoded waypoint, which can be used with other Google APIs.

```php
$placeId = $geocodedWaypoint->getPlaceId();
```

--------------------------------

### Get Author Name from Review (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/place/base/review.md

Retrieves the name of the user who submitted the review. This is a direct getter method from the Review object.

```php
$authorName = $review->getAuthorName();
```

--------------------------------

### Get Transit Line Name - PHP

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/direction/direction_transit_details.md

Extracts the full name of the transit line from the DirectionTransitLine object.

```php
$name = $line->getName();
```

--------------------------------

### Build Distance Matrix Service with Serializer (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/distance_matrix/distance_matrix.md

Initializes the Distance Matrix Service with a PSR-6 cache pool for improved performance by avoiding repeated metadata parsing. Requires Httplug and Ivory Serializer dependencies.

```php
use Ivory\GoogleMap\Service\DistanceMatrix\DistanceMatrixService;
use Ivory\GoogleMap\Service\Serializer\SerializerBuilder;
use Http\Adapter\Guzzle7\Client;
use Http\Message\MessageFactory\GuzzleMessageFactory;

$distanceMatrix = new DistanceMatrixService(
    new Client(),
    new GuzzleMessageFactory(),
    SerializerBuilder::create($psr6Pool)
);
```

--------------------------------

### Get Geometry Bound

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/base/geometry.md

Retrieves the full viewport for the returned result as a Bound object. This represents the complete area covered by the geometry.

```php
$bound = $geometry->getBound();
```

--------------------------------

### Get Duration Text - PHP

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/base/duration.md

Retrieves the human-readable string representation of the duration. This method is part of the Duration class and returns a string.

```php
$text = $duration->getText();
```

--------------------------------

### Build Map Helper - PHP

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/helper/map.md

Demonstrates how to build a map helper using the MapHelperBuilder. This helper is essential for configuring and rendering map components. It allows customization of JSON builders, formatters, and subscribers.

```php
use Ivory\GoogleMap\Helper\Builder\MapHelperBuilder;

$mapHelperBuilder = MapHelperBuilder::create(); 
$mapHelper = $mapHelperBuilder->build();
```

--------------------------------

### Get Distance Value - PHP

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/base/distance.md

Retrieves the distance value in meters. This provides a numerical representation of the distance for calculations or precise measurements.

```php
$value = $distance->getValue();
```

--------------------------------

### Get Route Waypoint Order (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/direction/direction_response.md

Retrieves an array indicating the order of waypoints in the calculated route, useful if waypoints were reordered for optimization.

```php
$waypointOrders = $route->getWaypointOrders();
```

--------------------------------

### Configure GeoJSON Layer Option (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/layer/geo_json_layer.md

Illustrates how to set individual options for a GeoJsonLayer after its creation. This allows for fine-grained control over how the GeoJSON data is displayed, referencing official documentation for available options.

```php
$geoJsonLayer->setOption('idPropertyName', 'id');
```

--------------------------------

### Get Alternate Place IDs

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/place/base/place.md

Retrieves an array of alternative place IDs for the place, each with an associated scope. This is useful for integrating with other systems.

```php
$alternatePlaceIds = $place->getAlternatePlaceIds();
```

--------------------------------

### Configure Debugging for Place Autocomplete Helper - PHP

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/helper/place_autocomplete.md

Illustrates how to enable and configure debug mode for the place autocomplete helper's formatter. This helps in debugging the generated code by setting debug flags and indentation steps.

```php
$placeAutocompleteHelperBuilder->getFormatter()->setDebug(true);
$placeAutocompleteHelperBuilder->getFormatter()->setIndentationStep(4);
```

--------------------------------

### Configure HTTP Plugins with Cache and Error Handling

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/service.md

Sets up a PluginClient with Retry, HttpErrorPlugin, GoogleErrorPlugin, and CachePlugin. The cache uses Symfony's FilesystemAdapter, with configurable cache lifetime and TTL.

```php
use Http\Adapter\Guzzle7\Client;
use Http\Client\Common\PluginClient;
use Http\Client\Common\Plugin\CachePlugin;
use Http\Client\Common\Plugin\ErrorPlugin as HttpErrorPlugin;
use Http\Client\Common\Plugin\RetryPlugin;
use Http\Message\StreamFactory\GuzzleStreamFactory;
use Ivory\GoogleMap\Service\Plugin\ErrorPlugin as GoogleErrorPlugin;
use Symfony\Component\Cache\Adapter\FilesystemAdapter;

$service->setClient(new PluginClient(new Client(), [
    new RetryPlugin(),
    new HttpErrorPlugin(),
    new GoogleErrorPlugin(),
    new CachePlugin(
        new FilesystemAdapter(__DIR__.'/cache'),
        new GuzzleStreamFactory(),
        [
            'cache_lifetime'        => null,
            'default_ttl'           => null,
            'respect_cache_headers' => false,
        ]
    ),
]));
```

--------------------------------

### Get UTC Offset

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/place/base/place.md

Retrieves the UTC offset for the place's current timezone, measured in minutes. This is useful for time-sensitive calculations.

```php
$utcOffset = $place->getUtcOffset();
```

--------------------------------

### Build Rectangle with Bound (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/overlay/rectangle.md

Demonstrates how to construct a Rectangle object using its constructor, which requires a Bound object defining its area. The Bound is created from two Coordinate objects.

```php
use Ivory\GoogleMap\Base\Base;
use Ivory\GoogleMap\Base\Coordinate;
use Ivory\GoogleMap\Overlay\Rectangle;

$rectangle = new Rectangle(new Bound(
    new Coordinate(-1, -1), 
    new Coordinate(1, 1)
));
```

--------------------------------

### Build Place Detail Service with Cache (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/place/detail/place_detail.md

Constructs the PlaceDetailService with an HTTP client, message factory, and a serializer configured with a PSR-6 cache pool. Using a serializer with caching is recommended to avoid repeated metadata parsing, improving performance.

```php
use Ivory\GoogleMap\Service\Place\Detail\PlaceDetailService;
use Ivory\GoogleMap\Service\Serializer\SerializerBuilder;
use Http\Adapter\Guzzle7\Client;
use Http\Message\MessageFactory\GuzzleMessageFactory;

$detail = new PlaceDetailService(
    new Client(),
    new GuzzleMessageFactory(),
    SerializerBuilder::create($psr6Pool)
);
```

--------------------------------

### Get Place URL

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/place/base/place.md

Retrieves the URL of the official Google page for the place. This page contains the most comprehensive information available about the location.

```php
$url = $place->getUrl();
```

--------------------------------

### Configure Place Autocomplete Helper Subscribers - PHP

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/helper/place_autocomplete.md

Shows how to add subscribers to the place autocomplete helper builder. Subscribers allow you to hook into the map rendering process and attach additional code or logic.

```php
$placeAutocompleteHelperBuilder->addSubscriber(/* ... */);
```

--------------------------------

### Get Aspects from Review (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/place/base/review.md

Retrieves an array of specific ratings or aspects related to the review. Refer to the Aspect Rating documentation for more details.

```php
$aspects = $review->getAspects();
```

--------------------------------

### Client-Side Place Autocomplete Initialization - JavaScript

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/helper/place_autocomplete.md

Demonstrates how to initialize a Google Maps place autocomplete object on the client-side using JavaScript. It shows how the helper attaches the object to a variable for easy access.

```js
my_autocomplete = new google.maps.places.Autocomplete({ /* ... */ });
```

--------------------------------

### Place Photo Service Initialization

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/place/photo/place_photo.md

This snippet shows how to initialize the Place Photo Service. Unlike other services, it does not require an HTTP client or message factory.

```APIDOC
## Place Photo Service Initialization

### Description
Initializes the Place Photo Service. This service is designed for processing photos and does not require HTTP client or message factory dependencies.

### Method
N/A (Initialization)

### Endpoint
N/A

### Parameters
None

### Request Example
```php
use Ivory\GoogleMap\Service\Direction\Place\Photo\PlacePhotoService;

$service = new PlacePhotoService();
```

### Response
N/A (Initialization)

```

--------------------------------

### Get Review Text (PHP)

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/place/base/review.md

Retrieves the textual content of the user's review. This method returns a string containing the review text.

```php
$text = $review->getText();
```

--------------------------------

### Get Prediction Description

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/place/autocomplete/place_autocomplete_response.md

Retrieves the human-readable description of a place prediction. This is typically the name of the place that the user can recognize.

```php
$description = $prediction->getDescription();
```

--------------------------------

### Get Transit Vehicle Name - PHP

Source: https://github.com/bresam/ivory-google-map/blob/master/doc/service/direction/direction_transit_details.md

Extracts the name of the vehicle used on a transit line from the DirectionTransitVehicle object.

```php
$name = $vehicle->getName();
```