Japan Trip 2026: Toddler-Friendly Adventure 🇯🇵

📌 Project Status

  • Last Updated: Wednesday, April 22, 2026
  • Current Hotel (Tokyo): Park Hyatt Tokyo
  • Status: Itinerary finalized with detailed day trip transit logistics.
  • Archive: japan-trip.zip contains the latest source code, optimized images, and data files. (Sensitive files like .env are explicitly excluded for security).

✈️ Flight Information (Confirmed)

Departure: Sat, May 16, 2026

  • Flight: ZG029 (Zipair)
  • Route: San Jose (SJC) 11:40 → Tokyo Narita (NRT) 14:50 (+1 Day)
  • Duration: 11 hours 10 minutes

Return: Mon, Jun 1, 2026

  • Flight: ZG030 (Zipair)
  • Route: Tokyo Narita (NRT) 16:25 → San Jose (SJC) 09:40
  • Duration: 9 hours 15 minutes

🗺️ Itinerary Overview

0. The Narita Landing (1 Night)

Location: Narita Omotesando Dates: May 17 – May 18

  • Why: Immediate rest after an 11-hour flight. Omotesando offers a traditional feel right next to the airport.
  • Toddler Tip: Naritasan Park is huge and perfect for stretching little legs after a long flight.
  • Accommodation Interest: Wakamatsu Honten (Traditional ryokan right across from the temple) or Richmond Hotel Narita (Modern, near the station).

Detailed Daily Plan:

  • Day 1 (May 17): Arrival at NRT (14:50). Short train/taxi to Narita Omotesando. Check-in and evening walk to see the temple lit up.
  • Day 2 (May 18): Naritasan Park (feeding koi fish) and Kuriyama Park (mini steam locomotive). Afternoon train to Shinjuku.

1. The “Big City” Start (5 Nights)

Location: Shinjuku/Shibuya, Tokyo Dates: May 18 – May 23

  • Why: Simple transit to Hakone (Odakyu Romancecar).
  • Toddler Tip: Tokyo’s museums for young children are exceptionally hands-on. Shinjuku Gyoen is perfect for burning off jet lag.
  • Accommodation: Park Hyatt Tokyo (3-7-1 Nishi-Shinjuku).
    • Note: Use the complimentary hotel shuttle to/from Shinjuku Station (West Exit) to save 15 mins of walking.

Detailed Day Trip Logistics (from Park Hyatt):

  1. Shibuya & Parks (Walk/Train):
    • Walk to Meiji Jingu/Yoyogi Park: ~20-25 mins (pleasant walk through Nishi-Shinjuku).
    • Yoyogi Park to Playground Shibuya Kids: ~15 min walk or 1 stop on JR Yamanote (Harajuku to Shibuya).
  2. Local Shinjuku (Walk/Shuttle):
    • Walk to Shinjuku Gyoen: ~30-35 mins (or shuttle to station + 10 min walk).
    • Fire Museum: 10 min walk from Shinjuku Gyoen (Okido Gate) or Marunouchi Line to Yotsuya-sanchome.
  3. Tokyo Dome City (Subway):
    • Transit to Asobōno!: Shuttle to Shinjuku St. → JR Chuo-Sobu Line to Suidobashi (30-35 mins total).
    • Explore: Tokyo Dome City and Koishikawa Korakuen are adjacent to Asobōno!.
  4. Imperial Palace (Subway):
    • Transit to Tokyo Station: Shuttle to Shinjuku St. → JR Chuo Line Rapid (30 mins total).
    • Boats: Take Toei Shinjuku Line to Kudanshita Station (8 mins) for the Chidorigafuchi moat boat rentals.

Detailed Daily Plan:

  • Day 2 (May 18): Afternoon arrival from Narita. Check-in, evening walk in Shinjuku Gyoen.
  • Day 3 (May 19): Asobōno! at Tokyo Dome City. One of the largest indoor play centers in the city, featuring a massive ball pit with a pirate ship, a “market” for pretend grocery shopping, and an extensive Plarail train room. Afternoon at Koishikawa Korakuen.
  • Day 4 (May 20): teamLab Borderless (Azabudai Hills) - Immersive digital art. Afternoon: Robot Park (Sakurazaka Park) in Roppongi Hills for colorful slides and spring riders.
  • Day 5 (May 21): Tokyo Disneyland - Full day of magic.
  • Day 6 (May 22): Explore Shibuya & Harajuku. Visit Playground Shibuya Kids for a clean, reservation-only indoor break. Run around in Yoyogi Park and visit Meiji Jingu.
  • Day 7 (May 23): Tokyo Toy Museum (housed in a renovated school; focuses on wooden toys and tactile play) and the Fire Museum (sit in real helicopters and fire trucks; free). Afternoon transit to Hakone.

