Skip to content

Commit 898ea9f

Browse files
Add sidebar
updated refs and sidebar Update .sqlfluffignore
1 parent f9a296c commit 898ea9f

File tree

5 files changed

+143
-138
lines changed

5 files changed

+143
-138
lines changed

docs/getting-data/bigquery.mdx

+59-59
Original file line numberDiff line numberDiff line change
@@ -2,18 +2,18 @@
22
title: Google BigQuery
33
---
44

5-
Overture data is accessible in Google BigQuery as part of the [Google Cloud Public Dataset Program](https://cloud.google.com/bigquery/public-data), with the data being listed and maintained by [CARTO](https.//www.carto.com).
5+
Overture data is accessible in Google BigQuery as part of the [Google Cloud Public Dataset Program](https://cloud.google.com/bigquery/public-data), with the data being listed and maintained by [CARTO](https.//www.carto.com).
66

77

8-
<img
9-
src="../../static/img/getting-data/BigQuery-1.png"
10-
alt="Overture data in Google Cloud"
11-
width="900"
12-
height="auto"
8+
<img
9+
src="/img/getting-data/BigQuery-1.png"
10+
alt="Overture data in Google Cloud"
11+
width="900"
12+
height="auto"
1313
/>
1414

1515

16-
Below is a step-by-step guide on how to access and use Overture data in BigQuery:
16+
Below is a step-by-step guide on how to access and use Overture data in BigQuery:
1717

1818
## Before you begin
1919

@@ -24,114 +24,114 @@ To get started using Overture data in BigQuery, you must create or select a Goog
2424
2. Navigate to the **BigQuery** section by selecting `BigQuery` from the side menu or searching for it in the search bar.
2525

2626

27-
<img
28-
src="../../static/img/getting-data/bigquery-2.png"
29-
alt="Overture data in Google Cloud"
30-
width="900"
31-
height="auto"
27+
<img
28+
src="/img/getting-data/bigquery-2.png"
29+
alt="Overture data in Google Cloud"
30+
width="900"
31+
height="auto"
3232
/>
3333

3434

3535
3. In the BigQuery console, click **Add Data**. Then, click on **Public Datasets**.
3636

3737

38-
<img
39-
src="../../static/img/getting-data/bigquery-4.png"
40-
alt="Overture data in Google Cloud"
41-
width="900"
42-
height="auto"
38+
<img
39+
src="/img/getting-data/bigquery-4.png"
40+
alt="Overture data in Google Cloud"
41+
width="900"
42+
height="auto"
4343
/>
4444

4545

46-
4. The Google Cloud data marketplace will open. In the search box look for **Overture Maps**.
46+
4. The Google Cloud data marketplace will open. In the search box look for **Overture Maps**.
4747

4848

49-
<img
50-
src="../../static/img/getting-data/bigquery-5.png"
51-
alt="Overture data in Google Cloud"
52-
width="900"
53-
height="auto"
49+
<img
50+
src="/img/getting-data/bigquery-5.png"
51+
alt="Overture data in Google Cloud"
52+
width="900"
53+
height="auto"
5454
/>
5555

5656

57-
5. Select the **Overture Maps Data** listing. Then, click on **View dataset**.
57+
5. Select the **Overture Maps Data** listing. Then, click on **View dataset**.
5858

5959

60-
<img
61-
src="../../static/img/getting-data/bigquery-6.png"
62-
alt="Overture data in Google Cloud"
63-
width="900"
64-
height="auto"
60+
<img
61+
src="/img/getting-data/bigquery-6.png"
62+
alt="Overture data in Google Cloud"
63+
width="900"
64+
height="auto"
6565
/>
6666

6767

68-
6. Back again in the BigQuery console you will see the `bigquery-public-data` project and the `overture_maps`dataset selected.
68+
6. Back again in the BigQuery console you will see the `bigquery-public-data` project and the `overture_maps`dataset selected.
6969

7070

71-
<img
72-
src="../../static/img/getting-data/bigquery-7.png"
73-
alt="Overture data in Google Cloud"
74-
width="900"
75-
height="auto"
71+
<img
72+
src="/img/getting-data/bigquery-7.png"
73+
alt="Overture data in Google Cloud"
74+
width="900"
75+
height="auto"
7676
/>
7777

7878

7979
7. Our recommendation is that you add the `overture_maps` dataset or entirely the `bigquery-public-data` project in your starred selection in order to have access to the Overture data always at hand.
8080

8181

82-
<img
83-
src="../../static/img/getting-data/bigquery-8.png"
84-
alt="Overture data in Google Cloud"
85-
width="900"
86-
height="auto"
82+
<img
83+
src="/img/getting-data/bigquery-8.png"
84+
alt="Overture data in Google Cloud"
85+
width="900"
86+
height="auto"
8787
/>
8888

8989

9090
## Working with Overture Data in BigQuery
9191

92-
8. Now that Overture Maps data is available in your BigQuery console, you can start using it. Note that in the `overture_maps` dataset you have access to all tables from all the different Overture Maps themes: Addresses, Base, Buildings, Divisions, Places and Transporatation.
92+
8. Now that Overture Maps data is available in your BigQuery console, you can start using it. Note that in the `overture_maps` dataset you have access to all tables from all the different Overture Maps themes: Addresses, Base, Buildings, Divisions, Places and Transporatation.
9393

9494

95-
<img
96-
src="../../static/img/getting-data/bigquery-9.png"
97-
alt="Overture data in Google Cloud"
98-
width="900"
99-
height="auto"
95+
<img
96+
src="/img/getting-data/bigquery-9.png"
97+
alt="Overture data in Google Cloud"
98+
width="900"
99+
height="auto"
100100
/>
101101

102102

103103
9. The release version is detailed as a `label` in each of the tables. You can check it out in the **Details** section of each table.
104104

105105

106-
<img
107-
src="../../static/img/getting-data/bigquery-10.png"
108-
alt="Overture data in Google Cloud"
109-
width="900"
110-
height="auto"
106+
<img
107+
src="/img/getting-data/bigquery-10.png"
108+
alt="Overture data in Google Cloud"
109+
width="900"
110+
height="auto"
111111
/>
112112

113113

114114
10. You can now query any of the tables directly from your SQL Editor in BigQuery. Here's one example for the Places data in Overture Maps.
115115

116116

117-
<img
118-
src="../../static/img/getting-data/bigquery-11.png"
119-
alt="Overture data in Google Cloud"
120-
width="900"
121-
height="auto"
117+
<img
118+
src="/img/getting-data/bigquery-11.png"
119+
alt="Overture data in Google Cloud"
120+
width="900"
121+
height="auto"
122122
/>
123123

124124

125125
```sql
126126
// Identify places within the "Restaurant" category
127-
SELECT id, phones.list[0].element AS phone, names.primary AS name
128-
FROM `bigquery-public-data.overture_maps.place`
127+
SELECT id, phones.list[0].element AS phone, names.primary AS name
128+
FROM `bigquery-public-data.overture_maps.place`
129129
WHERE categories.primary = "restaurant"
130130
LIMIT 100;
131131
```
132132

133133
## Additional Notes
134134

135-
- **Updates**: CARTO regularly updates the Overture datasets in BigQuery and keeps the dataset synced with the last release. You can check the release version of the data as a metadata label in each table.
135+
- **Updates**: CARTO regularly updates the Overture datasets in BigQuery and keeps the dataset synced with the last release. You can check the release version of the data as a metadata label in each table.
136136
- **Support**: If you encounter issues accessing the data, contact CARTO support via [email protected].
137137
- **CARTO**: Once you have the Overture data you need in BigQuery, you can use CARTO's cloud-native spatial analytics platform running on your BigQuery account to build interactive maps, data procesing and analytical workflows or geospatial applications. Not yet on CARTO? Open a 14-day free trial [here](https://www.carto.com/signup).

docs/getting-data/databricks.mdx

+47-47
Original file line numberDiff line numberDiff line change
@@ -17,78 +17,78 @@ Before accessing the Overture Maps data in Databricks, ensure you have:
1717
2. From the Databricks workspace home page, navigate to the **Databricks Marketplace** by selecting the **Marketplace** tab from the sidebar.
1818

1919

20-
<img
21-
src="../../static/img/getting-data/databricks-1.png"
22-
alt="Databricks Marketplace"
23-
width="900"
24-
height="auto"
20+
<img
21+
src="/img/getting-data/databricks-1.png"
22+
alt="Databricks Marketplace"
23+
width="900"
24+
height="auto"
2525
/>
2626

2727

2828
3. Use the search bar in the Databricks Marketplace to search for `CARTO` or `Overture Maps`.
2929

3030

31-
<img
32-
src="../../static/img/getting-data/databricks-2.png"
33-
alt="Databricks Marketplace"
34-
width="900"
35-
height="auto"
31+
<img
32+
src="/img/getting-data/databricks-2.png"
33+
alt="Databricks Marketplace"
34+
width="900"
35+
height="auto"
3636
/>
3737

38-
38+
3939
4. The listings have been organized by Overture theme; therefore, you will find the following listings available: Addresses, Base, Buildings, Divisions, Places and Transportation. Select one to access the listing details.
4040

4141

42-
<img
43-
src="../../static/img/getting-data/databricks-3.png"
44-
alt="Databricks Marketplace"
45-
width="900"
46-
height="auto"
42+
<img
43+
src="/img/getting-data/databricks-3.png"
44+
alt="Databricks Marketplace"
45+
width="900"
46+
height="auto"
4747
/>
4848

4949

5050
5. Review the dataset description, terms of use, and any documentation provided by CARTO.
5151
6. Click **Get instant access** to request access to the dataset.
5252

5353

54-
<img
55-
src="../../static/img/getting-data/databricks-4.png"
56-
alt="Databricks Marketplace"
57-
width="900"
58-
height="auto"
54+
<img
55+
src="/img/getting-data/databricks-4.png"
56+
alt="Databricks Marketplace"
57+
width="900"
58+
height="auto"
5959
/>
6060

6161

6262
7. Before you get access you can specify where are you planning to use the data and also provide a custom name to the Databricks Catalog in which the data will be made available. After accepting the terms, click on **Get instant access**.
6363

6464

65-
<img
66-
src="../../static/img/getting-data/databricks-5.png"
67-
alt="Databricks Marketplace"
68-
width="900"
69-
height="auto"
65+
<img
66+
src="/img/getting-data/databricks-5.png"
67+
alt="Databricks Marketplace"
68+
width="900"
69+
height="auto"
7070
/>
7171

7272

7373
8. Now, in the same listing page you have the option to click on **Open**.
7474

7575

76-
<img
77-
src="../../static/img/getting-data/databricks-6.png"
78-
alt="Databricks Marketplace"
79-
width="900"
80-
height="auto"
76+
<img
77+
src="/img/getting-data/databricks-6.png"
78+
alt="Databricks Marketplace"
79+
width="900"
80+
height="auto"
8181
/>
8282

8383

8484
9. After clicking on **Open** you will be taken to your Catalogs with the newly created Catalog `carto_overtue_maps_places`open.
8585

8686

87-
<img
88-
src="../../static/img/getting-data/databricks-7.png"
89-
alt="Databricks Marketplace"
90-
width="900"
91-
height="auto"
87+
<img
88+
src="/img/getting-data/databricks-7.png"
89+
alt="Databricks Marketplace"
90+
width="900"
91+
height="auto"
9292
/>
9393

9494

@@ -97,28 +97,28 @@ Before accessing the Overture Maps data in Databricks, ensure you have:
9797
10. Once you have the Overture Maps data that you need in your Catalogs you can start working with it. Following our example, in the Place table you can click on **Create** and then **Query**.
9898

9999

100-
<img
101-
src="../../static/img/getting-data/databricks-8.png"
102-
alt="Databricks Marketplace"
103-
width="900"
104-
height="auto"
100+
<img
101+
src="/img/getting-data/databricks-8.png"
102+
alt="Databricks Marketplace"
103+
width="900"
104+
height="auto"
105105
/>
106106

107107

108108
11. That will open the SQL Editor ready to query the `place` table.
109109

110110

111-
<img
112-
src="../../static/img/getting-data/databricks-9.png"
113-
alt="Databricks Marketplace"
114-
width="900"
115-
height="auto"
111+
<img
112+
src="/img/getting-data/databricks-9.png"
113+
alt="Databricks Marketplace"
114+
width="900"
115+
height="auto"
116116
/>
117117

118118

119119
## Additional Notes
120120

121-
- **Updates**: CARTO regularly updates the Overture datasets in Databricks and keeps the listings synced with the last release. You can check the release version of the data from the share description in each listing.
121+
- **Updates**: CARTO regularly updates the Overture datasets in Databricks and keeps the listings synced with the last release. You can check the release version of the data from the share description in each listing.
122122
- **Support**: If you encounter issues accessing the data, contact CARTO support via [email protected].
123123
- **CARTO**: Once you have the Overture data you need in Databricks, you can use CARTO's cloud-native spatial analytics platform running on your Databricks account to build interactive maps, data procesing and analytical workflows or geospatial applications. Not yet on CARTO? Open a 14-day free trial [here](https://www.carto.com/signup).
124124
- **Databricks**: For more information on Databricks Marketplace, refer to the official [Databricks documentation](https://docs.databricks.com/en/marketplace/index.html).

0 commit comments

Comments
 (0)