Можно ли передать геозапрос в GET?

Передача геозапросов через GET

Да, можно передать геозапрос (geographic query / spatial query) через GET, но это требует правильного кодирования параметров и понимания ограничений HTTP.

Проблемы с длиной URL

Первый вопрос, который встаёт: HTTP GET имеет ограничения на длину URL.

• Браузеры: ~2000 символов
• Серверы (nginx): по умолчанию 4096
• Apache: по умолчанию 8192
• Нет стандарта в HTTP спецификации

Геозапросы часто содержат большие координатные данные, особенно при работе с сложными полигонами (например, границы страны, города). Это может превысить лимит.

❌ Проблема:
GET /api/locations?polygon=[[0,0],[1,1],[2,2],[3,3]...[100,100]]

Варианты передачи геозапроса через GET

Вариант 1: Простые координаты (рекомендуемый)

Для поиска в радиусе:

// URL:
// GET /api/locations?latitude=55.7558&longitude=37.6173&radius=1000

@RestController
@RequestMapping("/api/locations")
public class LocationController {
    
    @GetMapping
    public List<Location> findNearby(
            @RequestParam Double latitude,
            @RequestParam Double longitude,
            @RequestParam(defaultValue = "1000") Integer radius) {
        // radius в метрах
        return locationService.findWithinRadius(latitude, longitude, radius);
    }
}

Вариант 2: Bounding Box (прямоугольник)

// URL:
// GET /api/locations?minLat=55.7&maxLat=55.8&minLon=37.6&maxLon=37.7

@GetMapping
public List<Location> findInBoundingBox(
        @RequestParam Double minLat,
        @RequestParam Double maxLat,
        @RequestParam Double minLon,
        @RequestParam Double maxLon) {
    return locationService.findInBbox(minLat, maxLat, minLon, maxLon);
}

Вариант 3: GeoJSON как строка (для небольших полигонов)

// URL (с URL-кодированием):
// GET /api/locations?geojson=%7B%22type%22%3A%22Point%22...

@GetMapping
public List<Location> findByGeoJSON(
        @RequestParam String geojson) throws Exception {
    ObjectMapper mapper = new ObjectMapper();
    GeoJSON shape = mapper.readValue(
        URLDecoder.decode(geojson, "UTF-8"), 
        GeoJSON.class
    );
    return locationService.findByShape(shape);
}

Кодирование

Географические данные нужно URL-кодировать:

String polygon = "[[0,0],[1,1],[2,2]]";
String encoded = URLEncoder.encode(polygon, "UTF-8");
// Результат: %5B%5B0%2C0%5D%2C%5B1%2C1%5D%2C%5B2%2C2%5D%5D

// Полный URL:
// GET /api/locations?polygon=%5B%5B0%2C0%5D%2C%5B1%2C1%5D%2C%5B2%2C2%5D%5D

PostGIS и Spring Data JPA

Если вы используете PostGIS для хранения геоданных:

@Entity
@Table(name = "locations")
public class Location {
    @Id
    private Long id;
    
    @Column(columnDefinition = "geometry(Point, 4326)")
    private Point location;  // org.locationtech.jts.geom.Point
    
    private String name;
}

@Repository
public interface LocationRepository extends JpaRepository<Location, Long> {
    // Поиск точек в радиусе (PostGIS функция ST_DWithin)
    @Query("SELECT l FROM Location l WHERE ST_DWithin(l.location, ST_Point(:lon, :lat, 4326), :radius) = true")
    List<Location> findWithinRadius(
            @Param("lat") double latitude,
            @Param("lon") double longitude,
            @Param("radius") double radius
    );
}

Контроллер для поиска по радиусу

@RestController
@RequestMapping("/api/v1/locations")
public class LocationController {
    
    @Autowired
    private LocationRepository locationRepository;
    
    /**
     * GET /api/v1/locations?latitude=55.7558&longitude=37.6173&radius=1000
     * radius в метрах
     */
    @GetMapping
    public ResponseEntity<List<LocationDTO>> searchNearby(
            @RequestParam Double latitude,
            @RequestParam Double longitude,
            @RequestParam(defaultValue = "1000") Integer radius) {
        
        if (latitude < -90 || latitude > 90 || longitude < -180 || longitude > 180) {
            return ResponseEntity.badRequest().build();
        }
        
        List<Location> locations = locationRepository.findWithinRadius(
            latitude, longitude, radius
        );
        
        return ResponseEntity.ok(
            locations.stream()
                .map(this::toDTO)
                .collect(Collectors.toList())
        );
    }
    
    private LocationDTO toDTO(Location location) {
        return new LocationDTO(
            location.getId(),
            location.getName(),
            location.getLocation().getY(),
            location.getLocation().getX()
        );
    }
}

Когда использовать POST вместо GET

Получается, когда:

1. Сложные полигоны: > 1000 символов URL
2. Множество параметров: Много фильтров + геоданные
3. Чувствительные данные: Геолокация пользователя (HTTPS не защищает URL)
4. Семантика: Изменение состояния (сохранение избранных мест)

@PostMapping
public ResponseEntity<List<Location>> searchComplex(@RequestBody SearchRequest request) {
    // request содержит сложный GeoJSON полигон
    List<Location> results = locationService.findByPolygon(request.getPolygon());
    return ResponseEntity.ok(results);
}

class SearchRequest {
    private GeoJSON polygon;
    private List<String> categories;
    private PriceRange priceRange;
    private RatingFilter ratingFilter;
}

Best Practices

✅ Используй GET для:

• Простые координаты (latitude/longitude)
• Поиск в радиусе
• Bounding box запросы
• Кэшируемые запросы

✅ Используй POST для:

• Сложные полигоны
• Множество параметров
• Конфиденциальные данные
• Операции, которые изменяют состояние

✅ Всегда:

• Валидируй координаты (latitude: -90 to 90, longitude: -180 to 180)
• Используй HTTPS (геолокация — чувствительные данные)
• Кэшируй результаты (Redis, HTTP кэш)
• Индексируй пространственные данные в БД

Вывод

Да, можно передать геозапрос через GET, но:

• Для простых случаев (координаты, радиус) — отлично
• Для сложных полигонов — лучше POST
• Всегда валидируй и кодируй URL правильно