flutter_map

https://docs.fleaflet.dev/
Admin
flutter_map is Flutter's leading non-commercially aimed, easy-to-use, versatile, vendor-free, fully...
Tokens:23,307
Snippets:353
Trust Score:5.9
Update:2 months ago
Show doc for...
Tokens:
Raw
### GET /plugins/create.md

Source: https://docs.fleaflet.dev/plugins/create.md

Queries the documentation dynamically by providing a specific question and an optional end goal.

```APIDOC
## GET /plugins/create.md

### Description
Perform an HTTP GET request on the current page URL to query the documentation dynamically when information is not explicitly present or clarification is needed.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/plugins/create.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The specific, self-contained question to ask.
- **goal** (string) - Optional - The broader end goal to help tailor the answer.
```

--------------------------------

### GET /getting-started.md

Source: https://docs.fleaflet.dev/getting-started

Queries the documentation for an answer to a specific question, optionally providing a broader goal for context.

```APIDOC
## GET /getting-started.md

### Description
Queries the documentation dynamically by asking a question. The response provides a direct answer along with relevant excerpts and sources.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/getting-started.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The immediate question to ask.
- **goal** (string) - Optional - The broader end goal to help tailor the answer.

### Response
#### Success Response (200)
- **answer** (string) - The direct answer to the question.
- **excerpts** (array) - Relevant excerpts from the documentation.
- **sources** (array) - Sources used to generate the answer.
```

--------------------------------

### GET /getting-started/installation.md

Source: https://docs.fleaflet.dev/getting-started/installation.md

Queries the documentation for specific information by providing a natural language question and an optional end goal.

```APIDOC
## GET /getting-started/installation.md

### Description
Queries the documentation dynamically to retrieve answers, excerpts, and sources based on a provided question.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/getting-started/installation.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The specific, self-contained question to ask.
- **goal** (string) - Optional - The broader end goal to help tailor the response context.
```

--------------------------------

### Define Proj4 string

Source: https://docs.fleaflet.dev/usage/options/custom-crss.md

Example of a Proj4 definition string for EPSG:3413.

```text
+proj=stere +lat_0=90 +lat_ts=70 +lon_0=-45 +k=1 +x_0=0 +y_0=0 +datum=WGS84 +units=m + no_defs
```

--------------------------------

### GET /usage/basics.md

Source: https://docs.fleaflet.dev/about/faqs.php

Perform a query against the documentation index to receive a direct answer and relevant excerpts.

```APIDOC
## GET https://docs.fleaflet.dev/usage/basics.md

### Description
Perform an HTTP GET request on the documentation index to retrieve answers to specific questions, optionally providing a broader goal for better context.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/usage/basics.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The immediate question to ask, written in natural language.
- **goal** (string) - Optional - Describes the broader end goal to help tailor the response.
```

--------------------------------

### GET /plugins/create/tile-providers.md

Source: https://docs.fleaflet.dev/plugins/create/tile-providers.md

Queries the documentation page for information using a natural language question and an optional goal.

```APIDOC
## GET /plugins/create/tile-providers.md

### Description
Perform a query against the documentation page to retrieve answers, excerpts, and sources.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/plugins/create/tile-providers.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The specific, self-contained natural language question.
- **goal** (string) - Optional - The broader end goal to help tailor the response.
```

--------------------------------

### GET /thanks/supporters.md

Source: https://docs.fleaflet.dev/thanks/supporters.md

Perform an HTTP GET request on a documentation page URL to retrieve answers to specific questions based on the documentation content.

```APIDOC
## GET /thanks/supporters.md

### Description
Perform an HTTP GET request on the current page URL with query parameters to ask questions and retrieve relevant documentation excerpts.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/thanks/supporters.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The immediate question to ask, written in natural language.
- **goal** (string) - Optional - The broader end goal to help tailor the answer.
```

--------------------------------

### GET /usage/programmatic-interaction.md

Source: https://docs.fleaflet.dev/usage/programmatic-interaction.md

