{"id":34762477,"url":"https://github.com/altrntv/yandex-static-api","last_synced_at":"2026-04-23T06:33:16.492Z","repository":{"id":323911589,"uuid":"1094342931","full_name":"altrntv/yandex-static-api","owner":"altrntv","description":"A Laravel wrapper for the Yandex Static Maps API providing an elegant and fluent interface for static map generation.","archived":false,"fork":false,"pushed_at":"2025-11-12T18:53:59.000Z","size":21,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-12T20:29:21.000Z","etag":null,"topics":["laravel","map","php","static-api","yandex","yandex-map","yandex-static-api","yandex-staticmap"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/altrntv.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-11T15:29:18.000Z","updated_at":"2025-11-12T18:46:30.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/altrntv/yandex-static-api","commit_stats":null,"previous_names":["altrntv/yandex-static-api"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/altrntv/yandex-static-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/altrntv%2Fyandex-static-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/altrntv%2Fyandex-static-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/altrntv%2Fyandex-static-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/altrntv%2Fyandex-static-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/altrntv","download_url":"https://codeload.github.com/altrntv/yandex-static-api/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/altrntv%2Fyandex-static-api/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32169657,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-23T02:19:40.750Z","status":"ssl_error","status_checked_at":"2026-04-23T02:17:55.737Z","response_time":53,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["laravel","map","php","static-api","yandex","yandex-map","yandex-static-api","yandex-staticmap"],"created_at":"2025-12-25T06:59:30.795Z","updated_at":"2026-04-23T06:33:16.485Z","avatar_url":"https://github.com/altrntv.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Yandex Static API for Laravel\n\n![Packagist Version](https://img.shields.io/packagist/v/altrntv/yandex-static-api?style=flat-square\u0026label=release)\n![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/altrntv/yandex-static-api/test.yml?branch=main\u0026style=flat-square\u0026label=test)\n![Packagist Downloads](https://img.shields.io/packagist/dt/altrntv/yandex-static-api?style=flat-square)\n\nA simple and fluent PHP client for working with\nthe [Yandex Static Maps API](https://yandex.com/maps-api/products/static-api), built for Laravel. Generate static map\nimages with points, figures, zoom levels, and themes — all via a fluent, expressive interface.\n\n## Installation\n\nInstall the package via Composer:\n\n```bash\ncomposer require altrntv/yandex-static-api\n```\n\n## Configuration\n\nPublish the configuration file:\n\n```bash\nphp artisan vendor:publish --tag=yandex-static-api-config\n```\n\nThis will create a config/yandex-static-api.php file:\n\n```php\nreturn [\n    'api_key' =\u003e env('YANDEX_STATIC_API_KEY'),\n    'url' =\u003e env('YANDEX_STATIC_API_URL', 'https://static-maps.yandex.ru'),\n];\n```\n\nThen, set your API key in the .env file:\n\n```dotenv\nYANDEX_STATIC_API_KEY=\"api_key\"\n```\n\n## Usage\n\nYou can fluently build a map request using the provided methods.\n\n```php\nuse Altrntv\\YandexStaticApi\\StaticApi;\n\n$point = new Point(longitude: 32.810152, latitude: 39.889847);\n\n$image = StaticApi::make($point)\n    -\u003eboundingBox(new BoundingBox(\n        new Point(longitude: 32.810152, latitude: 39.889847),\n        new Point(longitude: 32.810152, latitude: 39.889847),\n    ))\n    -\u003efigures([\n        new Line(\n            coordinates: [32.810152, 39.889847, 32.810152, 39.889847],\n            lineColor: '00FF00A0',\n            lineWidth: 1,\n            borderColor: '00FF00A0',\n            borderWidth: 2,\n        ),\n    ])\n    -\u003elanguage(Language::RussianRussia)\n    -\u003emapType(MapType::Map)\n    -\u003eplacemarks([\n        new Placemark(\n            point: new Point(longitude: 32.810152, latitude: 39.889847),\n            style: PlacemarkStyle::Pm,\n            color: PlacemarkColor::Pink,\n            size: PlacemarkSize::Large,\n            content: 100,\n        ),\n    ])\n    -\u003escale(1)\n    -\u003esize(new Size(width: 650, height: 450))\n    -\u003espan(10)\n    -\u003etheme(Theme::Light)\n    -\u003ezoom(10)\n    -\u003efetch();\n```\n\n## Supported Parameters\n\n| Parameter     | Description                                                                                          | Example                                                                                                                             |\n|---------------|------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------|\n| `point`       | Longitude and latitude of the map center in degrees.                                                 | `new Point(longitude: 32.810152, latitude: 39.889847)`                                                                              |\n| `boundingBox` | Alternative method for setting the map viewport. Defined as lower-left and upper-right coordinates.  | `new BoundingBox(new Point(...), new Point(...))`                                                                                   |\n| `span`        | Range of the map viewport by longitude and latitude (in degrees).                                    | `-\u003espan(10)`                                                                                                                        |\n| `zoom`        | Map zoom level (0–21).                                                                               | `-\u003ezoom(10)`                                                                                                                        |\n| `size`        | Height and width of the requested map image (in pixels).                                             | `new Size(width: 650, height: 450)`                                                                                                 |\n| `scale`       | Coefficient for scaling map objects. Fractional values from 1.0 to 4.0.                              | `-\u003escale(1)`                                                                                                                        |\n| `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)]` |\n| `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(...)]`    |\n| `language`    | Map localization.                                                                                    | `Language::RussianRussia`                                                                                                           |\n| `style`       | Map styling and customization of objects’ appearance                                                 | `tags.any:poi;transit_location\\|elements:label.text.fill\\stylers.color:DD0000`                                                      |                                                                                                                                                      |\n| `theme`       | Theme of the requested map image (`light` or `dark`).                                                | `Theme::Light`                                                                                                                      |\n| `mapType`     | Predefined map style modes (`map`, `driving`, `transit`, `admin`).                                   | `MapType::Map`                                                                                                                      |\n\n## Testing\n\n```bash\ncomposer test\n```\n\n## Contributing\n\nContributions are welcome! If you’d like to improve this package, please fork the repository and open a pull request.\nBug fixes, new features, and documentation improvements are all appreciated.\n\n## Credits\n\n- [Pavel Dykin](https://github.com/altrntv)\n- [All Contributors](../../contributors)\n\n## License\n\nThe MIT License (MIT). Please see [License File](LICENSE.md) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faltrntv%2Fyandex-static-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faltrntv%2Fyandex-static-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faltrntv%2Fyandex-static-api/lists"}