Free-form query string to search for. Commas are optional, but improve performance by reducing the complexity of the search. Don't use it if you request coordinates by country, city, street, county, postalcode, state.

Street

City

County

State

Country

Postal Code

Include a breakdown of the address into elements.

Include additional information in the result if available, e.g. wikipedia link, opening hours.

Include a list of alternative names in the results. These may include language variants, references, operator and brand.

The preferred language order for displaying search results can be set to override the language specified in the Accept-Language HTTP header. This can be achieved either by using a standard RFC2616 accept-language string or by providing a straightforward comma-separated list of language codes.

To restrict search results to specific countries, use the parameter, which should correspond to the ISO 3166-1 alpha-2 code. For example, use gb for the United Kingdom or de for Germany. Each location is associated with a country code based on the country boundaries defined in OpenStreetMap (OSM). However, in rare instances, a place might not fall within any country's boundaries, such as locations in international waters.

To exclude specific OSM objects from your search results, provide a comma-separated list of the place_ids you wish to omit. This approach can be useful for obtaining additional search results. For instance, if an initial query yielded only a limited number of results, including those place_ids in the exclusion list will prompt the search to return alternative matches, which may be less precise, if available.

Limit the number of returned results

The preferred area to find search results. Any two corner points of the box are accepted as long as they span a real box. x is longitude, y is latitude. Format: <x1>,<y1>,<x2>,<y2>

When a 'viewbox' parameter is specified, the search results are limited to items located within the defined viewbox area. If both 'viewbox' and 'bounded'=1 parameters are set, the search is restricted exclusively to amenities. To search for a specific type of amenity, use the corresponding keyword enclosed in square brackets, such as [pharmacy]. This will return a range of objects of that particular type. However, it should be noted that there is no assurance of the completeness of the results.

Output geometry of results as a GeoJSON. Only one of polygon_ options can be used at a time.

Output geometry of results as a KML. Only one of polygon_ options can be used at a time.

Output geometry of results as a SVG. Only one of polygon_ options can be used at a time.

Output geometry of results as a WKT. Only one of polygon_ options can be used at a time.