Deprecate metro code

maxmind · Jan 13, 2025 · 8653d6b · 8653d6b
1 parent aa4cf39
commit 8653d6b
Show file tree

Hide file tree

Showing 2 changed files with 10 additions and 5 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,6 +1,12 @@
 CHANGELOG
 =========
 
+3.2.0
+------------------
+
+* `metroCode` on `GeoIp2\Record\Location` has been deprecated. The code
+  values are no longer being maintained.
+
 3.1.0 (2024-11-15)
 ------------------
 
@@ -15,7 +21,7 @@ CHANGELOG
 * IMPORTANT: PHP 8.1 or greater is now required.
 * BREAKING: Read-only properties are now used for the model and record
   classes rather than magic methods. This significantly improves performance.
-* BREAKING: The `raw` property on model classess and the `record` property on
+* BREAKING: The `raw` property on model classes and the `record` property on
   record classes have been removed.
 * BREAKING: On `GeoIp2\Record\Traits`, the deprecated `isAnonymousProxy` and
   `isSatelliteProvider` properties have been removed.

diff --git a/src/Record/Location.php b/src/Record/Location.php
@@ -43,10 +43,9 @@ class Location implements \JsonSerializable
     public readonly ?float $longitude;
 
     /**
-     * @var int|null The metro code of the location if the location
-     *               is in the US. MaxMind returns the same metro codes as the
-     *               Google AdWords API. See
-     *               https://developers.google.com/adwords/api/docs/appendix/cities-DMAregions.
+     * @var int|null The metro code is a no-longer-maintained code for targeting
+     *               advertisements in Google.
+     * @deprecated
      */
     public readonly ?int $metroCode;