geo-type
- geo-type
- How to Index GeoJSON Objects
- Define the Index for the geo Type
- Configure geo Field Properties
- Try an Example for the geo Type
- Learn More
- Define the Index for the geo Type
- Configure geo Field Properties
- Try an Example for the geo Type
- Learn More
- Define the Index for the geo Type
- Configure geo Field Properties
- Try an Example for the geo Type
- Learn More
- Define the Index for the geo Type
- Configure geo Field Properties
- Try an Example for the geo Type
- Learn More
- Define the Index for the geo Type
- Configure geo Field Properties
- Try an Example for the geo Type
- Learn More
- Define the Index for the geo Type
- Configure geo Field Properties
- Try an Example for the geo Type
- Learn More
- Define the Index for the geo Type
- Configure geo Field Properties
- Try an Example for the geo Type
- Learn More
- Define the Index for the geo Type
- Configure geo Field Properties
- Try an Example for the geo Type
For the complete MongoDB documentation index, see www.mongodb.com/docs/llms.txt
<!-- Tab options on this page. Append to the .md URL to filter: ?tabs=<id,...> select specific tabs (e.g. ?tabs=nodejs,shell) ?allTabs=true include every tab (no param) default: one tab per tabset
Available tabs: other tabs: vib, jsonib, cloud, local, maven bom, gradle bom, maven, gradle -->
How to Index GeoJSON Objects
Use the MongoDB Search geo field type to index geographic points and shape coordinates. The indexed field must be a GeoJSON object. After you index a field as geo, you can query it using the [geoShape](https://www.mongodb.com/docs/search/query/operators-collectors/geoshape.md#std-label-geoshape-ref and [geoWithin](https://www.mongodb.com/docs/search/query/operators-collectors/geowithin.md#std-label-geowithin-ref operators.
You can use the MongoDB Search geo type to index geographic points and shape coordinates. For this type, the indexed field must be a [GeoJSON](https://www.mongodb.com/docs/manual/reference/geojson.md#std-label-geospatial-indexes-store-geojson object. You can use the [geoShape](https://www.mongodb.com/docs/search/query/operators-collectors/geoshape.md#std-label-geoshape-ref and [geoWithin](https://www.mongodb.com/docs/search/query/operators-collectors/geowithin.md#std-label-geowithin-ref operators to query indexed fields of type geo.
geo type is not included in the dynamic mapping by default. To index fields as geo type, you can use [static mappings](https://www.mongodb.com/docs/search/indexes/define-field-mappings.md#std-label-static-dynamic-mappings or configure a typeSet to include geo in dynamic mapping.
Define the Index for the geo Type
- Retrieve your Service Account access token for the project.
Use your service account to generate an access token, which authenticates your requests to the Atlas Administration API. To learn how to generate an access token, see [Make an API (Application Programming Interface) Request.](https://www.mongodb.com/docs/atlas/configure-api-access.md#std-label-example-api-request
- Make an API (Application Programming Interface) call.
Replace the following values in the curl command below. This command sends a POST request to your cluster to create a MongoDB Search index with the geo field type.
-
Replace {
ACCESS-TOKEN} with the output from the preceding step -
Replace {
groupId} with the project ID of the project where you want to create the MongoDB Search index -
Replace {
clusterName} with the name of the cluster where you want to create the MongoDB Search index
```shell
curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
--header "Accept: application/vnd.atlas.2025-03-12+json" \
--header "Content-Type: application/json" \
-X POST "https://cloud.mongodb.com/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/indexes" \
-d '{ "collectionName": "
```
Configure geo Field Properties
The MongoDB Search geo type takes the following parameters:
| Option | Type | Necessity | Description | Default |
|---|---|---|---|---|
type |
string | Required | Human-readable label that identifies this field type. UI value must be Geo and JSON (Javascript Object Notation) value must be geo. |
|
indexShapes |
boolean | Optional | Flag that indicates whether to index shapes. By default, MongoDB Search: Indexes points, even when nested.; Doesn't index shape geometries such as lines and polygons. Value can be: true to index shapes and points; false to index only points |
false |
Try an Example for the geo Type
The following index definition examples use collections in the [sample data](https://www.mongodb.com/docs/manual/sample-data.md#std-label-available-sample-datasets. After you [load the sample data](https://www.mongodb.com/docs/atlas/import/load-sample-data.md#std-label-load-sample-data, you can use these examples to index fields as the geo type.
To learn how to set up and run the following example code, see [Define the Index for the token Type](https://www.mongodb.com/docs/search/indexes/field-types/token-type.md#std-label-define-index-token-admin-api.
The following index definition for the sample_airbnb.listingsAndReviews collection indexes the address.location field as the geo type. This index allows you to query against that field by using the MongoDB Search [geoShape](https://www.mongodb.com/docs/search/query/operators-collectors/geoshape.md#std-label-geoshape-ref and [geoWithin](https://www.mongodb.com/docs/search/query/operators-collectors/geowithin.md#std-label-geowithin-ref operators.
curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
--header "Accept: application/vnd.atlas.2025-03-12+json" \
--header "Content-Type: application/json" \
-X POST "https://cloud.mongodb.com/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/indexes" \
-d '{ "collectionName": "listingsAndReviews",
"database": "sample_airbnb",
"name": "default",
"type": "search",
"definition": {
"mappings": {
"dynamic": false,
"fields": {
"address": {
"type": "document",
"fields": {
"location": {
"type": "geo",
"indexShapes": true
}
}
}
}
}
}
}'
Learn More
To learn more about the operators you can use to query the geo type, see the following operator reference pages:
-
[geoShape](https://www.mongodb.com/docs/search/query/operators-collectors/geoshape.md#std-label-geoshape-ref
-
[geoWithin](https://www.mongodb.com/docs/search/query/operators-collectors/geowithin.md#std-label-geowithin-ref
You can use the MongoDB Search geo type to index geographic points and shape coordinates. For this type, the indexed field must be a [GeoJSON](https://www.mongodb.com/docs/manual/reference/geojson.md#std-label-geospatial-indexes-store-geojson object. You can use the [geoShape](https://www.mongodb.com/docs/search/query/operators-collectors/geoshape.md#std-label-geoshape-ref and [geoWithin](https://www.mongodb.com/docs/search/query/operators-collectors/geowithin.md#std-label-geowithin-ref operators to query indexed fields of type geo.
geo type is not included in the dynamic mapping by default. To index fields as geo type, you can use [static mappings](https://www.mongodb.com/docs/search/indexes/define-field-mappings.md#std-label-static-dynamic-mappings or configure a typeSet to include geo in dynamic mapping.
Define the Index for the geo Type
- Create a
search-index.jsonconfiguration file and specify thegeotype.
```json
{
"name": "default",
"collectionName": "
```
- Connect to the Atlas CLI
In your terminal, connect to your cluster from the Atlas CLI. To learn more, see Connect from the Atlas CLI.
- Create a MongoDB Search index.
Run the atlas clusters search indexes create command in your terminal, replacing <clusterName> with the name of the cluster, and <path-to-file> with the path to the search-index.json file:
```shell
atlas clusters search indexes create --clusterName
```
Configure geo Field Properties
The MongoDB Search geo type takes the following parameters:
| Option | Type | Necessity | Description | Default |
|---|---|---|---|---|
type |
string | Required | Human-readable label that identifies this field type. UI value must be Geo and JSON (Javascript Object Notation) value must be geo. |
|
indexShapes |
boolean | Optional | Flag that indicates whether to index shapes. By default, MongoDB Search: Indexes points, even when nested.; Doesn't index shape geometries such as lines and polygons. Value can be: true to index shapes and points; false to index only points |
false |
Try an Example for the geo Type
The following index definition examples use collections in the [sample data](https://www.mongodb.com/docs/manual/sample-data.md#std-label-available-sample-datasets. After you [load the sample data](https://www.mongodb.com/docs/atlas/import/load-sample-data.md#std-label-load-sample-data, you can use these examples to index fields as the geo type.
To learn how to set up and run the following example code, see [Define the Index for the token Type](https://www.mongodb.com/docs/search/indexes/field-types/token-type.md#std-label-define-index-token-admin-api.
The following index definition for the sample_airbnb.listingsAndReviews collection indexes the address.location field as the geo type. This index allows you to query against that field by using the MongoDB Search [geoShape](https://www.mongodb.com/docs/search/query/operators-collectors/geoshape.md#std-label-geoshape-ref and [geoWithin](https://www.mongodb.com/docs/search/query/operators-collectors/geowithin.md#std-label-geowithin-ref operators.
{
"name": "default",
"collectionName": "listingsAndReviews",
"database": "sample_airbnb",
"mappings": {
"dynamic": false,
"fields": {
"address": {
"type": "document",
"fields": {
"location": {
"type": "geo",
"indexShapes": true
}
}
}
}
}
}
Learn More
To learn more about the operators you can use to query the geo type, see the following operator reference pages:
-
[geoShape](https://www.mongodb.com/docs/search/query/operators-collectors/geoshape.md#std-label-geoshape-ref
-
[geoWithin](https://www.mongodb.com/docs/search/query/operators-collectors/geowithin.md#std-label-geowithin-ref
You can use the MongoDB Search geo type to index geographic points and shape coordinates. For this type, the indexed field must be a [GeoJSON](https://www.mongodb.com/docs/manual/reference/geojson.md#std-label-geospatial-indexes-store-geojson object. You can use the [geoShape](https://www.mongodb.com/docs/search/query/operators-collectors/geoshape.md#std-label-geoshape-ref and [geoWithin](https://www.mongodb.com/docs/search/query/operators-collectors/geowithin.md#std-label-geowithin-ref operators to query indexed fields of type geo.
geo type is not included in the dynamic mapping by default. To index fields as geo type, you can use [static mappings](https://www.mongodb.com/docs/search/indexes/define-field-mappings.md#std-label-static-dynamic-mappings or configure a typeSet to include geo in dynamic mapping.
Define the Index for the geo Type
- Connect to your cluster using MongoDB Compass.
Open Compass and connect to your cluster. For detailed instructions, see [Connect to a Cluster via Compass.](https://www.mongodb.com/docs/atlas/compass-connection.md#std-label-atlas-connect-via-compass
- Specify the database and collection.
On the Database screen, click the name of the database, then click the name of the collection.
- Create the MongoDB Search index.
Click the Indexes tab, then select Search Indexes.
Click Create Atlas Search Index to open the index creation dialog box.
Specify a name for the index.
Your MongoDB Search index is named default by default. If you keep this name, then your index will be the default Search index for any MongoDB Search query that does not specify a different index option in its [operators](https://www.mongodb.com/docs/search/query/operators-collectors/overview.md#std-label-fts-operators. If you are creating multiple indexes, we recommend that you maintain a consistent, descriptive naming convention across your indexes.
Specify the JSON (Javascript Object Notation) MongoDB Search index definition.
```json
{
"mappings": {
"dynamic": true|false,
"fields": {
"
```
Click Create Search Index.
Configure geo Field Properties
The MongoDB Search geo type takes the following parameters:
| Option | Type | Necessity | Description | Default |
|---|---|---|---|---|
type |
string | Required | Human-readable label that identifies this field type. UI value must be Geo and JSON (Javascript Object Notation) value must be geo. |
|
indexShapes |
boolean | Optional | Flag that indicates whether to index shapes. By default, MongoDB Search: Indexes points, even when nested.; Doesn't index shape geometries such as lines and polygons. Value can be: true to index shapes and points; false to index only points |
false |
Try an Example for the geo Type
The following index definition examples use collections in the [sample data](https://www.mongodb.com/docs/manual/sample-data.md#std-label-available-sample-datasets. After you [load the sample data](https://www.mongodb.com/docs/atlas/import/load-sample-data.md#std-label-load-sample-data, you can use these examples to index fields as the geo type.
To learn how to set up and run the following example code, see [Define the Index for the token Type](https://www.mongodb.com/docs/search/indexes/field-types/token-type.md#std-label-define-index-token-admin-api.
The following index definition for the sample_airbnb.listingsAndReviews collection indexes the address.location field as the geo type. This index allows you to query against that field by using the MongoDB Search [geoShape](https://www.mongodb.com/docs/search/query/operators-collectors/geoshape.md#std-label-geoshape-ref and [geoWithin](https://www.mongodb.com/docs/search/query/operators-collectors/geowithin.md#std-label-geowithin-ref operators.
{
"mappings": {
"dynamic": false,
"fields": {
"address": {
"type": "document",
"fields": {
"location": {
"type": "geo",
"indexShapes": true
}
}
}
}
}
}
Learn More
To learn more about the operators you can use to query the geo type, see the following operator reference pages:
-
[geoShape](https://www.mongodb.com/docs/search/query/operators-collectors/geoshape.md#std-label-geoshape-ref
-
[geoWithin](https://www.mongodb.com/docs/search/query/operators-collectors/geowithin.md#std-label-geowithin-ref
You can use the MongoDB Search geo type to index geographic points and shape coordinates. For this type, the indexed field must be a [GeoJSON](https://www.mongodb.com/docs/manual/reference/geojson.md#std-label-geospatial-indexes-store-geojson object. You can use the [geoShape](https://www.mongodb.com/docs/search/query/operators-collectors/geoshape.md#std-label-geoshape-ref and [geoWithin](https://www.mongodb.com/docs/search/query/operators-collectors/geowithin.md#std-label-geowithin-ref operators to query indexed fields of type geo.
geo type is not included in the dynamic mapping by default. To index fields as geo type, you can use [static mappings](https://www.mongodb.com/docs/search/indexes/define-field-mappings.md#std-label-static-dynamic-mappings or configure a typeSet to include geo in dynamic mapping.
Define the Index for the geo Type
- Connect to the deployment by using
mongosh.
In your terminal, connect to your Atlas cloud-hosted deployment or local deployment from [mongosh](https://www.mongodb.com/docs/mongodb-shell.md#mongodb-binary-bin.mongosh. For detailed instructions on how to connect, see Connect to a Deployment.
- Switch to the database that contains the collection for which you want to create the index.
shell
use <database>
Output:
shell
switched to db <database>
- Run the
db.collection.createSearchIndex()method to create the index.
shell
db.<collection>.createSearchIndex(
"default",
{
"mappings": {
"dynamic": false,
"fields": {
"<field-name>": {
"type": "geo",
"indexShapes": true|false
}
}
}
}
)
Output:
text
default
Configure geo Field Properties
The MongoDB Search geo type takes the following parameters:
| Option | Type | Necessity | Description | Default |
|---|---|---|---|---|
type |
string | Required | Human-readable label that identifies this field type. UI value must be Geo and JSON (Javascript Object Notation) value must be geo. |
|
indexShapes |
boolean | Optional | Flag that indicates whether to index shapes. By default, MongoDB Search: Indexes points, even when nested.; Doesn't index shape geometries such as lines and polygons. Value can be: true to index shapes and points; false to index only points |
false |
Try an Example for the geo Type
The following index definition examples use collections in the [sample data](https://www.mongodb.com/docs/manual/sample-data.md#std-label-available-sample-datasets. After you [load the sample data](https://www.mongodb.com/docs/atlas/import/load-sample-data.md#std-label-load-sample-data, you can use these examples to index fields as the geo type.
To learn how to set up and run the following example code, see [Define the Index for the token Type](https://www.mongodb.com/docs/search/indexes/field-types/token-type.md#std-label-define-index-token-admin-api.
The following index definition for the sample_airbnb.listingsAndReviews collection indexes the address.location field as the geo type. This index allows you to query against that field by using the MongoDB Search [geoShape](https://www.mongodb.com/docs/search/query/operators-collectors/geoshape.md#std-label-geoshape-ref and [geoWithin](https://www.mongodb.com/docs/search/query/operators-collectors/geowithin.md#std-label-geowithin-ref operators.
db.listingsAndReviews.createSearchIndex(
"default",
{
"mappings": {
"dynamic": false,
"fields": {
"address": {
"fields" : {
"location": {
"type": "geo",
"indexShapes": true
}
}
}
}
}}
)
Learn More
To learn more about the operators you can use to query the geo type, see the following operator reference pages:
-
[geoShape](https://www.mongodb.com/docs/search/query/operators-collectors/geoshape.md#std-label-geoshape-ref
-
[geoWithin](https://www.mongodb.com/docs/search/query/operators-collectors/geowithin.md#std-label-geowithin-ref
You can use the MongoDB Search geo type to index geographic points and shape coordinates. For this type, the indexed field must be a [GeoJSON](https://www.mongodb.com/docs/manual/reference/geojson.md#std-label-geospatial-indexes-store-geojson object. You can use the [geoShape](https://www.mongodb.com/docs/search/query/operators-collectors/geoshape.md#std-label-geoshape-ref and [geoWithin](https://www.mongodb.com/docs/search/query/operators-collectors/geowithin.md#std-label-geowithin-ref operators to query indexed fields of type geo.
geo type is not included in the dynamic mapping by default. To index fields as geo type, you can use [static mappings](https://www.mongodb.com/docs/search/indexes/define-field-mappings.md#std-label-static-dynamic-mappings or configure a typeSet to include geo in dynamic mapping.
Define the Index for the geo Type
Choose your preferred configuration method in the Atlas UI and then select the database and collection.
Visual Editor
-
Click Refine Your Index to configure your index.
-
In the Field Mappings section, click Add Field Mapping to open the Add Field Mapping window.
-
Click Customized Configuration.
-
Select the field to index from the Field Name dropdown.
Note:
You can't index fields that contain the dollar ($) sign at the start of the field name.
-
Click the Data Type dropdown and select Geo.
-
Configure the field properties for the
geotype. To learn more, see [Field Properties](https://www.mongodb.com/docs/search/indexes/field-types/uuid-type.md#std-label-fts-field-types-uuid-options. -
Click Add.
Configure geo Field Properties
The MongoDB Search geo type takes the following parameters:
| Option | Type | Necessity | Description | Default |
|---|---|---|---|---|
type |
string | Required | Human-readable label that identifies this field type. UI value must be Geo and JSON (Javascript Object Notation) value must be geo. |
|
indexShapes |
boolean | Optional | Flag that indicates whether to index shapes. By default, MongoDB Search: Indexes points, even when nested.; Doesn't index shape geometries such as lines and polygons. Value can be: true to index shapes and points; false to index only points |
false |
Try an Example for the geo Type
The following index definition examples use collections in the [sample data](https://www.mongodb.com/docs/manual/sample-data.md#std-label-available-sample-datasets. After you [load the sample data](https://www.mongodb.com/docs/atlas/import/load-sample-data.md#std-label-load-sample-data, you can use these examples to index fields as the geo type.
To learn how to set up and run the following example code, see [Define the Index for the token Type](https://www.mongodb.com/docs/search/indexes/field-types/token-type.md#std-label-define-index-token-admin-api.
The following index definition for the sample_airbnb.listingsAndReviews collection indexes the address.location field as the geo type. This index allows you to query against that field by using the MongoDB Search [geoShape](https://www.mongodb.com/docs/search/query/operators-collectors/geoshape.md#std-label-geoshape-ref and [geoWithin](https://www.mongodb.com/docs/search/query/operators-collectors/geowithin.md#std-label-geowithin-ref operators.
Visual Editor
-
In the Add Field Mapping window, select address.location from the Field Name dropdown.
-
Click the Data Type dropdown and select Geo.
-
Modify the Geo Properties to set the value for Index Shapes to
true. -
Click Add.
Learn More
To learn more about the operators you can use to query the geo type, see the following operator reference pages:
-
[geoShape](https://www.mongodb.com/docs/search/query/operators-collectors/geoshape.md#std-label-geoshape-ref
-
[geoWithin](https://www.mongodb.com/docs/search/query/operators-collectors/geowithin.md#std-label-geowithin-ref
You can use the MongoDB Search geo type to index geographic points and shape coordinates. For this type, the indexed field must be a [GeoJSON](https://www.mongodb.com/docs/manual/reference/geojson.md#std-label-geospatial-indexes-store-geojson object. You can use the [geoShape](https://www.mongodb.com/docs/search/query/operators-collectors/geoshape.md#std-label-geoshape-ref and [geoWithin](https://www.mongodb.com/docs/search/query/operators-collectors/geowithin.md#std-label-geowithin-ref operators to query indexed fields of type geo.
geo type is not included in the dynamic mapping by default. To index fields as geo type, you can use [static mappings](https://www.mongodb.com/docs/search/indexes/define-field-mappings.md#std-label-static-dynamic-mappings or configure a typeSet to include geo in dynamic mapping.
Define the Index for the geo Type
- Set up the C project.
In your terminal, navigate to where you want to create your application, then run the following command to create a directory called atlas-search-project for this project:
shell
# Create a new directory for the project
mkdir atlas-search-project && cd atlas-search-project
Add the C driver to your project by following the instructions in the MongoDB C Driver documentation.
- Define the index.
Create a create_index.c file in your project directory, and copy and paste the following code into the file.
```c
#include
int main(int argc, char argv[]) { mongoc_client_t client; mongoc_collection_t collection; bson_error_t error; bson_t cmd; bson_t index_definition; bool success;
/* Initialize the MongoDB C Driver. */
mongoc_init();
/* Connect to your MongoDB deployment. */
client = mongoc_client_new("<connection-string>");
collection = mongoc_client_get_collection (client, "<database>", "<collection>");
if (!client) {
fprintf(stderr, "Failed to create client.\n");
return 1;
}
/* Create the MongoDB Search index definition for the geo field. */
char *cmd_str = bson_strdup_printf (
BSON_STR ({
"createSearchIndexes": "%s",
"indexes": [{
"name": "default",
"definition": {
"mappings": {
"dynamic": true|false,
"fields": {
"<field-name>": {
"type": "geo",
"indexShapes": true|false
}
}
}
}
}]
}),
"<collection>"
);
bson_init_from_json (&cmd, cmd_str, -1, &error);
bson_free (cmd_str);
if (mongoc_collection_command_simple (collection, &cmd, NULL, NULL, &error)) {
printf ("Index created!\n");
} else {
fprintf (stderr, "Failed to create search index: %s", error.message);
}
/* Clean up. */
bson_destroy (&cmd);
mongoc_collection_destroy (collection);
mongoc_client_destroy(client);
mongoc_cleanup();
return 0;
} ```
Replace <connection-string> with the connection string for your Atlas cluster or local Atlas deployment.
To learn more about finding your connection string, see [Connect to a Cluster via Client Libraries.](https://www.mongodb.com/docs/atlas/driver-connection.md#std-label-connect-via-driver
Note:
For a local or self-managed deployment, your connection string should use the following format:
text
mongodb://localhost:<port-number>/?directConnection=true
To learn more, see [Connection Strings.](https://www.mongodb.com/docs/manual/reference/connection-string.md#std-label-mongodb-uri
- Set up a CMake application
To configure your application, create a CMakeLists.txt file in your project directory. Then, add the following code to the file:
```txt
cmake_minimum_required(VERSION 3.11)
project(atlas-search-index LANGUAGES C)
add_executable (index.out create_index.c)
find_package(mongoc
```
The preceding code performs the following actions:
-
Configures a C project.
-
Creates a
index.outexecutable for your application. -
Finds and requires the C driver. Replace the
<version>placeholder with your C driver version, such as2.0.0. -
Links the program to the
libmongoclibrary.
Note:
In the sample CMakeLists.txt file, the mongoc::mongoc target points to either the static library or the shared library. The library type depends on which one is available and whichever type the user specifies in the MONGOC_DEFAULT_IMPORTED_LIBRARY_TYPE CMake configuration setting. If you don't set this value and both library types are available, mongoc::mongoc uses the static library.
You can use the mongoc::static target to explicitly use the static library or the mongoc::shared target to use the shared library.
- Create the index.
In your terminal, run the following commands to build and run this application:
shell
cmake -S. -Bcmake-build
cmake --build cmake-build --target index.out
./cmake-build/index.out
Output:
text
Index created!
Configure geo Field Properties
The MongoDB Search geo type takes the following parameters:
| Option | Type | Necessity | Description | Default |
|---|---|---|---|---|
type |
string | Required | Human-readable label that identifies this field type. UI value must be Geo and JSON (Javascript Object Notation) value must be geo. |
|
indexShapes |
boolean | Optional | Flag that indicates whether to index shapes. By default, MongoDB Search: Indexes points, even when nested.; Doesn't index shape geometries such as lines and polygons. Value can be: true to index shapes and points; false to index only points |
false |
Try an Example for the geo Type
The following index definition examples use collections in the [sample data](https://www.mongodb.com/docs/manual/sample-data.md#std-label-available-sample-datasets. After you [load the sample data](https://www.mongodb.com/docs/atlas/import/load-sample-data.md#std-label-load-sample-data, you can use these examples to index fields as the geo type.
To learn how to set up and run the following example code, see [Define the Index for the token Type](https://www.mongodb.com/docs/search/indexes/field-types/token-type.md#std-label-define-index-token-admin-api.
The following index definition for the sample_airbnb.listingsAndReviews collection indexes the address.location field as the geo type. This index allows you to query against that field by using the MongoDB Search [geoShape](https://www.mongodb.com/docs/search/query/operators-collectors/geoshape.md#std-label-geoshape-ref and [geoWithin](https://www.mongodb.com/docs/search/query/operators-collectors/geowithin.md#std-label-geowithin-ref operators.
#include <mongoc/mongoc.h>
#include <stdio.h>
int main(int argc, char *argv[]) {
mongoc_client_t *client;
mongoc_collection_t *collection;
bson_error_t error;
bson_t cmd;
bson_t *index_definition;
bool success;
/* Initialize the MongoDB C Driver. */
mongoc_init();
/* Connect to your MongoDB deployment. */
client = mongoc_client_new("<connection-string>");
collection = mongoc_client_get_collection (client, "sample_airbnb", "listingsAndReviews");
if (!client) {
fprintf(stderr, "Failed to create client.\n");
return 1;
}
/* Create the MongoDB Search index definition for the geo field. */
char *cmd_str = bson_strdup_printf (
BSON_STR ({
"createSearchIndexes": "%s",
"indexes": [{
"name": "default",
"definition": {
"mappings": {
"dynamic": false,
"fields": {
"address": {
"type": "document",
"fields": {
"location": {
"type": "geo",
"indexShapes": true
}
}
}
}
}
}
}]
}),
"listingsAndReviews"
);
bson_init_from_json (&cmd, cmd_str, -1, &error);
bson_free (cmd_str);
if (mongoc_collection_command_simple (collection, &cmd, NULL, NULL, &error)) {
printf ("Index created!\n");
} else {
fprintf (stderr, "Failed to create search index: %s", error.message);
}
/* Clean up. */
bson_destroy (&cmd);
mongoc_collection_destroy (collection);
mongoc_client_destroy(client);
mongoc_cleanup();
return 0;
}
Learn More
To learn more about the operators you can use to query the geo type, see the following operator reference pages:
-
[geoShape](https://www.mongodb.com/docs/search/query/operators-collectors/geoshape.md#std-label-geoshape-ref
-
[geoWithin](https://www.mongodb.com/docs/search/query/operators-collectors/geowithin.md#std-label-geowithin-ref
You can use the MongoDB Search geo type to index geographic points and shape coordinates. For this type, the indexed field must be a [GeoJSON](https://www.mongodb.com/docs/manual/reference/geojson.md#std-label-geospatial-indexes-store-geojson object. You can use the [geoShape](https://www.mongodb.com/docs/search/query/operators-collectors/geoshape.md#std-label-geoshape-ref and [geoWithin](https://www.mongodb.com/docs/search/query/operators-collectors/geowithin.md#std-label-geowithin-ref operators to query indexed fields of type geo.
geo type is not included in the dynamic mapping by default. To index fields as geo type, you can use [static mappings](https://www.mongodb.com/docs/search/indexes/define-field-mappings.md#std-label-static-dynamic-mappings or configure a typeSet to include geo in dynamic mapping.
Define the Index for the geo Type
- Set up and initialize the .NET/C# project.
In your terminal, navigate to where you want to create your application, then run the following command to create a directory called atlas-search-project and initialize your project in that directory:
```shell # Create a new directory and initialize the project mkdir atlas-search-project && cd atlas-search-project dotnet new console
# Add the MongoDB .NET/C# Driver to your project dotnet add package MongoDB.Driver ```
For more detailed installation instructions, see the MongoDB .NET/C# Driver documentation.
- Define the index.
Paste the following code into the Program.cs file.
```csharp using MongoDB.Bson; using MongoDB.Driver;
// Replace the connection string with your MongoDB deployment's connection string
var uri = "
var client = new MongoClient(uri);
var db = client.GetDatabase("
// Create the MongoDB Search index definition for the geo field
var index = new CreateSearchIndexModel(
"default", new BsonDocument
{
{ "mappings", new BsonDocument
{
{ "dynamic", true|false },
{ "fields", new BsonDocument
{
{ "
var result = collection.SearchIndexes.CreateOne(index); Console.WriteLine($"New index name: {result}"); ```
Replace <connection-string> with the connection string for your Atlas cluster or local Atlas deployment.
To learn more about finding your connection string, see [Connect to a Cluster via Client Libraries.](https://www.mongodb.com/docs/atlas/driver-connection.md#std-label-connect-via-driver
Note:
For a local or self-managed deployment, your connection string should use the following format:
text
mongodb://localhost:<port-number>/?directConnection=true
To learn more, see [Connection Strings.](https://www.mongodb.com/docs/manual/reference/connection-string.md#std-label-mongodb-uri
- Create the index.
shell
dotnet run Program.cs
Output:
text
New index name: default
Configure geo Field Properties
The MongoDB Search geo type takes the following parameters:
| Option | Type | Necessity | Description | Default |
|---|---|---|---|---|
type |
string | Required | Human-readable label that identifies this field type. UI value must be Geo and JSON (Javascript Object Notation) value must be geo. |
|
indexShapes |
boolean | Optional | Flag that indicates whether to index shapes. By default, MongoDB Search: Indexes points, even when nested.; Doesn't index shape geometries such as lines and polygons. Value can be: true to index shapes and points; false to index only points |
false |
Try an Example for the geo Type
The following index definition examples use collections in the [sample data](https://www.mongodb.com/docs/manual/sample-data.md#std-label-available-sample-datasets. After you [load the sample data](https://www.mongodb.com/docs/atlas/import/load-sample-data.md#std-label-load-sample-data, you can use these examples to index fields as the geo type.
To learn how to set up and run the following example code, see [Define the Index for the token Type](https://www.mongodb.com/docs/search/indexes/field-types/token-type.md#std-label-define-index-token-admin-api.
The following index definition for the sample_airbnb.listingsAndReviews collection indexes the address.location field as the geo type. This index allows you to query against that field by using the MongoDB Search [geoShape](https://www.mongodb.com/docs/search/query/operators-collectors/geoshape.md#std-label-geoshape-ref and [geoWithin](https://www.mongodb.com/docs/search/query/operators-collectors/geowithin.md#std-label-geowithin-ref operators.
using MongoDB.Bson;
using MongoDB.Driver;
// Replace the connection string with your MongoDB deployment's connection string
var uri = "<connection-string>";
var client = new MongoClient(uri);
var db = client.GetDatabase("sample_airbnb");
var collection = db.GetCollection<BsonDocument>("listingsAndReviews");
// Create the MongoDB Search index definition for the geo field
var index = new CreateSearchIndexModel(
"default", new BsonDocument
{
{ "mappings", new BsonDocument
{
{ "dynamic", false },
{ "fields", new BsonDocument
{
{ "address", new BsonDocument
{
{ "type", "document" },
{ "fields", new BsonDocument
{
{ "location", new BsonDocument
{
{ "type", "geo" },
{ "indexShapes", true }
}
}
}
}
}
}
}
}
}
}
});
var result = collection.SearchIndexes.CreateOne(index);
Console.WriteLine($"New index name: {result}");
Learn More
To learn more about the operators you can use to query the geo type, see the following operator reference pages:
-
[geoShape](https://www.mongodb.com/docs/search/query/operators-collectors/geoshape.md#std-label-geoshape-ref
-
[geoWithin](https://www.mongodb.com/docs/search/query/operators-collectors/geowithin.md#std-label-geowithin-ref
You can use the MongoDB Search geo type to index geographic points and shape coordinates. For this type, the indexed field must be a [GeoJSON](https://www.mongodb.com/docs/manual/reference/geojson.md#std-label-geospatial-indexes-store-geojson object. You can use the [geoShape](https://www.mongodb.com/docs/search/query/operators-collectors/geoshape.md#std-label-geoshape-ref and [geoWithin](https://www.mongodb.com/docs/search/query/operators-collectors/geowithin.md#std-label-geowithin-ref operators to query indexed fields of type geo.
geo type is not included in the dynamic mapping by default. To index fields as geo type, you can use [static mappings](https://www.mongodb.com/docs/search/indexes/define-field-mappings.md#std-label-static-dynamic-mappings or configure a typeSet to include geo in dynamic mapping.
Define the Index for the geo Type
- Set up the C++ project.
In your terminal, navigate to where you want to create your application, then run the following command to create a directory called atlas-search-project for this project:
shell
# Create a new directory for the project
mkdir atlas-search-project && cd atlas-search-project
For more detailed installation instructions, see the MongoDB C++ Driver documentation.
- Define the index.
Create a CreateIndex.cpp file in your project directory, and copy and paste the following code into the file.
```cpp
#include
#include
using bsoncxx::builder::basic::kvp; using bsoncxx::builder::basic::make_document;
int main() { // Initialize the MongoDB C++ driver mongocxx::instance instance{};
// Connect to your MongoDB deployment
mongocxx::uri uri("<connection-string>");
mongocxx::client client(uri);
auto db = client["<database>"];
auto collection = db["<collection>"];
auto siv = collection.search_indexes();
// Create the MongoDB Search index definition for the geo field
auto name = "default";
auto definition = make_document(
kvp("mappings", make_document(
kvp("dynamic", true|false),
kvp("fields", make_document(
kvp("<field-name>", make_document(
kvp("type", "geo"),
kvp("indexShapes", true|false)
))
))
))
);
auto model = mongocxx::search_index_model(name, definition.view());
try {
// Execute the command to create the index
auto result = siv.create_one(model);
std::cout << "New index name: " << result << std::endl;
} catch (const std::exception& e) {
std::cerr << "Error creating Atlas Search index: " << e.what() << std::endl;
}
} ```
Replace <connection-string> with the connection string for your Atlas cluster or local Atlas deployment.
To learn more about finding your connection string, see [Connect to a Cluster via Client Libraries.](https://www.mongodb.com/docs/atlas/driver-connection.md#std-label-connect-via-driver
Note:
For a local or self-managed deployment, your connection string should use the following format:
text
mongodb://localhost:<port-number>/?directConnection=true
To learn more, see [Connection Strings.](https://www.mongodb.com/docs/manual/reference/connection-string.md#std-label-mongodb-uri
- Create the index.
shell
c++ --std=c++17 CreateIndex.cpp $(pkg-config --cflags --libs libmongocxx) -o ./app.out
./app.out
Output:
text
New index name: default
Tip: MacOS Error
MacOS users might see the following error after running the preceding commands:
sh
dyld[54430]: Library not loaded: @rpath/libmongocxx._noabi.dylib
To resolve this error, use the -Wl,``-rpath`` linker option to set the @rpath, as shown in the following code:
sh
c++ --std=c++17 CreateIndex.cpp -Wl,-rpath,/usr/local/lib/ $(pkg-config --cflags --libs libmongocxx) -o ./app.out
./app.out
Configure geo Field Properties
The MongoDB Search geo type takes the following parameters:
| Option | Type | Necessity | Description | Default |
|---|---|---|---|---|
type |
string | Required | Human-readable label that identifies this field type. UI value must be Geo and JSON (Javascript Object Notation) value must be geo. |
|
indexShapes |
boolean | Optional | Flag that indicates whether to index shapes. By default, MongoDB Search: Indexes points, even when nested.; Doesn't index shape geometries such as lines and polygons. Value can be: true to index shapes and points; false to index only points |
false |
Try an Example for the geo Type
The following index definition examples use collection
(本文超出站点单文档体积上限,已截断)
