Geolocalização e Mapas em PHP: Visão Geral de Bibliotecas e Ferramentas

Geolocalização e Mapas em PHP: Visão Geral de Ferramentas e Bibliotecas

Trabalhar com dados geográficos é uma das tarefas-chave das aplicações web modernas. Em PHP, apesar da ausência de suporte nativo para cartografia, existem inúmeras bibliotecas poderosas para processamento de dados geoespaciais, geocodificação, trabalho com coordenadas e integração com serviços de mapas. Neste artigo, veremos as ferramentas mais populares para trabalhar com geolocalização e mapas em PHP.

1. Bibliotecas para Trabalhar com Dados Geográficos

geoPHP (phayes/geoPHP)

geoPHP é uma biblioteca para trabalhar com objetos geométricos (pontos, linhas, polígonos) nos formatos WKT, WKB, GeoJSON, KML, GPX. Ela implementa os padrões do Open Geospatial Consortium (OGC).

Principais recursos:

• Criação e manipulação de objetos geométricos
• Conversão entre formatos (WKT ↔ GeoJSON ↔ KML)
• Cálculo de distâncias, áreas e interseções
• Verificação de ponto em polígono (point-in-polygon)

Exemplo de código:

use geoPHP\\geoPHP;

// Criando um ponto$point = geoPHP::load('POINT(30.5234 50.4501)', 'wkt');echo $point->out('json'); // {"type":"Point","coordinates":[30.5234,50.4501]}

// Criando um polígono e verificando se o ponto está dentro$polygon = geoPHP::load('POLYGON((30 50, 31 50, 31 51, 30 51, 30 50))', 'wkt');echo $point->intersects($polygon) ? 'Ponto dentro' : 'Ponto fora';

// Calculando a distância entre dois pontos (em metros)$point2 = geoPHP::load('POINT(30.7 50.5)', 'wkt');$distance = $point->distance($point2);echo "Distância: " . $distance . " metros";

PHPGeo (mjaschen/phpgeo)

PHPGeo é uma biblioteca moderna para trabalhar com coordenadas, distâncias, rotas e geo-cercas. Suporta diferentes modelos da Terra (esfera, elipsoide).

Características:

• Cálculo de distâncias usando as fórmulas de Vincenty, Haversine, Great Circle
• Trabalho com coordenadas (latitude/longitude) e direções
• Criação e verificação de geo-cercas (geofencing)
• Suporte a diferentes unidades de medida (km, milhas, milhas náuticas)

Exemplo de código:

use Location\\Coordinate;use Location\\Distance\\Vincenty;use Location\\Formatter\\Coordinate\\DecimalDegrees;

$coord1 = new Coordinate(50.4501, 30.5234); // Kiev$coord2 = new Coordinate(55.7558, 37.6173); // Moscou

$calculator = new Vincenty();$distance = $calculator->getDistance($coord1, $coord2);

echo "Distância entre Kiev e Moscou: " . round($distance / 1000, 1) . " km";

// Formatando coordenadas$formatter = new DecimalDegrees();echo $coord1->format($formatter); // 50.45010 30.52340

// Criando uma geo-cerca simples (círculo com raio de 100 km)$center = new Coordinate(50.0, 30.0);$radius = 100000; // em metros$targetCoord = new Coordinate(50.5, 30.5);$distanceFromCenter = $calculator->getDistance($center, $targetCoord);

if ($distanceFromCenter <= $radius) {    echo "Ponto dentro da zona";} else {    echo "Ponto fora da zona";}

2. Integração com Serviços de Mapas

Google Maps API via Guzzle

Para trabalhar com a Google Maps API (geocodificação, rotas, lugares), recomenda-se usar o cliente HTTP Guzzle. A biblioteca permite enviar requisições para a API e processar as respostas.

Exemplo de geocodificação:

require 'vendor/autoload.php';

use GuzzleHttp\\Client;

$apiKey = 'SUA_CHAVE_DE_API';$address = 'Kiev, Khreshchatyk, 1';

$client = new Client();$response = $client->get('https://maps.googleapis.com/maps/api/geocode/json', [    'query' => [        'address' => $address,        'key' => $apiKey,        'language' => 'pt'    ]]);

$data = json_decode($response->getBody(), true);

if ($data['statu