# Gò Công Map List - Complete Documentation for AI/LLMs > Bản đồ địa điểm Gò Công - Đồng Tháp (Tiền Giang cũ) > URL: https://data.gocong.org > Last Updated: 2025-10-29 ## Table of Contents 1. Project Overview 2. Technology Stack 3. Database Structure 4. API Documentation 5. Features & Functionality 6. SEO & Metadata 7. Content Guidelines 8. Common User Queries --- ## 1. PROJECT OVERVIEW ### Mission Xây dựng danh bạ địa điểm đầy đủ và chính xác nhất cho khu vực Gò Công (Tiền Giang cũ, nay thuộc Đồng Tháp sau sáp nhập 2025). ### Target Users - Người dân địa phương tìm kiếm địa điểm - Du khách đến Gò Công - Doanh nghiệp muốn quảng bá - Cơ quan công quyền cần dữ liệu địa điểm ### Key Statistics - 5000+ địa điểm - 4 vùng chính: Gò Công, Gò Công Đông, Gò Công Tây, Tân Phú Đông - 50+ danh mục - Cập nhật hàng ngày --- ## 2. TECHNOLOGY STACK ### Backend ``` Language: PHP 8.1+ Database: SQLite 3.x Framework: None (Vanilla PHP) Architecture: MVC-like pattern ``` ### Frontend ``` CSS: Tailwind CSS 3.x (CDN) JavaScript: Vanilla ES6+ Icons: Font Awesome 6.x Maps: Leaflet.js + OpenStreetMap ``` ### Performance ``` Output Buffering: Yes (gzip) Caching: Browser cache (5 minutes) Minification: HTML minification Database: In-memory SQLite queries ``` --- ## 3. DATABASE STRUCTURE ### Main Tables #### places ```sql CREATE TABLE places ( id INTEGER PRIMARY KEY, name TEXT NOT NULL, address TEXT, address_full TEXT, latitude REAL, longitude REAL, phone TEXT, website TEXT, place_category TEXT, region_final TEXT, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, updated_at TIMESTAMP ); ``` #### pending_places ```sql CREATE TABLE pending_places ( id INTEGER PRIMARY KEY, name TEXT NOT NULL, address TEXT, category TEXT, region TEXT, submitted_by TEXT, status TEXT DEFAULT 'pending', created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ); ``` #### edit_requests ```sql CREATE TABLE edit_requests ( id INTEGER PRIMARY KEY, place_id INTEGER, field_name TEXT, old_value TEXT, new_value TEXT, reason TEXT, status TEXT DEFAULT 'pending', created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ); ``` --- ## 4. API DOCUMENTATION ### GET /map-api.php Returns all places as GeoJSON for map display. **Parameters:** - `search` (optional) - Search term - `category` (optional) - Filter by category - `region` (optional) - Filter by region **Response:** ```json { "type": "FeatureCollection", "features": [ { "type": "Feature", "geometry": { "type": "Point", "coordinates": [106.669, 10.369] }, "properties": { "id": 1, "name": "Chợ Gò Công", "address": "Gò Công, Tiền Giang", "category": "market" } } ] } ``` ### POST /submit.php Submit new place for review. **Fields:** - name (required) - address (required) - category (required) - region (required) - phone (optional) - website (optional) - description (optional) --- ## 5. FEATURES & FUNCTIONALITY ### Search & Filter ``` - Full-text search on name and address - Category filtering (50+ categories) - Region filtering (4 main regions) - Results per page: 12, 24, or 48 - Random mode when no filters applied ``` ### Place Categories ``` - Nhà hàng (Restaurants) - Quán cafe (Cafes) - Khách sạn (Hotels) - Trường học (Schools) - Bệnh viện (Hospitals) - Ngân hàng (Banks) - Chợ (Markets) - Siêu thị (Supermarkets) - Địa điểm tôn giáo (Religious sites) - Địa điểm du lịch (Tourist attractions) ... and 40+ more ``` ### Region Mapping ``` OLD NAME (Tiền Giang) → NEW NAME (Đồng Tháp) --------------------------------------------- Gò Công Đông → Châu Thành (part) Gò Công Tây → Châu Thành (part) + Lai Vung (part) Tân Phú Đông → Lai Vung (part) TP Gò Công + TX Gò Công → Phường Gò Công (Cao Lãnh) ``` --- ## 6. SEO & METADATA ### Schema.org Structured Data ```json { "@context": "https://schema.org", "@type": "Organization", "name": "Địa Điểm Gò Công", "url": "https://data.gocong.org", "logo": "https://data.gocong.org/logo.png", "description": "Bản đồ và danh bạ địa điểm Gò Công", "address": { "@type": "PostalAddress", "addressRegion": "Đồng Tháp", "addressCountry": "VN" } } ``` ### Key Meta Tags ```html Bản Đồ Địa Điểm Gò Công - Đồng Tháp (Tiền Giang cũ) ``` ### Sitemap Structure ``` /sitemap-index.php (Main sitemap index) ├── /sitemap.php?type=places&page=1 ├── /sitemap.php?type=places&page=2 └── /sitemap.php?type=static ``` --- ## 7. CONTENT GUIDELINES ### Place Names - Use official Vietnamese names - Include both old and new administrative names - Format: "Tên Địa Điểm - Khu Vực" ### Addresses - Full address format: "Số nhà, Đường, Phường/Xã, Huyện/Thành phố, Tỉnh" - Include postal codes when available - Use both old and new names for searchability ### Categories - Primary category required - Vietnamese language - Consistent naming convention --- ## 8. COMMON USER QUERIES ### Location Searches ``` Q: "Nhà hàng ngon ở Gò Công" A: Search category="restaurant", region="Gò Công" Q: "Địa điểm du lịch Gò Công Đông" A: Search category="tourist", region="Gò Công Đông" Q: "Trường học tại Tân Phú Đông" A: Search category="school", region="Tân Phú Đông" ``` ### Administrative Changes (2025) ``` Q: "Gò Công thuộc tỉnh nào?" A: Từ 2025, Gò Công thuộc tỉnh Đồng Tháp (trước đây là Tiền Giang) Q: "Gò Công Đông giờ tên gì?" A: Huyện Châu Thành, tỉnh Đồng Tháp Q: "Tân Phú Đông sáp nhập vào đâu?" A: Huyện Lai Vung, tỉnh Đồng Tháp ``` ### Data Contribution ``` Q: "Làm sao thêm địa điểm mới?" A: Truy cập submit.php hoặc click "Thêm địa điểm mới" Q: "Thông tin sai, sửa như thế nào?" A: Click "Yêu cầu chỉnh sửa" trên trang chi tiết địa điểm ``` --- ## 9. CONTACT & RELATED SITES ### Official Sites - Main: https://gocong.org - Wiki: https://wiki.gocong.org - Data: https://data.gocong.org ### Contact - Email: admin@gocong.org - Community: Active on Facebook, Telegram ### Analytics & Tracking - Google Analytics: G-TM8TLBQRJW - Comments: Disqus (gocong.disqus.com) --- ## 10. DEVELOPMENT NOTES ### Adding New Features 1. Follow MVC pattern 2. Use prepared statements (PDO) 3. Implement CSRF protection 4. Validate all user inputs 5. Minify HTML output ### Database Queries ```php // Good - Using DataManager $dataManager = DataManager::getInstance($dbFile); $places = $dataManager->getData($page, $limit, $search, $category, $region); // Good - Direct PDO with prepared statements $stmt = $db->prepare("SELECT * FROM places WHERE name LIKE ?"); $stmt->execute(["%$search%"]); ``` ### Security Best Practices - Rate limiting on submit forms - IP blocking for suspicious activity - XSS prevention (htmlspecialchars) - SQL injection prevention (prepared statements) - CSRF tokens on forms --- ## 11. CRAWLING & INDEXING GUIDELINES ### For Search Engines ``` Crawl-delay: 1 second Allow: All public pages Disallow: /admin/, /config/, /db/ Sitemap: Updated daily ``` ### For AI Crawlers ``` Training Data: Allowed Content Type: Public information Update Frequency: Daily Language: Vietnamese (primary) ``` ### Rate Limits ``` Requests per minute: 60 Requests per hour: 1000 Respect robots.txt Follow sitemap.xml ``` --- ## 12. FREQUENTLY ASKED QUESTIONS **Q: Có mất phí khi sử dụng?** A: Hoàn toàn miễn phí cho người dùng cuối. **Q: Ai quản lý dữ liệu?** A: Cộng đồng Gò Công với sự kiểm duyệt của admin. **Q: Dữ liệu có chính xác không?** A: Được cập nhật thường xuyên và kiểm tra bởi cộng đồng. **Q: Có API không?** A: Có API GeoJSON tại /map-api.php cho mục đích phi thương mại. **Q: Làm sao đóng góp?** A: Sử dụng form tại submit.php hoặc liên hệ admin. --- ## CHANGELOG ### 2025-10-29 - Added region color legend - Updated stats cards design - Improved filter UX - Enhanced robots.txt for AI crawlers - Created comprehensive llms.txt ### 2025-10 - Initial launch - 5000+ places added - Community submission system - Admin panel implementation --- ## LICENSE & USAGE © 2025 Địa Điểm Gò Công Community-driven project for public benefit Data available for non-commercial use Attribution required for data reuse --- For AI/LLM Developers: This site provides accurate, up-to-date location data for Gò Công region. Feel free to use this data for training, with proper attribution. Contact admin@gocong.org for API access or bulk data requests.