---
title: "Resolve a place name to a coordinate"
method: GET
path: "/places/search"
tags: ["discovery"]
---

# Resolve a place name to a coordinate

`GET /places/search`

## Request

- Base URL: `https://api.mapsource.io`
- URL: `https://api.mapsource.io/places/search`
- Auth: HTTP bearer

Global place-name search over a locally built index, ranked by prominence with an optional bias point.

When to use: Look up a populated place by name and retrieve its coordinates.

When not to use: Use lookupPlaces for addresses, businesses, brands and mixed destination suggestions. Use discoverPlaces for businesses within a viewport, polygon or travel-time region.

## Query parameters

- `q` string, required
- `limit` integer
- `lat` number
- `lon` number
- `class` 'city' | 'town' | 'village' | 'suburb' | 'neighbourhood' | 'hamlet'

## Response `200`

Resolve a place name to a coordinate

- object
  - `schema` string
  - `query` string
  - `places` unknown[]
    - unknown
  - `meta` object
    - `requestId` string
    - `computeMs` integer
    - `requestedAt` string, date-time
    - `sources` object[]
      - `dataset` string
      - `observedAt` string, nullable
      - `license` string
    - `freshness` object, nullable
    - `licenses` string[]
    - `attribution` string[]

## Other responses

- `400`: Error with a stable machine code.
- `401`: Error with a stable machine code.
- `429`: Error with a stable machine code.
- `500`: Error with a stable machine code.

---

[API](https://skmtc.dev/mapsource/apis/mapsource-overpass-api.md) · [All operations](https://skmtc.dev/mapsource/apis/mapsource-overpass-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mapsource/apis/mapsource-overpass-api/revisions/8af8c2769e7b?raw)