docs(maps): improve tile usage examples

Author: andrepimpao

docs/maps.md

@@ -6,56 +6,61 @@ free and paid subscriptions. See the
 [official Weather Maps documentation](https://openweathermap.org/api/weathermaps)
 for API details.
 
-## Generate A Tile URL
+## Fetch A Tile
 
-Use `tileUrl()` to generate an authenticated URL for a mapping library, image,
-or other client that loads the tile directly.
+Use `tile()` with a layer, zoom level, and X and Y tile coordinates.
 
 ```php
 use ProgrammatorDev\OpenWeatherMap\Enum\MapLayer;
 use ProgrammatorDev\OpenWeatherMap\OpenWeatherMap;
 
 $api = new OpenWeatherMap($_ENV['OPENWEATHERMAP_API_KEY']);
 
-$url = $api->maps()->tileUrl(
+$tile = $api->maps()->tile(
     layer: MapLayer::PRECIPITATION,
     zoom: 6,
     x: 31,
     y: 20,
 );
 ```
 
-Generating the URL does not make an HTTP request. It contains the API key passed
-to `OpenWeatherMap`, so treat it as a credential and avoid including it in logs
-or other unintended output.
+`tile()` returns one 256-by-256 PNG overlay as a `MapTile`. The request is made
+by the PHP application, so the API key is not included in the returned value.
 
-## Fetch A Tile
+```php
+header('Content-Type: ' . $tile->contentType());
 
-Use `tile()` with a layer, zoom level, and X and Y tile coordinates.
+echo $tile->contents();
+```
+
+## Generate A Tile URL
+
+Use `tileUrl()` when an image or another client needs to load one specific tile
+directly. Generating the URL does not make an HTTP request.
 
 ```php
 use ProgrammatorDev\OpenWeatherMap\Enum\MapLayer;
 use ProgrammatorDev\OpenWeatherMap\OpenWeatherMap;
 
 $api = new OpenWeatherMap($_ENV['OPENWEATHERMAP_API_KEY']);
 
-$tile = $api->maps()->tile(
+$url = $api->maps()->tileUrl(
     layer: MapLayer::PRECIPITATION,
     zoom: 6,
     x: 31,
     y: 20,
 );
 ```
 
-`tile()` returns one 256-by-256 PNG overlay as a `MapTile`. The request is made
-by the PHP application, so the API key is not included in the returned value.
+For example, the URL can be used as an image source:
 
 ```php
-header('Content-Type: ' . $tile->contentType());
-
-echo $tile->contents();
+<img src="<?= $url ?>" alt="Precipitation map tile">
 ```
 
+The URL contains the API key passed to `OpenWeatherMap`. Treat it as a
+credential and expose it only where direct client loading is intended.
+
 ## Tile Coordinates
 
 X and Y are tile indexes, not longitude and latitude. Weather Maps uses the