Perform a query against the documentation to retrieve answers and relevant excerpts.

```APIDOC
## GET /usage/programmatic-interaction.md

### Description
Queries the documentation dynamically to receive a direct answer and relevant excerpts based on a specific question.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/usage/programmatic-interaction.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The specific, self-contained question to ask.
- **goal** (string) - Optional - The broader end goal to help tailor the response.

### Response
#### Success Response (200)
- **answer** (string) - A direct answer to the question.
- **excerpts** (array) - Relevant excerpts and sources from the documentation.
```

--------------------------------

### Create Proj4Crs instance

Source: https://docs.fleaflet.dev/usage/options/custom-crss.md

Full example of configuring a Proj4Crs object with resolutions, bounds, and origins.

```dart
var epsg3413 = proj4.Projection.add('EPSG:3413',
    '+proj=stere +lat_0=90 +lat_ts=70 +lon_0=-45 +k=1 +x_0=0 +y_0=0 +datum=WGS84 +units=m +no_defs');

final resolutions = <double>[
  32768,
  16384,
  8192,
  4096,
  2048,
  1024,
  512,
  256,
  128,
];

final epsg3413Bounds = Bounds<double>(
  Point<double>(-4511619.0, -4511336.0),
  Point<double>(4510883.0, 4510996.0),
);

var maxZoom = (resolutions.length - 1).toDouble();

var epsg3413CRS = Proj4Crs.fromFactory(
  code: 'EPSG:3413',
  proj4Projection: epsg3413,
  resolutions: resolutions,
  bounds: epsg3413Bounds,
  origins: [Point(0, 0)],
  scales: null,
  transformation: null,
);
```

--------------------------------

### GET /getting-started/new-in-v8.md

Source: https://docs.fleaflet.dev/getting-started/new-in-v8.md

Perform a query against the documentation to retrieve answers and relevant excerpts based on a specific question and optional goal.

```APIDOC
## GET /getting-started/new-in-v8.md

### Description
Queries the documentation dynamically to retrieve an answer and relevant excerpts based on a provided question.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/getting-started/new-in-v8.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The specific, self-contained question to ask.
- **goal** (string) - Optional - The broader end goal to help tailor the response.

### Request Example
GET https://docs.fleaflet.dev/getting-started/new-in-v8.md?ask=What is new in v8?&goal=Upgrade project
```

--------------------------------

### GET /thanks.md

Source: https://docs.fleaflet.dev/thanks

Queries the documentation for information by providing a question and an optional goal.

```APIDOC
## GET /thanks.md

### Description
Perform a dynamic query against the documentation to retrieve answers, excerpts, and sources based on a specific question.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/thanks.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The immediate question to ask.
- **goal** (string) - Optional - The broader end goal to help tailor the response.
```

--------------------------------

### GET /why-and-how/demo-and-examples.md

Source: https://docs.fleaflet.dev/why-and-how/demo-and-examples.md

Performs a dynamic query against the documentation page to retrieve an answer based on a specific question and optional goal.

```APIDOC
## GET /why-and-how/demo-and-examples.md

### Description
Queries the documentation dynamically to receive an answer and relevant excerpts based on a provided question.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/why-and-how/demo-and-examples.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The specific, self-contained question in natural language.
- **goal** (string) - Optional - The broader end goal to help tailor the answer.

### Response
#### Success Response (200)
- **answer** (string) - The direct answer to the question.
- **excerpts** (array) - Relevant excerpts and sources from the documentation.
```

--------------------------------

### GET /tile-servers/using-bing-maps.md

Source: https://docs.fleaflet.dev/tile-servers/using-bing-maps.md

Performs a dynamic query against the documentation page to retrieve answers and relevant context.

```APIDOC
## GET /tile-servers/using-bing-maps.md

### Description
Queries the documentation dynamically to retrieve an answer to a specific question, optionally tailored to a broader end goal.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/tile-servers/using-bing-maps.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The immediate question to ask.
- **goal** (string) - Optional - The broader end goal to help tailor the response.
```

