### Forward Geocoding with OsmGeocoder (JavaScript)

Source: https://github.com/spurreiter/geocoder/blob/main/README.md

This snippet demonstrates how to perform forward geocoding using the `OsmGeocoder` from the `@spurreiter/geocoder` library. It initializes the geocoder with a `fetchAdapter` and configuration options like language, limit, and referer, then calls the `forward` method with an address string. The expected output is an array of geocoded address objects.

```js
import { fetchAdapter, OsmGeocoder } from '@spurreiter/geocoder'

const adapter = fetchAdapter()
const geocoder = new OsmGeocoder(adapter, 
  { language: 'en', limit: 5, referer: 'https://mysite' })

const results = await geocoder.forward('135 pilkington avenue, birmingham')
// [
//   {
//     formattedAddress: '135, Pilkington Avenue, Maney, Sutton Coldfield, Wylde Green, Birmingham, West Midlands Combined Authority, West Midlands, England, B72 1LH, United Kingdom',
//     latitude: 52.5487921,
//     longitude: -1.8164308339635031,
//     country: 'United Kingdom',
//     countryCode: 'GB',
//     state: 'England',
//     county: 'West Midlands Combined Authority',
//     city: 'Birmingham',
//     zipcode: 'B72 1LH',
//     district: 'West Midlands',
//     streetName: 'Pilkington Avenue',
//     streetNumber: '135',
//     neighbourhood: undefined,
//     extra: {
//       id: 90394480,
//       confidence: 0.411,
//       bbox: [ -1.816513, 52.5487473, -1.8163464, 52.5488481 ]
//     }
//   }
// ]
```

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

### Cascading Multiple Geocoders (JavaScript)

Source: https://github.com/spurreiter/geocoder/blob/main/README.md

This snippet shows how to use the `Cascade` class to sequentially query multiple geocoders. It initializes `Cascade` with an array of geocoder instances (e.g., `HereGeocoder`, `OsmGeocoder`), and then performs a forward geocoding query. The `Cascade` returns results from the first geocoder that responds successfully without an error.

```js
import { Cascade, fetchAdapter, HereGeocoder, OsmGeocoder } from '@spurreiter/geocoder'

const language = "es"
const geocoders = [
  new HereGeocoder(adapter, { apiKey: 'your-api-key', language }),
  new OsmGeocoder(adapter, { language, referer: 'https://mysite' })
]
const cascade = new Cascade(geocoders)

const results = await cascade.forward('135 pilkington avenue, birmingham')

// results contains data from 1st geocoder which responds without error.
```

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

### Formatting Geocoding Results to GPX XML in JavaScript

Source: https://github.com/spurreiter/geocoder/blob/main/README.md

This snippet demonstrates how to use the `gpxFormatter` function from the `@spurreiter/geocoder` library to convert geocoding results into a GPX XML string. It takes the output of a forward geocoding query and transforms it into a standard GPX waypoint format, suitable for mapping applications. The `results` parameter should be an array of geocoding results.

```JavaScript
import { gpxFormatter } from '@spurreiter/geocoder'

const query = '135 pilkington avenue, birmingham'
const results = await geocoder.forward(query)

const gpx = gpxFormatter(results)
```

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

### Combining Results from Multiple Geocoders (JavaScript)

Source: https://github.com/spurreiter/geocoder/blob/main/README.md

This snippet demonstrates how to use the `Combine` class to aggregate results from various geocoders into a single result set. It initializes `Combine` with an array of geocoder instances and then performs a forward geocoding query. The `Combine` returns data from all reachable geocoders, merging their results.

```js
import { Combine, fetchAdapter, HereGeocoder, OsmGeocoder } from '@spurreiter/geocoder'

const geocoders = [
  new HereGeocoder(adapter, { apiKey: 'your-api-key' }),
  new OsmGeocoder(adapter, { referer: 'https://mysite' })
]
const combine = new Combine(geocoders)

const results = await combine.forward(
    { address: '135 pilkington avenue, birmingham', language: 'es' })

// results contains data from all reachable geocoders.
```

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

### Reverse Geocoding with OsmGeocoder (JavaScript)

Source: https://github.com/spurreiter/geocoder/blob/main/README.md

This snippet illustrates how to perform reverse geocoding using the `OsmGeocoder`. It calls the `reverse` method with a latitude and longitude object, which returns an array of geocoded address objects corresponding to the given coordinates.

```js
const results = await geocoder.reverse({ lat: 40.714232, lng: -73.9612889 })
// [
//   {
//     formattedAddress: '279, Bedford Avenue, Williamsburg, Brooklyn, Kings County, New York, 11211, United States',
//     latitude: 40.714205,
//     longitude: -73.96131519274765,
//     country: 'United States',
//     countryCode: 'US',
//     state: 'New York',
//     county: undefined,
//     city: 'New York',
//     zipcode: '11211',
//     district: undefined,
//     streetName: 'Bedford Avenue',
//     streetNumber: '279',
//     neighbourhood: undefined,
//     extra: {
//       id: 279767984,
//       confidence: 0,
//       bbox: [ -73.9613744, 40.7141617, -73.961256, 40.7142482 ]
//     }
//   }
// ]
```

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

### Formatting Geocoding Results to GeoJSON (JavaScript)

Source: https://github.com/spurreiter/geocoder/blob/main/README.md

This snippet shows how to use the `geoJsonFormatter` to convert geocoding results into the GeoJSON format, adhering to RFC-7946 and geocodejson-spec. It takes the raw geocoding results and an optional query object to produce a `FeatureCollection` object.

```js
import { geoJsonFormatter } from '@spurreiter/geocoder'

const query = '135 pilkington avenue, birmingham'
const results = await geocoder.forward(query)

const geoJson = geoJsonFormatter(results, {query})
// {
//   type: 'FeatureCollection',
//   geocoding: {
//     version: '0.1.0',
//     license: null,
//     attribution: null,
//     query: '135 pilkington avenue, birmingham'
//   },
//   features: [{...}, ...]
// }
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.