PHPackages                             altrntv/yandex-static-api - 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. [API Development](/categories/api)
4. /
5. altrntv/yandex-static-api

ActiveLibrary[API Development](/categories/api)

altrntv/yandex-static-api
=========================

Yandex Static API for Laravel.

v1.0.0(6mo ago)00MITPHPPHP ^8.3CI passing

Since Nov 12Pushed 6mo agoCompare

[ Source](https://github.com/altrntv/yandex-static-api)[ Packagist](https://packagist.org/packages/altrntv/yandex-static-api)[ Docs](https://github.com/altrntv/yandex-static-api)[ RSS](/packages/altrntv-yandex-static-api/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (5)Versions (3)Used By (0)

Yandex Static API for Laravel
=============================

[](#yandex-static-api-for-laravel)

[![Packagist Version](https://camo.githubusercontent.com/18dfc2a36d96ac76aa484b59bed7c3590b9f69847787053be50dc91f7044959e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f616c74726e74762f79616e6465782d7374617469632d6170693f7374796c653d666c61742d737175617265266c6162656c3d72656c65617365)](https://camo.githubusercontent.com/18dfc2a36d96ac76aa484b59bed7c3590b9f69847787053be50dc91f7044959e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f616c74726e74762f79616e6465782d7374617469632d6170693f7374796c653d666c61742d737175617265266c6162656c3d72656c65617365)[![GitHub Actions Workflow Status](https://camo.githubusercontent.com/36c465ad61069fc4accbc3c9873940a6b02a756a2a8345eef4b46b3d9684991f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f616c74726e74762f79616e6465782d7374617469632d6170692f746573742e796d6c3f6272616e63683d6d61696e267374796c653d666c61742d737175617265266c6162656c3d74657374)](https://camo.githubusercontent.com/36c465ad61069fc4accbc3c9873940a6b02a756a2a8345eef4b46b3d9684991f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f616c74726e74762f79616e6465782d7374617469632d6170692f746573742e796d6c3f6272616e63683d6d61696e267374796c653d666c61742d737175617265266c6162656c3d74657374)[![Packagist Downloads](https://camo.githubusercontent.com/2295124275fdcbf381ea0270ddca8abed47064e60eeaa7f194bc00feb738e0e6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f616c74726e74762f79616e6465782d7374617469632d6170693f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/2295124275fdcbf381ea0270ddca8abed47064e60eeaa7f194bc00feb738e0e6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f616c74726e74762f79616e6465782d7374617469632d6170693f7374796c653d666c61742d737175617265)

A simple and fluent PHP client for working with the [Yandex Static Maps API](https://yandex.com/maps-api/products/static-api), built for Laravel. Generate static map images with points, figures, zoom levels, and themes — all via a fluent, expressive interface.

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

[](#installation)

Install the package via Composer:

```
composer require altrntv/yandex-static-api
```

Configuration
-------------

[](#configuration)

Publish the configuration file:

```
php artisan vendor:publish --tag=yandex-static-api-config
```

This will create a config/yandex-static-api.php file:

```
return [
    'api_key' => env('YANDEX_STATIC_API_KEY'),
    'url' => env('YANDEX_STATIC_API_URL', 'https://static-maps.yandex.ru'),
];
```

Then, set your API key in the .env file:

```
YANDEX_STATIC_API_KEY="api_key"
```

Usage
-----

[](#usage)

You can fluently build a map request using the provided methods.

```
use Altrntv\YandexStaticApi\StaticApi;

$point = new Point(longitude: 32.810152, latitude: 39.889847);

$image = StaticApi::make($point)
    ->boundingBox(new BoundingBox(
        new Point(longitude: 32.810152, latitude: 39.889847),
        new Point(longitude: 32.810152, latitude: 39.889847),
    ))
    ->figures([
        new Line(
            coordinates: [32.810152, 39.889847, 32.810152, 39.889847],
            lineColor: '00FF00A0',
            lineWidth: 1,
            borderColor: '00FF00A0',
            borderWidth: 2,
        ),
    ])
    ->language(Language::RussianRussia)
    ->mapType(MapType::Map)
    ->placemarks([
        new Placemark(
            point: new Point(longitude: 32.810152, latitude: 39.889847),
            style: PlacemarkStyle::Pm,
            color: PlacemarkColor::Pink,
            size: PlacemarkSize::Large,
            content: 100,
        ),
    ])
    ->scale(1)
    ->size(new Size(width: 650, height: 450))
    ->span(10)
    ->theme(Theme::Light)
    ->zoom(10)
    ->fetch();
```

Supported Parameters
--------------------

[](#supported-parameters)

ParameterDescriptionExample`point`Longitude and latitude of the map center in degrees.`new Point(longitude: 32.810152, latitude: 39.889847)``boundingBox`Alternative method for setting the map viewport. Defined as lower-left and upper-right coordinates.`new BoundingBox(new Point(...), new Point(...))``span`Range of the map viewport by longitude and latitude (in degrees).`->span(10)``zoom`Map zoom level (0–21).`->zoom(10)``size`Height and width of the requested map image (in pixels).`new Size(width: 650, height: 450)``scale`Coefficient for scaling map objects. Fractional values from 1.0 to 4.0.`->scale(1)``placemarks`Definitions of one or more markers, including coordinates, style, color, size, and optional content.`[new Placemark(new Point(...), style: PlacemarkStyle::Pm, color: PlacemarkColor::Pink, size: PlacemarkSize::Large, content: 100)]``figures`Geometric figures (polylines and polygons) with coordinates, line color/thickness, and fill color.`[new Line(coordinates: [...], lineColor: '00FF00A0', lineWidth: 1, borderColor: '00FF00A0', borderWidth: 2), new Polygon(...)]``language`Map localization.`Language::RussianRussia``style`Map styling and customization of objects’ appearance`tags.any:poi;transit_location|elements:label.text.fill\stylers.color:DD0000``theme`Theme of the requested map image (`light` or `dark`).`Theme::Light``mapType`Predefined map style modes (`map`, `driving`, `transit`, `admin`).`MapType::Map`Testing
-------

[](#testing)

```
composer test
```

Contributing
------------

[](#contributing)

Contributions are welcome! If you’d like to improve this package, please fork the repository and open a pull request. Bug fixes, new features, and documentation improvements are all appreciated.

Credits
-------

[](#credits)

- [Pavel Dykin](https://github.com/altrntv)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance69

Regular maintenance activity

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~0 days

Total

2

Last Release

180d ago

Major Versions

v0.0.1 → v1.0.02025-11-12

### Community

Maintainers

![](https://www.gravatar.com/avatar/7e8e10e960b310abad0078f199ef412b24c396639809d72aaafe57f495e8f4bc?d=identicon)[altrntv](/maintainers/altrntv)

---

Top Contributors

[![altrntv](https://avatars.githubusercontent.com/u/28820687?v=4)](https://github.com/altrntv "altrntv (2 commits)")

---

Tags

laravelmapphpstatic-apiyandexyandex-mapyandex-static-apiyandex-staticmaplaravelyandexyandex-static-api

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/altrntv-yandex-static-api/health.svg)

```
[![Health](https://phpackages.com/badges/altrntv-yandex-static-api/health.svg)](https://phpackages.com/packages/altrntv-yandex-static-api)
```

###  Alternatives

[andreaselia/laravel-api-to-postman

Generate a Postman collection automatically from your Laravel API

1.0k586.2k3](/packages/andreaselia-laravel-api-to-postman)[mollie/laravel-mollie

Mollie API client wrapper for Laravel &amp; Mollie Connect provider for Laravel Socialite

3624.1M28](/packages/mollie-laravel-mollie)[api-ecosystem-for-laravel/dingo-api

A RESTful API package for the Laravel and Lumen frameworks.

3121.5M10](/packages/api-ecosystem-for-laravel-dingo-api)[mll-lab/laravel-graphiql

Easily integrate GraphiQL into your Laravel project

683.2M9](/packages/mll-lab-laravel-graphiql)[kirschbaum-development/laravel-openapi-validator

Automatic OpenAPI validation for Laravel HTTP tests

581.1M5](/packages/kirschbaum-development-laravel-openapi-validator)[surface/laravel-webfinger

A Laravel package to create an ActivityPub webfinger.

113.8k](/packages/surface-laravel-webfinger)

PHPackages © 2026

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