## Forward geocode an address

`geocode.forward(**kwargs) -> GeocodeResult`

**get** `/api/v1/geocode`

Forward geocode an address

### Parameters

- `q: String`

  Address or place name

- `bbox: String`

  Bounding box filter: south,west,north,east

- `country_code: String`

  ISO 3166-1 alpha-2 country code filter

- `lang: String`

  Language code for localized names (e.g. en, de, fr)

- `lat: Float`

  Focus latitude

- `layer: String`

  Filter by layer: address, poi, or admin

- `limit: Integer`

  Maximum results (default 20, max 100)

- `lng: Float`

  Focus longitude

### Returns

- `class GeocodeResult`

  GeoJSON FeatureCollection of geocoding results

  - `features: Array[GeocodingFeature]`

    - `geometry: GeoJsonGeometry`

      - `coordinates: Array[Float] | Array[Array[Float]] | Array[Array[Array[Float]]] | Array[Array[Array[Array[Float]]]]`

        GeoJSON coordinates array (nesting depth varies by geometry type)

        - `Array[Float]`

        - `Array[Array[Float]]`

        - `Array[Array[Array[Float]]]`

        - `Array[Array[Array[Array[Float]]]]`

      - `type: :Point | :LineString | :Polygon | 3 more`

        - `:Point`

        - `:LineString`

        - `:Polygon`

        - `:MultiPoint`

        - `:MultiLineString`

        - `:MultiPolygon`

    - `properties: { country_code, display_name, distance_m, 4 more}`

      - `country_code: String`

        ISO 3166-1 alpha-2 country code

      - `display_name: String`

        Formatted address or place name

      - `distance_m: Float`

        Distance in meters

      - `osm_id: Integer`

        OpenStreetMap ID

      - `osm_type: String`

        OSM element type

      - `score: Float`

        Match confidence score

      - `source: String`

        Result source (address, place, interpolation)

    - `type: :Feature`

      - `:Feature`

  - `type: :FeatureCollection`

    - `:FeatureCollection`

### Example

```ruby
require "plaza"

plaza = Plaza::Client.new(
  api_key: "My API Key",
  environment: "local" # defaults to "production"
)

geocode_result = plaza.geocode.forward(q: "q")

puts(geocode_result)
```