linking

Author: spekulatius

README.md

@@ -57,6 +57,18 @@ $places = $client->scrapePlaces(
 );
 ```
 
+**Хелперы Place:**
+
+```php
+$place->hasContactInfo();    // есть телефоны или email
+$place->getFirstPhone();     // первый номер телефона или null
+$place->hasWebsite();        // есть ли сайт
+$place->getCoordinates();    // ['lat' => float, 'lng' => float] или null
+$place->isVerified();        // владелец подтверждён
+$place->hasVideos();         // есть ли видео
+$place->hasMenu();           // есть ли меню
+```
+
 ### Отзывы (Яндекс Карты)
 
 ```php
@@ -79,6 +91,18 @@ foreach ($reviews as $review) {
 }
 ```
 
+**Хелперы Review:**
+
+```php
+$review->hasBusinessReply();      // есть ли ответ компании
+$review->getBusinessReplyText();  // текст ответа или null
+$review->hasPhotos();             // есть ли фото
+$review->hasVideos();             // есть ли видео
+$review->isPositive();            // рейтинг >= 4
+$review->isNegative();            // рейтинг <= 2
+$review->hasTranslation();        // есть ли переводы текста
+```
+
 ### Товары (Яндекс Маркет)
 
 ```php
@@ -107,6 +131,18 @@ foreach ($products as $product) {
 }
 ```
 
+**Хелперы Product:**
+
+```php
+$product->hasReviews();         // есть ли отзывы
+$product->hasImages();          // есть ли фото
+$product->isInStock();          // товар в наличии
+$product->getPriceFormatted();  // "54 990 RUB" или null
+$product->getYaBankDiscount();  // скидка в % (напр. 10.0) или null
+$product->hasUgcImages();       // есть ли пользовательские фото
+$product->hasVideos();          // есть ли видео
+```
+
 ### Недвижимость (Яндекс Недвижимость)
 
 ```php
@@ -141,6 +177,29 @@ foreach ($listings as $listing) {
 }
 ```
 
+**Хелперы Listing:**
+
+```php
+$listing->getPriceValue();       // цена в рублях или null
+$listing->getPriceCurrency();    // валюта ("RUR") или null
+$listing->getPriceTrend();       // "INCREASED", "DECREASED", "UNCHANGED" или null
+$listing->getPreviousPrice();    // предыдущая цена или null
+$listing->getAddress();          // полный адрес или null
+$listing->getCoordinates();      // ['lat' => float, 'lng' => float] или null
+$listing->getCity();             // город или null
+$listing->getRegion();           // регион или null
+$listing->getAreaValue();        // площадь в м² или null
+$listing->hasPhones();           // есть ли телефоны
+$listing->getFirstPhone();       // первый номер или null
+$listing->getWhatsAppPhones();   // номера WhatsApp от автора
+$listing->hasImages();           // есть ли фото
+$listing->hasPriceHistory();     // есть ли история цен
+$listing->getSellerName();       // имя продавца/агентства или null
+$listing->isFromOwner();         // от собственника (не агентство)
+$listing->getBuildingYear();     // год постройки или null
+$listing->getPredictedPrice();   // ['min' => int, 'max' => int, 'value' => int] или null
+```
+
 ## Перечисления
 
 | Enum | Значения |
@@ -189,7 +248,7 @@ try {
 
 ## См. также
 
-- [2GIS Parser PHP](https://github.com/Scraper-APIs/2gis-parser-php) — парсинг 2ГИС (организации, отзывы, недвижимость, вакансии)
+- [2GIS Parser PHP](https://github.com/Scraper-APIs/2gis-parser-php) — парсинг 2ГИС (организации и отзывы, недвижимость, вакансии)
 
 ## Лицензия
 

src/DTO/Place.php

@@ -295,15 +295,15 @@ public function hasWebsite(): bool
     /**
      * Get coordinates as an associative array, or null if not available.
      *
-     * @return array{lng: float, lat: float}|null
+     * @return array{lat: float, lng: float}|null
      */
     public function getCoordinates(): ?array
     {
         if ($this->longitude === null || $this->latitude === null) {
             return null;
         }
 
-        return ['lng' => $this->longitude, 'lat' => $this->latitude];
+        return ['lat' => $this->latitude, 'lng' => $this->longitude];
     }
 
     /**

tests/PlaceTest.php

@@ -111,7 +111,7 @@
 it('gets coordinates', function () {
     $place = Place::fromArray(getSamplePlaceData());
 
-    expect($place->getCoordinates())->toBe(['lng' => 37.600312, 'lat' => 55.764353]);
+    expect($place->getCoordinates())->toBe(['lat' => 55.764353, 'lng' => 37.600312]);
 });
 
 it('checks verified status', function () {