--------------------------------

### GET /tile-servers/using-openstreetmap-direct.md

Source: https://docs.fleaflet.dev/tile-servers/using-openstreetmap-direct.md

Performs a natural language query against the documentation page to retrieve answers and relevant context.

```APIDOC
## GET /tile-servers/using-openstreetmap-direct.md

### Description
Queries the documentation page dynamically to receive a direct answer and relevant excerpts based on a natural language question.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/tile-servers/using-openstreetmap-direct.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The specific, self-contained natural language question.
- **goal** (string) - Optional - The broader end goal to help tailor the response context.
```

--------------------------------

### GET /why-and-how/showcase.md

Source: https://docs.fleaflet.dev/why-and-how/showcase.md

Performs a dynamic query against the documentation to retrieve answers and relevant excerpts based on a specific question and optional goal.

```APIDOC
## GET /why-and-how/showcase.md

### Description
Queries the documentation dynamically to receive a direct answer and relevant excerpts based on the provided question.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/why-and-how/showcase.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The specific, self-contained question to ask the documentation.
- **goal** (string) - Optional - The broader end goal to help tailor the response context.
```

--------------------------------

### GET /plugins/list.md

Source: https://docs.fleaflet.dev/llms.txt

Performs a natural language query against the documentation index to retrieve answers and relevant excerpts.

```APIDOC
## GET /plugins/list.md

### Description
Perform an HTTP GET request on the documentation index to ask a specific question and optionally provide a broader end goal for context.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/plugins/list.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The immediate question to ask, written in natural language.
- **goal** (string) - Optional - Describes the broader end goal to help tailor the answer.

### Response
- The response contains a direct answer to the question along with relevant excerpts and sources from the documentation.
```

--------------------------------

### Query Documentation via HTTP

Source: https://docs.fleaflet.dev/layers/circle-layer.md

Perform an HTTP GET request to query the documentation dynamically for specific information.

```http
GET https://docs.fleaflet.dev/layers/circle-layer.md?ask=<question>&goal=<endgoal>
```

--------------------------------

### GET /layers/tile-layer.md

Source: https://docs.fleaflet.dev/layers/tile-layer.md

Queries the documentation page for specific information using natural language.

```APIDOC
## GET /layers/tile-layer.md

### Description
Perform a query against the documentation page to retrieve answers, excerpts, or sources based on a natural language question.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/layers/tile-layer.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The immediate question to ask.
- **goal** (string) - Optional - The broader end goal to help tailor the response.
```

--------------------------------

### GET /usage/layers.md

Source: https://docs.fleaflet.dev/usage/layers.md

Perform a dynamic query against the documentation page to retrieve answers and relevant excerpts.

```APIDOC
## GET /usage/layers.md

### Description
Queries the documentation dynamically to retrieve information not explicitly present on the page.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/usage/layers.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The specific, self-contained question to ask.
- **goal** (string) - Optional - The broader end goal to help tailor the response.
```

--------------------------------

### GET /plugins.md

Source: https://docs.fleaflet.dev/plugins

Queries the documentation page for specific information using natural language questions and optional goal context.

```APIDOC
## GET /plugins.md

### Description
Performs a dynamic query against the documentation to retrieve answers, excerpts, and sources based on a user question.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/plugins.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The immediate question to ask.
- **goal** (string) - Optional - The broader end goal to help tailor the response.
```

--------------------------------

### GET /why-and-how.md

Source: https://docs.fleaflet.dev/why-and-how

Performs a dynamic query against the documentation page to retrieve answers and relevant excerpts based on a specific question and optional goal.

```APIDOC
## GET /why-and-how.md

### Description
Queries the documentation dynamically to retrieve information not explicitly present on the page.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/why-and-how.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The immediate question to ask.
- **goal** (string) - Optional - The broader end goal to help tailor the response.
```

