GeoFilm

GeoFilm is a Spring Boot application developed as a small project during a 2-weeks in our internship by a team of colleagues. The platform allows users to explore filming locations from movies and TV shows around the world, integrating with external APIs to fetch movie data and using web scraping to extract filming location information .

Project Context

This project was completed in just 2 weeks during an internship program, showcasing rapid development capabilities and collaborative teamwork . The development team consisted of multiple contributors including monstahcode, IvanR05, and Grifo999, as evidenced by the git commit history.

Features

• Movie Search: Search for movies and TV shows using the OMDb API
• Location Discovery: Automatically scrape filming locations from IMDb using Selenium WebDriver
• Geocoding: Convert location addresses to coordinates using DistanceMatrix AI API
• User Favorites: Save and manage favorite filming locations through many-to-many relationships
• RESTful API: Complete REST API for frontend integration

Technology Stack

• Framework: Spring Boot 3.5.0
• Language: Java 17
• Database: MySQL with JPA/Hibernate
• Web Scraping: Selenium WebDriver with Firefox
• HTML Parsing: Jsoup
• Security: Spring Security

Getting Started

Prerequisites

• Java 17 or higher
• Maven 3.6+
• MySQL database
• Firefox browser installed
• GeckoDriver executable

Installation

1. Clone the repository
2. Configure your MySQL database connection in application.properties
3. Ensure Firefox and GeckoDriver are properly installed
4. Run the application:

mvn spring-boot:run

API Endpoints

Movie Search

• POST /api/v1/media/search/name - Search for movies by name
• POST /api/v1/media/search/predict/name - Get search predictions
• POST /api/v1/media/search/id - Search by IMDb ID

Architecture

The application follows a layered architecture with clear separation of concerns:

• Entities: JPA entities for User and Location with many-to-many relationships
• Media Objects: Transient objects for external API data (Media, MediaLocation)
• Services: Business logic layer for search and location management
• Controllers: REST API endpoints with CORS support
• Repositories: Data access layer using Spring Data JPA

External Integrations

• OMDb API: Movie metadata retrieval
• IMDb Web Scraping: Filming location extraction using Selenium
• DistanceMatrix AI: Geocoding services for coordinate resolution

Development Timeline

This project demonstrates what can be accomplished in a short timeframe with focused collaboration . The rapid development cycle included implementing complex features like web scraping, API integration, and database management within the 2-week internship period .

Contributing

This internship project was collaboratively developed by monstahcode, IvanR05, and Grifo999. The codebase demonstrates effective teamwork and follows established Spring Boot conventions .

Notes

The project showcases the capabilities of a small development team working under tight deadlines. Despite the 2-week timeframe, the application includes sophisticated features like web scraping with Selenium, external API integrations, and a complete REST API architecture. The Spanish description in the POM file indicates this was likely developed in a Spanish-speaking environment: "Plataforma que permite explorar lugares del mundo donde se filmaron escenas icónicas de películas y series."