Support v2 search API

Author: ianthetechie

CHANGELOG.md

@@ -5,6 +5,28 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## Version 4.0.0 - 2025-06-11
+
+### Added
+
+- Support for the v2 `search` (forward geocoding) endpoint! The new API includes better structure, more details, and better address formatting.
+
+```diff
+- $result = $this->apiInstance->search("Telliskivi 60a/3, Tallinn, Estonia");
++ $result = $this->apiInstance->searchV2("Telliskivi 60a/3, Tallinn, Estonia");
+```
+
+For an overview of the structural changes we've made in the V2 API,
+refer to the [migration guide](https://docs.stadiamaps.com/geocoding-search-autocomplete/v2-api-migration-guide/).
+
+### Fixed
+
+- **Possibly breaking change:** The `maneuvers` property on route responses was previously marked as required.
+  However, it is possible to explicitly request routes with this field removed.
+  These would fail validation and the whole request would end with an exception
+  in the API client.
+  This has been fixed in this version, so the property is optional.
+
 ## Version 3.3.0 - 2025-06-03
 
 ### Added

README.md

@@ -9,7 +9,6 @@ For more information, please visit [https://docs.stadiamaps.com](https://docs.st
 ### Requirements
 
 PHP 8.1 and later.
-(NOTE: Unit tests use PHP 8-style named arguments.)
 
 ### Composer
 
@@ -18,7 +17,7 @@ To install the bindings via [Composer](https://getcomposer.org/), add something
 ```json
 {
   "require": {
-    "stadiamaps/stadiamaps-api-php": "3.*"
+    "stadiamaps/stadiamaps-api-php": "4.*"
   }
 }
 ```
@@ -66,10 +65,10 @@ $apiInstance = new GeocodingApi(
 $text = '1600 Pennsylvania Ave NW'; // The place name (address, venue name, etc.) to search for.
 
 try {
-    $result = $apiInstance->autocompleteV2($text, lang: 'en');
+    $result = $apiInstance->searchV2($text, lang: 'en');
     print_r($result);
 } catch (Exception $e) {
-    echo 'Exception when calling GeocodingApi->autocomplete: ', $e->getMessage(), PHP_EOL;
+    echo 'Exception when calling GeocodingApi->searchV2: ', $e->getMessage(), PHP_EOL;
 }
 ```
 

lib/Api/GeocodingApi.php

@@ -14,7 +14,7 @@
  *
  * The Stadia Maps Geospatial APIs provide you with the data you need to build awesome applications.
  *
- * The version of the OpenAPI document: 9.3.0
+ * The version of the OpenAPI document: 10.0.0
  * Contact: support@stadiamaps.com
  * Generated by: https://openapi-generator.tech
  * Generator version: 7.13.0

lib/Api/GeospatialApi.php

@@ -14,7 +14,7 @@
  *
  * The Stadia Maps Geospatial APIs provide you with the data you need to build awesome applications.
  *
- * The version of the OpenAPI document: 9.3.0
+ * The version of the OpenAPI document: 10.0.0
  * Contact: support@stadiamaps.com
  * Generated by: https://openapi-generator.tech
  * Generator version: 7.13.0

lib/Api/RoutingApi.php

@@ -14,7 +14,7 @@
  *
  * The Stadia Maps Geospatial APIs provide you with the data you need to build awesome applications.
  *
- * The version of the OpenAPI document: 9.3.0
+ * The version of the OpenAPI document: 10.0.0
  * Contact: support@stadiamaps.com
  * Generated by: https://openapi-generator.tech
  * Generator version: 7.13.0

lib/ApiException.php

@@ -14,7 +14,7 @@
  *
  * The Stadia Maps Geospatial APIs provide you with the data you need to build awesome applications.
  *
- * The version of the OpenAPI document: 9.3.0
+ * The version of the OpenAPI document: 10.0.0
  * Contact: support@stadiamaps.com
  * Generated by: https://openapi-generator.tech
  * Generator version: 7.13.0
@@ -433,7 +433,7 @@ public static function toDebugReport()
         $report  = 'PHP SDK (OpenAPI\Client) Debug Report:' . PHP_EOL;
         $report .= '    OS: ' . php_uname() . PHP_EOL;
         $report .= '    PHP Version: ' . PHP_VERSION . PHP_EOL;
-        $report .= '    The version of the OpenAPI document: 9.3.0' . PHP_EOL;
+        $report .= '    The version of the OpenAPI document: 10.0.0' . PHP_EOL;
         $report .= '    Temp Folder Path: ' . self::getDefaultConfiguration()->getTempFolderPath() . PHP_EOL;
 
         return $report;

lib/Configuration.php

@@ -14,7 +14,7 @@
  *
  * The Stadia Maps Geospatial APIs provide you with the data you need to build awesome applications.
  *
- * The version of the OpenAPI document: 9.3.0
+ * The version of the OpenAPI document: 10.0.0
  * Contact: support@stadiamaps.com
  * Generated by: https://openapi-generator.tech
  * Generator version: 7.13.0

lib/FormDataProcessor.php

@@ -14,7 +14,7 @@
  *
  * The Stadia Maps Geospatial APIs provide you with the data you need to build awesome applications.
  *
- * The version of the OpenAPI document: 9.3.0
+ * The version of the OpenAPI document: 10.0.0
  * Contact: support@stadiamaps.com
  * Generated by: https://openapi-generator.tech
  * Generator version: 7.13.0

lib/HeaderSelector.php

@@ -15,7 +15,7 @@
  *
  * The Stadia Maps Geospatial APIs provide you with the data you need to build awesome applications.
  *
- * The version of the OpenAPI document: 9.3.0
+ * The version of the OpenAPI document: 10.0.0
  * Contact: support@stadiamaps.com
  * Generated by: https://openapi-generator.tech
  * Generator version: 7.13.0