---
title: "Geocode an address"
method: GET
path: "/street/find"
tags: ["streetservice"]
---

# Geocode an address

`GET /street/find`

The street service allows you to search for street by GPS position. You can : Specify GPS position, Give the beginning or a part of the name of the street (useful for autocompletion), Limit search to a specific type (e.g : Pedestrian, highway, residential, ... 25 types available), Limit search to a specified radius, Limit search to one way streets,

## Query parameters

- `lat` number, double, required
- `lng` number, double, required
- `radius` number, double
- `oneway` boolean
- `distance` boolean
- `streettype` string
- `format` 'XML' | 'JSON' | 'PHP' | 'RUBY' | 'PYTHON' | 'YAML'
- `from` integer
- `to` integer
- `callback` string
- `indent` boolean

## Response `200`

Sucessfully processed

- StreetSearchResultsDto
  - `numFound` integer — The number of results display with this query (it takes the pagination into account)
  - `QTime` integer — The execution time of the query in ms
  - `result` StreetDistance[]
    - `name` string — The name of the street
    - `distance` number — The distance between the point and the nearest point to the street in meters
    - `gid` integer — Unique id of the street, it is unique between GeoNames and OpenStreetMap
    - `openstreetmapId` integer — OpenStreetMap unique id of the street
    - `streetType` string — The type of the street (see street type list)
    - `oneWay` boolean — Whether the street is a one way street or not
    - `countryCode` string — The ISO 3166 country code
    - `length` number, double — length of the street in meters
    - `lat` number, double — The latitude of the middle of the street(north-south)
    - `lng` number, double — The longitude of the middle of the street(east-west)
    - `isIn` string — Information on the city where the street is (depends on OpenStreetMap 'is_in' field), the city in general
    - `isInPlace` string — Information on the place where the street is (quater, common place). Generally a place at a lower level than city
    - `isInAdm` string — Information of the administration division where the street is.
    - `isInZip` string — Information of the zipcode where the street / POI is (often fill for placetype street)
    - `fullyQualifiedAddress` string — NOT USED YET
  - `error` string — A String only present if an error occured (e.g : empty Latitude or longitude)

## Other responses

- `401` — Need auth. The API key parameter is missing or wrong, or doesn't correspond to any subscriptions
- `403` — Unhauthorize (auth will change nothing).Your IP is not allowed.
- `412` — Missing parameter. Some parameters required for the webservices ar missing, please consult documentation
- `429` — Too many requests. You exceed the authorized rate
- `500` — Internal error

---

[API](https://skmtc.net/gisgraphy/apis/gisgraphy-webservices.md) · [All operations](https://skmtc.net/gisgraphy/apis/gisgraphy-webservices/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gisgraphy/gisgraphy-webservices/revisions/3f91690c0e06/schema)