|
1 | 1 | --- |
2 | | -title: Geospatial and GeoJSON location data in Azure Cosmos DB |
3 | | -description: Understand how to create spatial objects with Azure Cosmos DB and the API for NoSQL. |
4 | | -author: seesharprun |
| 2 | +title: Geospatial and GeoJSON location data |
| 3 | +titleSuffix: Azure Cosmos DB for NoSQL |
| 4 | +description: Create spatial objects with Azure Cosmos DB for NoSQL, index these objects, and perform queries using them. |
| 5 | +author: jcodella |
| 6 | +ms.author: jacodel |
| 7 | +ms.reviewer: sidandrews |
5 | 8 | ms.service: cosmos-db |
6 | 9 | ms.subservice: nosql |
7 | | -ms.topic: conceptual |
8 | | -ms.date: 02/17/2022 |
9 | | -ms.author: sidandrews |
10 | | -ms.reviewer: jucocchi |
11 | | -ms.custom: ignite-2022 |
| 10 | +ms.topic: reference |
| 11 | +ms.date: 07/31/2023 |
| 12 | +ms.custom: query-reference |
12 | 13 | --- |
13 | | -# Geospatial and GeoJSON location data in Azure Cosmos DB |
| 14 | + |
| 15 | +# Geospatial and GeoJSON location data in Azure Cosmos DB for NoSQL |
| 16 | + |
14 | 17 | [!INCLUDE[NoSQL](../../includes/appliesto-nosql.md)] |
15 | 18 |
|
16 | | -This article is an introduction to the geospatial functionality in Azure Cosmos DB. After reading our documentation on geospatial indexing you will be able to answer the following questions: |
| 19 | +This article is an introduction to the geospatial functionality in Azure Cosmos DB. After reading our documentation on geospatial indexing, you'll be able to answer the following questions: |
17 | 20 |
|
18 | | -* How do I store spatial data in Azure Cosmos DB? |
19 | | -* How can I query spatial data in Azure Cosmos DB in SQL and LINQ? |
20 | | -* How do I enable or disable spatial indexing in Azure Cosmos DB? |
| 21 | +- How do I store spatial data in Azure Cosmos DB? |
| 22 | +- How can I query spatial data in Azure Cosmos DB in SQL and LINQ? |
| 23 | +- How do I enable or disable spatial indexing in Azure Cosmos DB? |
21 | 24 |
|
22 | 25 | ## Spatial Data Use Cases |
23 | 26 |
|
24 | 27 | Geospatial data often involve proximity queries, for example, "find all coffee shops near my current location". Common use cases are: |
25 | 28 |
|
26 | | -* Geolocation Analytics, driving specific located marketing initiatives. |
27 | | -* Location based personalization, for multiple industries like Retail and Healthcare. |
28 | | -* Logistics enhancement, for transport optimization. |
29 | | -* Risk Analysis, especially for insurance and finance companies. |
30 | | -* Situational awareness, for alerts and notifications. |
| 29 | +- Geolocation Analytics, driving specific located marketing initiatives. |
| 30 | +- Location based personalization, for multiple industries like Retail and Healthcare. |
| 31 | +- Logistics enhancement, for transport optimization. |
| 32 | +- Risk Analysis, especially for insurance and finance companies. |
| 33 | +- Situational awareness, for alerts and notifications. |
31 | 34 |
|
32 | 35 | ## Introduction to spatial data |
33 | 36 |
|
@@ -138,7 +141,7 @@ A **Polygon** is a boundary of connected points that forms a closed LineString. |
138 | 141 |
|
139 | 142 | ### MultiPolygons |
140 | 143 |
|
141 | | -A **MultiPolygon** is an array of zero or more Polygons. **MultiPolygons** cannot overlap sides or have any common area. They may touch at one or more points. |
| 144 | +A **MultiPolygon** is an array of zero or more Polygons. **MultiPolygons** can't overlap sides or have any common area. They may touch at one or more points. |
142 | 145 |
|
143 | 146 | **MultiPolygons in GeoJSON** |
144 | 147 |
|
@@ -169,7 +172,7 @@ Since the shape of the earth is irregular, coordinates of geography geospatial d |
169 | 172 | The most popular CRS in use today is the World Geodetic System [WGS-84](https://earth-info.nga.mil/GandG/update/index.php). GPS devices, and many mapping services including Google Maps and Bing Maps APIs use WGS-84. Azure Cosmos DB supports indexing and querying of geography geospatial data using the WGS-84 CRS only. |
170 | 173 |
|
171 | 174 | ## Creating documents with spatial data |
172 | | -When you create documents that contain GeoJSON values, they are automatically indexed with a spatial index in accordance to the indexing policy of the container. If you're working with an Azure Cosmos DB SDK in a dynamically typed language like Python or Node.js, you must create valid GeoJSON. |
| 175 | +When you create documents that contain GeoJSON values, they're automatically indexed with a spatial index in accordance to the indexing policy of the container. If you're working with an Azure Cosmos DB SDK in a dynamically typed language like Python or Node.js, you must create valid GeoJSON. |
173 | 176 |
|
174 | 177 | **Create Document with Geospatial data in Node.js** |
175 | 178 |
|
@@ -216,8 +219,5 @@ If you don't have the latitude and longitude information, but have the physical |
216 | 219 |
|
217 | 220 | ## Next steps |
218 | 221 |
|
219 | | -Now that you have learned how to get started with geospatial support in Azure Cosmos DB, next you can: |
220 | | - |
221 | | -* Learn more about [Azure Cosmos DB Query](getting-started.md) |
222 | | -* Learn more about [Querying spatial data with Azure Cosmos DB](geospatial-query.md) |
223 | | -* Learn more about [Index spatial data with Azure Cosmos DB](geospatial-index.md) |
| 222 | +- [Objects and arrays](object-array.md) |
| 223 | +- [Index and query GeoJSON location data](../how-to-geospatial-index-query.md) |
0 commit comments