---
title: "GeocodingFeature | JavaScript maps SDK"
description: "Documentation for MapTiler SDK"
---

> 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.

# Type Alias GeocodingFeature

GeocodingFeature: [Feature](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.Feature/)<[Geometry](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.Geometry/), [FeatureProperties](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.FeatureProperties/)\> & [FeatureBase](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.FeatureBase/) & {  
    address?: string;  
    bbox: [BBox](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.BBox/);  
    center: [Coordinates](https://docs.maptiler.com/sdk-js/api-reference/types/Coordinates/);  
    context?: [FeatureHierarchy](https://docs.maptiler.com/sdk-js/api-reference/types/FeatureHierarchy/)\[\];  
    matching\_place\_name?: string;  
    matching\_text?: string;  
    place\_name: string;  
    place\_type: [GeocodingPlaceType](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.GeocodingPlaceType/)\[\];  
    place\_type\_name: string\[\];  
    relevance: number;  
    \[key: \`place\_name\_${string}\`\]: string;  
}

#### Type Declaration

-   ##### \[key: \`place\_name\_${string}\`\]: string
    
    A string analogous to the `place_name` field that matches the query in the requested language. This field is only returned when multiple languages are requested using the `language` parameter, and will be present for each requested language.
    
-   ##### `Optional`address?: string
    
    Address number, if applicable
    
-   ##### bbox: [BBox](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.BBox/)
    
    Bounding box of the original feature as \[w, s, e, n\] array
    
-   ##### center: [Coordinates](https://docs.maptiler.com/sdk-js/api-reference/types/Coordinates/)
    
    A \[lon, lat\] array of the original feature centeroid
    
-   ##### `Optional`context?: [FeatureHierarchy](https://docs.maptiler.com/sdk-js/api-reference/types/FeatureHierarchy/)\[\]
    
    Feature hierarchy
    
-   ##### `Optional`matching\_place\_name?: string
    
    A string analogous to the `place_name` field that more closely matches the query than results in the specified language. For example, querying _Praha, Czechia_ with language set to English (`en`) might return a feature with the `place_name` _Prague, Czechia_ and a `matching_place_name` of _Praha, Czechia_.
    
-   ##### `Optional`matching\_text?: string
    
    A string analogous to the `text` field that more closely matches the query than results in the specified language. For example, querying _Praha, Czechia_ with language set to English (`en`) might return a feature with the `text` _Prague_ and the `matching_text` _Praha_.
    
-   ##### place\_name: string
    
    Formatted (including the hierarchy) and localized feature full name
    
-   ##### place\_type: [GeocodingPlaceType](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.GeocodingPlaceType/)\[\]
    
    An array of feature types describing the feature. Currently each feature has only single type but this may change in the future.
    
-   ##### place\_type\_name: string\[\]
    
    Localized type of the place name, matches `place_type` property
    
-   ##### relevance: number
    
    Indicates how well the returned feature matches the user's query on a scale from 0 to 1. 0 means the result does not match the query text at all, while 1 means the result fully matches the query text. You can use the relevance property to remove results that don't fully match the query.