--------------------------------

### GET /tile-servers.md

Source: https://docs.fleaflet.dev/tile-servers

Performs a query against the documentation to retrieve answers, excerpts, and sources based on a specific question and optional goal.

```APIDOC
## GET /tile-servers.md

### Description
Perform an HTTP GET request on the current page URL to query the documentation dynamically.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/tile-servers.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The immediate question to ask, written in natural language.
- **goal** (string) - Optional - Describes the broader end goal to tailor the answer.
```

--------------------------------

### GET /tile-servers/other-options.md

Source: https://docs.fleaflet.dev/tile-servers/other-options.md

Performs a dynamic query against the documentation to retrieve answers, excerpts, and sources based on a specific question and optional goal.

```APIDOC
## GET /tile-servers/other-options.md

### Description
Performs a dynamic query against the documentation to retrieve answers, excerpts, and sources based on a specific question and optional goal.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/tile-servers/other-options.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The specific, self-contained question to ask the documentation.
- **goal** (string) - Optional - The broader end goal to help tailor the answer.
```

--------------------------------

### GET /tile-servers/offline-mapping.md

Source: https://docs.fleaflet.dev/tile-servers/offline-mapping.md

Queries the documentation page for specific information using a natural language question and an optional goal.

```APIDOC
## GET /tile-servers/offline-mapping.md

### Description
Queries the documentation page dynamically to retrieve answers, excerpts, and sources based on a provided question.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/tile-servers/offline-mapping.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The specific, self-contained natural language question.
- **goal** (string) - Optional - The broader end goal to help tailor the response.
```

--------------------------------

### GET /layers/polyline-layer.md

Source: https://docs.fleaflet.dev/layers/polyline-layer.md

Queries the documentation page for specific information using natural language.

```APIDOC
## GET /layers/polyline-layer.md

### Description
Performs a dynamic query against the documentation page to retrieve answers, excerpts, and sources based on a natural language question.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/layers/polyline-layer.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The specific, self-contained natural language question.
- **goal** (string) - Optional - The broader end goal to help tailor the response context.
```

--------------------------------

### GET /layers/tile-layer/caching.md

Source: https://docs.fleaflet.dev/layers/tile-layer/caching.md

Queries the documentation page for specific information using natural language questions.

```APIDOC
## GET /layers/tile-layer/caching.md

### Description
Performs a dynamic query on the documentation page to retrieve an answer to a specific question, along with relevant excerpts and sources.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/layers/tile-layer/caching.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The immediate, specific question to ask.
- **goal** (string) - Optional - The broader end goal to help tailor the response.
```

--------------------------------

### GET /usage.md

Source: https://docs.fleaflet.dev/usage

Performs a dynamic query against the documentation to retrieve answers and relevant excerpts based on a specific question and optional goal.

```APIDOC
## GET /usage.md

### Description
Performs a dynamic query against the documentation to retrieve answers and relevant excerpts based on a specific question and optional goal.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/usage.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The immediate question to ask, written in natural language.
- **goal** (string) - Optional - Describes the broader end goal to help tailor the answer.
```

--------------------------------

### GET /readme.md

Source: https://docs.fleaflet.dev/readme.md

Performs a dynamic query against the documentation to retrieve answers and relevant excerpts based on a specific question and optional goal.

```APIDOC
## GET /readme.md

### Description
Performs a dynamic query against the documentation to retrieve answers and relevant excerpts based on a specific question and optional goal.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/readme.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The immediate question to ask the documentation.
- **goal** (string) - Optional - The broader end goal to help tailor the response.
```

--------------------------------

### GET /thanks/credits.md

Source: https://docs.fleaflet.dev/thanks/credits.md

Performs a dynamic query against the documentation page to retrieve information based on a specific question and optional goal.

```APIDOC
## GET /thanks/credits.md

### Description
Queries the documentation dynamically to retrieve answers and relevant excerpts based on a provided question.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/thanks/credits.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The specific, self-contained question to ask.
- **goal** (string) - Optional - The broader end goal to help tailor the response.
```

