---
title: "geocoding | Client js | Api client"
description: "Documentation for MapTiler Client"
---

> For AI agents: a documentation index is available at [/llms.txt](https://docs.maptiler.com/llms.txt). Markdown versions of all pages are available by appending .md to any URL.

# Variable geocoding`Const`

geocoding: {  
    batch: (  
        queries: string\[\],  
        options?: [GeocodingOptions](https://docs.maptiler.com/client-js/api/types/services_geocoding.GeocodingOptions/),  
    ) \=> Promise<[GeocodingSearchResult](https://docs.maptiler.com/client-js/api/types/services_geocoding.GeocodingSearchResult/)\[\]\>;  
    byId: (  
        id: string,  
        options?: [BaseGeocodingOptions](https://docs.maptiler.com/client-js/api/types/services_geocoding.BaseGeocodingOptions/),  
    ) \=> Promise<[GeocodingSearchResult](https://docs.maptiler.com/client-js/api/types/services_geocoding.GeocodingSearchResult/)\>;  
    forward: (  
        query: string,  
        options?: [GeocodingOptions](https://docs.maptiler.com/client-js/api/types/services_geocoding.GeocodingOptions/),  
    ) \=> Promise<[GeocodingSearchResult](https://docs.maptiler.com/client-js/api/types/services_geocoding.GeocodingSearchResult/)\>;  
    reverse: (  
        position: Position,  
        options?: [CommonForwardAndReverseGeocodingOptions](https://docs.maptiler.com/client-js/api/types/services_geocoding.CommonForwardAndReverseGeocodingOptions/),  
    ) \=> Promise<[GeocodingSearchResult](https://docs.maptiler.com/client-js/api/types/services_geocoding.GeocodingSearchResult/)\>;  
} = ...

The **geocoding** namespace contains asynchronous functions to call the [MapTiler Geocoding API](https://docs.maptiler.com/cloud/api/geocoding/). The **Geocoding API** provides ways to get geographic coordinates from a human-readable search query of a place (forward geocoding) and to get the location details (country, city, street, etc.) from a geographic coordinate (reverse geocoding);

#### Type Declaration

-   ##### batch: (  
        queries: string\[\],  
        options?: [GeocodingOptions](https://docs.maptiler.com/client-js/api/types/services_geocoding.GeocodingOptions/),  
    ) \=> Promise<[GeocodingSearchResult](https://docs.maptiler.com/client-js/api/types/services_geocoding.GeocodingSearchResult/)\[\]\>
    
-   ##### byId: (id: string, options?: [BaseGeocodingOptions](https://docs.maptiler.com/client-js/api/types/services_geocoding.BaseGeocodingOptions/)) \=> Promise<[GeocodingSearchResult](https://docs.maptiler.com/client-js/api/types/services_geocoding.GeocodingSearchResult/)\>
    
-   ##### forward: (query: string, options?: [GeocodingOptions](https://docs.maptiler.com/client-js/api/types/services_geocoding.GeocodingOptions/)) \=> Promise<[GeocodingSearchResult](https://docs.maptiler.com/client-js/api/types/services_geocoding.GeocodingSearchResult/)\>
    
-   ##### reverse: (  
        position: Position,  
        options?: [CommonForwardAndReverseGeocodingOptions](https://docs.maptiler.com/client-js/api/types/services_geocoding.CommonForwardAndReverseGeocodingOptions/),  
    ) \=> Promise<[GeocodingSearchResult](https://docs.maptiler.com/client-js/api/types/services_geocoding.GeocodingSearchResult/)\>
    

-   Defined in [services/geocoding.ts:479](https://github.com/maptiler/maptiler-client-js/blob/f88659ae276c959a754e4c0f3b5c2aae1f483caa/src/services/geocoding.ts#L479)