Alternative Options (Open Days):

  • National Museum of Nature and Science (Ueno): Dinosaur skeletons and the “Compa” play area for young children.
  • Police Museum (Ginza): Police motorcycles and uniforms for dress-up (free).

2. The Mountain Retreat (4 Nights)

Location: Hakone (Lake Ashi & Gora) Dates: May 23 – May 27

  • Why: Slow pace. Splitting the stay between the lake and the mountains reduces transit time for a toddler.
  • Toddler Tip: The Hakone Free Pass (3-Day) is essential. It covers the Pirate Ship, Ropeway, and all local buses/trains. Use the Digital Pass on your phone for easy “tap and go” while managing a stroller.
  • Accommodation Interest:
    • Nights 1-2 (Lake Ashi): The Prince Hakone Lake Ashinoko or a ryokan in Moto-Hakone.
    • Nights 3-4 (Gora): Hakone Kowakien Ten-yu or similar (closer to the Open-Air Museum).

Detailed Daily Plan:

  • Day 7 (May 23): Odakyu Romancecar from Shinjuku to Hakone-Yumoto (requires Free Pass + Limited Express surcharge). Take the Hakone Tozan Bus (Line R or H) directly to Lake Ashi. Check-in and lakeside walk.
  • Day 8 (May 24): Pirate Ship & Lakeside. Ride the Sightseeing Cruise across Lake Ashi. Explore Onshi-Hakone Park (great views and wide paths) and the iconic “floating” torii gate of Hakone Shrine.
    • Idea: Visit Dakkoshite! Zoo at Hakone-en—a small indoor petting zoo perfect for toddlers to meet alpacas and ponies.
  • Day 9 (May 25): The Ropeway Journey. Take the Hakone Ropeway from Togendai to Owakudani. See the volcanic vents and try a “black egg” (briefly, as sulfur fumes can be strong). Continue via Ropeway/Cable Car down to Gora. Check into your second hotel.
    • Idea: Ride the NINJABUS, an amphibious bus that splashes into the lake (starts near Hakone-en).
  • Day 10 (May 26): Museums & Parks. Hakone Open-Air Museum in the morning (prioritize the “Net Forest” and “Zig Zag World” play areas). Afternoon at Gora Park to see the giant fountain and tropical greenhouses.
    • Dining Idea: Gyoza Center (Gora) - casual, famous, and very kid-friendly.

Logistics Tips:

  • Stroller: Use a compact foldable travel stroller. The Tozan “Zig-Zag” train and local buses can be very crowded.
  • Luggage: Use the Hakone Carrying Service at Hakone-Yumoto Station to send your bags directly to your Lake Ashi hotel so you can explore hands-free immediately.

3. The Coastal Break (3 Nights)

Location: Atami Dates: May 27 – May 30

  • Why: Short hop from Hakone. Focus on relaxation.
  • Toddler Tip: RISONARE Atami’s “Sand Beach Cafe” and indoor climbing are great rainy-day backups.
  • Accommodation Interest: Hoshino Resorts RISONARE Atami.

Detailed Daily Plan:

  • Day 11 (May 27): Transit to Atami. Check-in to RISONARE Atami. Explore the “Tree House” forest.
  • Day 12 (May 28): Marine Spa Atami - Waterslides and pools.
  • Day 13 (May 29): Acao Forest & Kinomiya Shrine (Camphor forest).

4. The Waterfront Finale (2 Nights)

Location: Odaiba, Tokyo Dates: May 30 – Jun 1

  • Why: Pedestrian-friendly “mall island.” No stroller hurdles.
  • Toddler Tip: Legoland Discovery Center and waterfront park.

