0Pricing
Supabase Backend as a Service · Урок

Расширенные геопространственные данные (PostGIS)

Интегрируйте PostGIS для работы со сложными геопространственными данными, выполнения запросов по местоположению и создания картографических функций в приложении

«Расширенные геопространственные данные (PostGIS)» — бесплатный урок Supabase Backend as a Service на CoddyKit. Это урок 2 из 3. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Supabase Backend as a Service, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Supabase Backend as a Service содержит 3 уроков всего.

Части этого урока еще не переведены и отображаются на английском.

Unlocking Geospatial Power

Welcome to Advanced Geospatial Data (PostGIS)! In this lesson, we'll explore how to handle location-based data directly within your Supabase database.

Geospatial data is crucial for apps that deal with maps, locations, navigation, or proximity services.

What is PostGIS?

PostGIS is a powerful, open-source extension for PostgreSQL that adds support for geographic objects.

  • It transforms your database into a spatial database.
  • It allows you to store, query, and analyze location data (points, lines, polygons).
  • Supabase, being built on PostgreSQL, fully supports PostGIS.

Why Use PostGIS?

Traditional databases store locations as separate latitude/longitude columns, making complex queries difficult.

PostGIS provides specialized functions to:

  • Calculate distances between points.
  • Find locations within a specific radius.
  • Determine if points are inside an area.
  • Perform complex spatial joins and analyses.

Enabling PostGIS Extension

Before using PostGIS, you need to enable the extension in your Supabase project. This is a one-time step done via the SQL Editor in your Supabase dashboard.

Simply run the following command:

CREATE EXTENSION IF NOT EXISTS postgis;

Geospatial Data Types

PostGIS introduces new data types to store spatial information:

  • GEOMETRY: Stores data on a 2D Cartesian plane (flat earth model). Good for small-scale, local areas.
  • GEOGRAPHY: Stores data on a spherical globe (real-world coordinates). Best for large-scale, global applications.

We'll primarily use GEOMETRY for simplicity in examples, but GEOGRAPHY is often preferred for real-world distances.

Creating a Table with Spatial Data

Let's create a table to store points of interest, like coffee shops, using a GEOMETRY column. The SRID (Spatial Reference ID) 4326 is standard for latitude/longitude.

CREATE TABLE coffee_shops (
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  name TEXT NOT NULL,
  location GEOMETRY(Point, 4326)
);

Inserting Geospatial Points

To insert a point, we use the ST_GeomFromText() function, which converts a Well-Known Text (WKT) representation into a PostGIS geometry object. The format is 'POINT(longitude latitude)'.

INSERT INTO coffee_shops (name, location) VALUES
('Espresso Hub', ST_GeomFromText('POINT(-0.1278 51.5074)', 4326)),
('Bean Scene', ST_GeomFromText('POINT(-0.1419 51.5085)', 4326)),
('Daily Grind', ST_GeomFromText('POINT(-0.1000 51.5200)', 4326));

Finding Nearest Locations

One common task is finding locations near a specific point. We can use ST_Distance() to calculate the distance between two geometry points. The unit of distance depends on the SRID (e.g., meters for 4326 on GEOGRAPHY type, degrees for GEOMETRY type).

Here, we find shops near a reference point (e.g., user's current location).

SELECT
  name,
  ST_Distance(
    location,
    ST_GeomFromText('POINT(-0.1300 51.5090)', 4326)
  ) AS distance_in_degrees
FROM
  coffee_shops
ORDER BY
  distance_in_degrees
LIMIT 1;

Efficient Proximity Search

For more efficient proximity searches, especially when working with GEOGRAPHY types for real-world distances, ST_DWithin() is excellent. It checks if two geometries are within a specified distance.

Let's find all coffee shops within 1000 meters of a specific point using GEOGRAPHY for accurate distance calculation.

SELECT
  name
FROM
  coffee_shops
WHERE
  ST_DWithin(
    location::geography,
    ST_GeomFromText('POINT(-0.1300 51.5090)', 4326)::geography,
    1000 -- 1000 meters
  );

PostGIS Query Check

You've learned how to enable PostGIS, create tables with spatial columns, and insert/query geospatial data.

Which PostGIS function would you typically use to find all points of interest that are located within 500 meters of a user's current position, assuming you're using the GEOGRAPHY type?

Recap: Geospatial Data

Great job! You've taken your first steps into the world of geospatial data with PostGIS and Supabase.

  • We enabled the PostGIS extension.
  • Learned about GEOMETRY and GEOGRAPHY types.
  • Created tables and inserted data using WKT.
  • Performed basic spatial queries like distance calculation and proximity searches with ST_Distance() and ST_DWithin().

PostGIS opens up a vast array of possibilities for location-aware applications!

Часто задаваемые вопросы

Урок «Расширенные геопространственные данные (PostGIS)» бесплатный?

Да — полный текст урока «Расширенные геопространственные данные (PostGIS)» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Supabase Backend as a Service, подпишись на CoddyKit PRO. Курс Supabase Backend as a Service содержит 3 уроков всего.

Чему я научусь в уроке «Расширенные геопространственные данные (PostGIS)»?

Интегрируйте PostGIS для работы со сложными геопространственными данными, выполнения запросов по местоположению и создания картографических функций в приложении Ты практикуешь Supabase Backend as a Service с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать Supabase Backend as a Service?

Предыдущий опыт не требуется. Supabase Backend as a Service на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 2 из 3.

Сколько времени занимает урок «Расширенные геопространственные данные (PostGIS)»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке Supabase Backend as a Service?

Да. Каждый урок Supabase Backend as a Service включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

  1. Использование расширений Postgres
  2. Расширенные геопространственные данные (PostGIS)
  3. Полнотекстовый поиск и векторные представления с pgvector
← Назад к Supabase Backend as a Service