--------------------------------

### GET /layers/layer-interactivity.md

Source: https://docs.fleaflet.dev/layers/layer-interactivity.md

Queries the documentation page for specific information using a natural language question and an optional goal.

```APIDOC
## GET /layers/layer-interactivity.md

### Description
Perform an HTTP GET request on the current page URL to query the documentation dynamically.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/layers/layer-interactivity.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The immediate question to ask, written in natural language.
- **goal** (string) - Optional - Describes the broader end goal to help tailor the answer.
```

--------------------------------

### GET /layers/polygon-layer.md

Source: https://docs.fleaflet.dev/layers/polygon-layer.md

Queries the documentation page for specific information using a natural language question and an optional goal.

```APIDOC
## GET /layers/polygon-layer.md

### Description
Queries the documentation dynamically to retrieve answers, excerpts, and sources based on a specific question.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/layers/polygon-layer.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The specific, self-contained natural language question.
- **goal** (string) - Optional - The broader end goal to help tailor the response.
```

--------------------------------

### Decoding Encoded Polylines

Source: https://docs.fleaflet.dev/layers/polyline-layer.md

Usage example for decoding a Google Polyline string and converting it to a list of LatLng points.

```dart
import 'unpack_polyline.dart';

decodePolyline('<encoded-polyline>').unpackPolyline(); // Returns `List<LatLng>` for a map polyline
```

--------------------------------

### Basic TileLayer Configuration

Source: https://docs.fleaflet.dev/layers/tile-layer.md

Initializes a TileLayer with a URL template and a required user agent package name.

```dart
TileLayer(
  urlTemplate: 'https://tile.openstreetmap.org/{z}/{x}/{y}.png',
  userAgentPackageName: /*'com.example.app'*/, // Add your app identifier
  // + many other options
),
```

--------------------------------

### Configure macOS network client entitlement

Source: https://docs.fleaflet.dev/getting-started/installation.md

Add the network client key to your Release.entitlements file to allow network access.

```xml
...
<dict>
    ...
    <key>com.apple.security.network.client</key>
    <true/>
    ...
</dict>
...
```

--------------------------------

### Initialize a basic FlutterMap

Source: https://docs.fleaflet.dev/

Configures a map centered on London with OpenStreetMap tiles and an attribution widget.

```dart
import 'package:flutter_map/flutter_map.dart';
import 'package:latlong2/latlong.dart';

@override
Widget build(BuildContext context) {
  return FlutterMap(
    options: MapOptions(
      initialCenter: LatLng(51.509364, -0.128928), // Center the map over London, UK
      initialZoom: 9.2,
    ),
    children: [
      TileLayer( // Bring your own tiles
        urlTemplate: 'https://tile.openstreetmap.org/{z}/{x}/{y}.png', // For demonstration only
        userAgentPackageName: /*'com.example.app'*/, // Add your app identifier
        // And many more recommended properties!
      ),
      RichAttributionWidget( // Include a stylish prebuilt attribution widget that meets all requirments
        attributions: [
          TextSourceAttribution(
            'OpenStreetMap contributors',
            onTap: () => launchUrl(Uri.parse('https://openstreetmap.org/copyright')), // (external)
          ),
          // Also add images...
        ],
      ),
    ],
  );
}
```

--------------------------------

### Implement MapCachingProvider

Source: https://docs.fleaflet.dev/plugins/create/caching-providers.md

Create a custom class that implements the MapCachingProvider interface to define tile retrieval and storage logic.

```dart
class CustomCachingProvider implements MapCachingProvider {
  @override
  bool get isSupported => throw UnimplementedError();

  @override
  Future<({Uint8List bytes, CachedMapTileMetadata metadata})?> getTile(
    String url,
  ) {
    throw UnimplementedError();
  }

  @override
  Future<void> putTile({
    required String url,
    required CachedMapTileMetadata metadata,
    Uint8List? bytes,
  }) {
    throw UnimplementedError();
  }
}
```