Detailed Daily Plan:

  • Day 14 (May 30): Shinkansen to Tokyo/Odaiba. Check-in.
  • Day 15 (May 31): Legoland Discovery Center (indoor LEGO playground, Miniland) & teamLab Planets (Toyosu). At Planets, kids can walk through knee-deep water and explore rooms with giant floating balloons. Rest Zone: Toyosu Park nearby. Final farewell dinner.
  • Day 16 (Jun 1): Last minute souvenirs at Aqua City. Limousine Bus to Narita (NRT) for flight home.

🚆 Logistics & Transit

Leg Mode Est. Time Est. Cost Notes
NRT → Shinjuku Narita Express 90 mins ¥3,200 Direct to Shinjuku St.
Shinjuku → Hakone Odakyu Romancecar 85 mins ¥7,700 Hakone 3-Day Free Pass (¥6,500) + Romancecar Surcharge (¥1,200)
Hakone → Atami Bus or Train (via Odawara) 45-60 mins ¥1,000 Short hop from Gora/Odawara; Bus is often simpler
Atami → Odaiba Shinkansen + Local 90 mins ¥4,100 Bullet train to Shinagawa + Yurikamome
Odaiba → NRT Limousine Bus 80 mins ¥3,200 Direct from major Odaiba hotels

📸 Automated Image Sourcing Workflow

We use a Python-based automation to source and optimize images. This ensures high-quality, local assets with consistent metadata.

🛠️ Setup

  1. Environment: Managed by uv in the scripts/ directory.
  2. API Keys: Requires GOOGLE_SEARCH_API_KEY, GOOGLE_SEARCH_ENGINE_ID, and GOOGLE_API_KEY in a scripts/.env file.

🚀 Execution

Run the script from the root directory using: uv run --project scripts scripts/image_sourcer.py "Search Query" The script will automatically resolve the images/ directory within the project folder.

💡 Learned Best Practices

  • Model Choice: Always default to gemini-3.1-flash-lite-preview for vision tasks (e.g., selecting representative photos).
  • Be Context Specific:
    • Use “Shinjuku Gyoen lush green summer” for May/June trips.
    • Use “Shibuya Scramble Crossing aerial view” to avoid indoor play area confusion.
    • Use “Robot Park Roppongi Hills outdoor robot slides” to avoid indoor inflatable centers.
    • Use “Tokyo Disneyland Cinderella Castle” to avoid generic municipal playground equipment.
    • Use specific exhibit names for teamLab (e.g., “Forest of Resonating Lamps” for Borderless vs “Floating Flower Garden” for Planets) to ensure visual variety.
  • Geographical Validation:
    • Always double-check coordinates for accuracy. For Narita, pins should be precisely placed on the Omotesando shopping street.
    • Ensure map markers have enough spacing or logic to prevent “jumbled text” (e.g., MIMARU/Toy Museum overlaps).
  • Traditional vs. Modern: Use descriptive terms like “traditional street shops” for Narita Omotesando.
  • Layout Consistency: Ensure all activity sections (especially Phase 4) follow the established title + image + description template. Avoid orphaned text by ensuring each data entry is complete.

🔄 Process

  1. Search: Google Custom Search API retrieves the top 10 image results.
  2. Optimization: Images are downloaded and compressed using Pillow to < 200KB (JPEG).
  3. Selection: Gemini 1.5 Flash reviews candidates and selects the most representative and high-quality image.
  4. Storage: Saved to /images/ with metadata tracked in metadata.json.

🛠️ Technical Plan for HTML Planner

  • Maps: Integrate Google Maps API to plot hotels and activities.
  • Caching: Implement a local cache (JSON or LocalStorage) for API responses.
  • Images: Use the local /images/ directory populated by the image_sourcer.py script.
  • Design: Premium, responsive UI with smooth transitions and toddler-friendly readability.

⚙️ User Preferences & Constraints

  • Feedback Mandate: This document (gemini.md) MUST be updated whenever user feedback reveals gaps in automated sourcing or data accuracy. It serves as the primary memory for the agent to avoid repeating past mistakes.
  • Gemini Model: Use gemini-3.1-flash-lite-preview for all vision and reasoning tasks (image selection, itinerary validation).
  • Gemini API Quota: Only use for image selection and high-value reasoning.
  • Image Sourcing: Use the image_sourcer.py script for all new location images.
  • Versions: Pin Python packages to versions released at least 1 week ago (relative to current date).
  • Compression: All local images must be < 200KB.