---
title: "lookup(place, callback, options)"
framework: mapkitjs
role: symbol
role_heading: Instance Method
path: mapkitjs/geocoder/lookup1
---

# lookup(place, callback, options)

Converts an address to geographic coordinates.

## Declaration

```data
lookup(
    place: string,
    callback: (
        error: Error | null,
        result: GeocoderResponse | null,
    ) => void,
    options?: GeocoderLookupOptions,
): Promise<GeocoderResponse>;
```

## Parameters

- `place`: A case-insensitive string MapKit JS converts to geographic coordinates, such as: “San Francisco City Hall”, “San Francisco City Hall, San Francisco”, “San Francisco City Hall, San Francisco, CA USA”. Delimiter characters are optional.
- `callback`: MapKit JS returns geocoding results asynchronously through a callback function. MapKit JS invokes the callback function with two arguments, error on failure and data on success. error (Error). Contains an error code and descriptive message. data (doc://com.apple.mapkitjs/documentation/MapKitJS/GeocoderResponse). An object that contains an array of places named doc://com.apple.mapkitjs/documentation/MapKitJS/GeocoderResponse/results.
- `options`: The geocoder returns the most relevant results for a query. For example, a query for Paris returns results for Paris, France. Use doc://com.apple.mapkitjs/documentation/MapKitJS/GeocoderLookupOptions to constrain the search to specific countries, or to a desired area with a coordinate or region.

## Return Value

Return Value A promise that resolves with a GeocoderResponse on success.

## Discussion

Discussion Geocoding converts a human-readable address to latitude and longitude coordinates. You can use Geocoder to look up coordinates for a city, landmark, or address.

## See Also

### Deprecated

- [reverseLookup(coordinate, callback, options)](mapkitjs/geocoder/reverselookup1.md)