--------------------------------

### Implement Bing Maps Tile Support

Source: https://docs.fleaflet.dev/tile-servers/using-bing-maps.md

Defines the imagery sets, a custom tile provider for quadkey generation, and a wrapper widget to fetch metadata and render tiles.

```dart
// All compatible imagery sets
enum BingMapsImagerySet {
  road('RoadOnDemand', zoomBounds: (min: 0, max: 21)),
  aerial('Aerial', zoomBounds: (min: 0, max: 20)),
  aerialLabels('AerialWithLabelsOnDemand', zoomBounds: (min: 0, max: 20)),
  canvasDark('CanvasDark', zoomBounds: (min: 0, max: 21)),
  canvasLight('CanvasLight', zoomBounds: (min: 0, max: 21)),
  canvasGray('CanvasGray', zoomBounds: (min: 0, max: 21)),
  ordnanceSurvey('OrdnanceSurvey', zoomBounds: (min: 12, max: 17));

  final String urlValue;
  final ({int min, int max}) zoomBounds;

  const BingMapsImagerySet(this.urlValue, {required this.zoomBounds});
}

// Custom tile provider that contains the quadkeys logic
// Note that you can also extend from the CancellableNetworkTileProvider
class BingMapsTileProvider extends NetworkTileProvider {
  BingMapsTileProvider({super.headers});

  String _getQuadKey(int x, int y, int z) {
    final quadKey = StringBuffer();
    for (int i = z; i > 0; i--) {
      int digit = 0;
      final int mask = 1 << (i - 1);
      if ((x & mask) != 0) digit++;
      if ((y & mask) != 0) digit += 2;
      quadKey.write(digit);
    }
    return quadKey.toString();
  }

  @override
  Map<String, String> generateReplacementMap(
    String urlTemplate,
    TileCoordinates coordinates,
    TileLayer options,
  ) =>
      super.generateReplacementMap(urlTemplate, coordinates, options)
        ..addAll(
          {
            'culture': 'en-GB', // Or your culture value of choice
            'subdomain': options.subdomains[
                (coordinates.x + coordinates.y) % options.subdomains.length],
            'quadkey': _getQuadKey(coordinates.x, coordinates.y, coordinates.z),
          },
        );
}

// Custom `TileLayer` wrapper that can be inserted into a `FlutterMap`
class BingMapsTileLayer extends StatelessWidget {
  const BingMapsTileLayer({
    super.key,
    required this.apiKey,
    required this.imagerySet,
  });

  final String apiKey;
  final BingMapsImagerySet imagerySet;

  @override
  Widget build(BuildContext context) {
    return FutureBuilder(
      future: http.get(
        Uri.parse(
          'http://dev.virtualearth.net/REST/V1/Imagery/Metadata/${imagerySet.urlValue}?output=json&include=ImageryProviders&key=$apiKey',
        ),
      ),
      builder: (context, response) {
        if (response.data == null) return const Placeholder();

        return TileLayer(
          urlTemplate: (((((jsonDecode(response.data!.body)
                          as Map<String, dynamic>)['resourceSets']
                      as List<dynamic>)[0] as Map<String, dynamic>)['resources']
                  as List<dynamic>)[0] as Map<String, dynamic>)['imageUrl']
              as String,
          tileProvider: BingMapsTileProvider(),
          subdomains: const ['t0', 't1', 't2', 't3'],
          minNativeZoom: imagerySet.zoomBounds.min,
          maxNativeZoom: imagerySet.zoomBounds.max,
        );
      },
    );
  }
}
```

--------------------------------

### Define Asset URL Template

Source: https://docs.fleaflet.dev/layers/tile-layer.md

Use the AssetTileProvider to load tiles bundled within the application's assets.

```text
assets/map/{z}/{x}/{y}.png
```

--------------------------------

### GET /usage/options/custom-crss.md

