0Pricing
Supabase Backend as a Service · Aula

Dados geoespaciais avançados (PostGIS)

Integre o PostGIS para lidar com dados geoespaciais complexos, realizar consultas baseadas em localização e criar recursos de mapas em seu aplicativo.

Dados geoespaciais avançados (PostGIS) é uma aula grátis de Supabase Backend as a Service no CoddyKit. Esta é a aula 2 de 3. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Supabase Backend as a Service, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Supabase Backend as a Service inclui 3 aulas no total.

Partes desta aula ainda não foram traduzidas e aparecem em inglês.

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!

Perguntas Frequentes

A aula “Dados geoespaciais avançados (PostGIS)” é grátis?

Sim — o texto completo de “Dados geoespaciais avançados (PostGIS)” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Supabase Backend as a Service, atualize para CoddyKit PRO. O curso de Supabase Backend as a Service inclui 3 aulas no total.

O que vou aprender em “Dados geoespaciais avançados (PostGIS)”?

Integre o PostGIS para lidar com dados geoespaciais complexos, realizar consultas baseadas em localização e criar recursos de mapas em seu aplicativo. Você pratica Supabase Backend as a Service com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar Supabase Backend as a Service?

Nenhuma experiência prévia é necessária. Supabase Backend as a Service no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 3.

Quanto tempo leva a aula “Dados geoespaciais avançados (PostGIS)”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de Supabase Backend as a Service?

Sim. Cada aula de Supabase Backend as a Service inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

  1. Utilizando extensões do Postgres
  2. Dados geoespaciais avançados (PostGIS)
  3. Pesquisa de Texto Completo e Incorporações Vetoriais com pgvector
← Voltar para Supabase Backend as a Service