Source: https://docs.fleaflet.dev/usage/options/custom-crss.md

Performs a dynamic query against the documentation page to retrieve answers, excerpts, and sources based on a natural language question.

```APIDOC
## GET /usage/options/custom-crss.md

### Description
Queries the documentation dynamically to retrieve information not explicitly present on the page.

### Method
GET

### Endpoint
https://docs.fleaflet.dev/usage/options/custom-crss.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The specific, self-contained question in natural language.
- **goal** (string) - Optional - The broader end goal to help tailor the response.

### Response
- **answer** (string) - A direct answer to the question.
- **excerpts** (array) - Relevant excerpts from the documentation.
- **sources** (array) - Sources used to generate the answer.
```

--------------------------------

### Hook into MapController readiness

Source: https://docs.fleaflet.dev/usage/programmatic-interaction.md

Use MapOptions.onMapReady to ensure the controller is attached before performing operations. Avoid using controller methods directly inside this callback to prevent potential issues.

```dart
final _mapControllerReady = Completer<void>();

return FlutterMap(
    mapController: _mapController,
    options: MapOptions(
        onMapReady: () {
            // `_mapController` safe to use
            _mapControllerReady.complete();
        },
    ),
);
```

--------------------------------

### Implement tile retrieval methods

Source: https://docs.fleaflet.dev/plugins/create/tile-providers.md

Implement getImageWithCancelLoadingSupport for cancellable requests or getImage for standard requests.

```dart
    @override
    bool get supportsCancelLoading => true;
    
    @override
    ImageProvider getImageWithCancelLoadingSupport(
        TileCoordinates coordinates,
        TileLayer options,
        Future<void> cancelLoading,
    ) =>
        CustomCancellableImageProvider(
            url: getTileUrl(coordinates, options),
            fallbackUrl: getTileFallbackUrl(coordinates, options),
            cancelLoading: cancelLoading,
            tileProvider: this,
        );
```

```dart
    @override
    ImageProvider getImage(TileCoordinates coordinates, TileLayer options) =>
        CustomImageProvider(
            url: getTileUrl(coordinates, options),
            fallbackUrl: getTileFallbackUrl(coordinates, options),
            tileProvider: this,
        );
```

--------------------------------

### Enable Retina Mode

Source: https://docs.fleaflet.dev/layers/tile-layer.md

Use this configuration to enable high-resolution tile rendering on high-density displays. Ensure the tile server supports the {r} placeholder for native retina tiles.

```dart
    retinaMode: RetinaMode.isHighDensity(context),
```

--------------------------------

### Add flutter_map dependency

Source: https://docs.fleaflet.dev/getting-started/installation.md

Use the command line to add flutter_map and latlong2 to your project.

```sh
flutter pub add flutter_map latlong2
```

--------------------------------

### Implement SimpleAttributionWidget

Source: https://docs.fleaflet.dev/layers/attribution-layer.md

Use this widget for a classic, non-interactive attribution box suitable for maps with limited interactivity.

```dart
children: [
  SimpleAttributionWidget(
    source: Text('OpenStreetMap contributors'),
  ),
],
```

--------------------------------

### Extend TileProvider class

Source: https://docs.fleaflet.dev/plugins/create/tile-providers.md

Create a custom class extending TileProvider, ensuring the constructor accepts super.headers.

```dart
class CustomTileProvider extends TileProvider {
    CustomTileProvider({
        // Suitably initialise your own custom properties
        super.headers, // Accept a `Map` of custom HTTP headers
    })
}
```

--------------------------------

### Run app without Impeller

Source: https://docs.fleaflet.dev/getting-started/installation.md

Use this command to test if rendering issues are caused by the Impeller engine.

```sh
flutter run --no-enable-impeller
```

--------------------------------

### Initialize FlutterMap Widget

Source: https://docs.fleaflet.dev/usage/basics.md

The base widget requires a MapController and MapOptions to function. Ensure it is placed within a constrained parent widget to avoid layout errors.

```dart
FlutterMap(
    mapController: MapController(),
    options: MapOptions(),
    children: [],
);
```

--------------------------------

### Implement RichAttributionWidget

Source: https://docs.fleaflet.dev/layers/attribution-layer.md

Use this widget for an interactive, animated attribution display that supports logos and popup text.

```dart
children: [
  RichAttributionWidget(
    attributions: [
      // Suggested attribution for the OpenStreetMap public tile server
      TextSourceAttribution(
        'OpenStreetMap contributors',
        onTap: () => launchUrl(Uri.parse('https://openstreetmap.org/copyright')),
      ),
    ],
  ),
],
```

--------------------------------

### Import proj4dart

Source: https://docs.fleaflet.dev/usage/options/custom-crss.md

Required import for accessing projection functionality.

```dart
import 'package:proj4dart/proj4dart.dart' as proj4;
```

--------------------------------

### Handling Map Events via MapOptions

Source: https://docs.fleaflet.dev/usage/programmatic-interaction.md

Use MapOptions callbacks to handle user interactions like taps and position changes.

```dart
return FlutterMap(
    options: MapOptions(
        // ...
        onTap: (tapPosition, point) {
            final screenTapped = tapPosition.global;
            final coordinatesTapped = point;
        },
        onPositionChanged: (camera, hasGesture) {
            if (hasGesture) {
                disableUserLocationFollow();
            }
            print(camera.center);
        },
    ),
    // ...
);
```

--------------------------------

### Configure a custom caching provider

Source: https://docs.fleaflet.dev/layers/tile-layer/caching.md

Pass a custom implementation to the cachingProvider argument of a NetworkTileProvider.

```dart
TileLayer(
    urlTemplate: '...',
    userAgentPackageName: '...',
    tileProvider: NetworkTileProvider(
        cachingProvider: CustomMapCachingProvider(),
    ),
);
```

--------------------------------

### Create Mobile and Static Layer Widgets

Source: https://docs.fleaflet.dev/plugins/create/layers.md

Defines the base structure for custom map layers, using MobileLayerTransformer for mobile layers or standard layout widgets for static layers.

```dart
class CustomMobileLayer extends StatelessWidget {
  const CustomMobileLayer({super.key});

  @override
  Widget build(BuildContext context) {    
    return MobileLayerTransformer(
      child: // your child here
    );
  }
}
```

```dart
class CustomStaticLayer extends StatelessWidget {
  const CustomStaticLayer({super.key});

  @override
  Widget build(BuildContext context) {
    return SizedBox.expand();
    // and/or
    return Align();
  }
}
```

--------------------------------

### Configure Built-in Caching Provider

Source: https://docs.fleaflet.dev/layers/tile-layer/caching.md

Configures the cache size limit by passing arguments to the getOrCreateInstance factory constructor within the TileLayer definition.

```dart
TileLayer(
    urlTemplate: '...',
    userAgentPackageName: '...',
    tileProvider: NetworkTileProvider(
        cachingProvider: BuiltInMapCachingProvider.getOrCreateInstance(
            maxCacheSize: 1_000_000_000, // 1 GB is the default
        ),
    ),
);
```

--------------------------------

### Basic PolylineLayer implementation

Source: https://docs.fleaflet.dev/layers/polyline-layer.md

Defines a PolylineLayer with a single Polyline connecting a list of LatLng coordinates.

```dart
PolylineLayer(
  polylines: [
    Polyline(
      points: [LatLng(30, 40), LatLng(20, 50), LatLng(25, 45)],
      color: Colors.blue,
    ),
  ],
),
```

--------------------------------

### Configure Android Internet permission

Source: https://docs.fleaflet.dev/getting-started/installation.md

Add the internet permission to your AndroidManifest.xml for release builds.

```xml
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    ...
    <uses-permission android:name="android.permission.INTERNET"/>
    ...
</manifest>
```
Tokens:
Raw