bansicloud/eyeshot

🌏 Discover Random Destinations & Cities explored by people on Google Street View.

Discover random places from Google Street View. 👀

Welcome to the eyeshot.xyz codebase. Here lies all the code with all the awesomeness and 🐛s. Have some ideas or feedback, go ahead and create issue or make a PR or maybe give a ⭐.

What is eyeshot.xyz?

eyeshot.xyz is a visual discovery of the world around us, explored by people like you. Eyeshot's content comes from two sources - Google and explorers (you).

Explore places you never been before. Who knows where you'll end up next 🤩

Why?

eyeshot.xyz is based on Google Street View. I am forever grateful for the gift it is to the web.

The thing is, it helps you in TELEPORTING, not physically but virtually at any random place. It's super fun to explore places where we are not able to go. Through Eyeshot, I just added the randomness and community to it. Now, stop reading and start exploring.

Table of Contents

• What is eyeshot.xyz?
• Why?
• Table of Contents
• How Randomizer Works?
• Contributing
• Tech Stack
• License

How randomizer works?

The randomizer is the vital part of Eyeshot and a lot of time has been invested in making it... random. You must be thinking that "It's just a loop picking values randomly from an array full of locations, through rand() function", yes, you're partially right.

It's an array filled with awesome coordinates from which a random coordinate is picked up and sent through a function that generates more random coordinates within a specific radius from the given coordinate.

Finally, the newly generated coordinate from the algorithm is sent to the Street View API to check if a panorama exists on the given coordinates, if true, it shows a 360° view. If false, it repeats the whole process until the panorama is found.

So, from one coordinate the algorithm can generate 1000s of random coordinates within that radius. That's how I was able to add a bit of randomness to it. So, it is truly random.

Contributing

Wanna contribute? Having some kick-ass suggestions or help improve eyeshot. Just fork away and do what you wanna do or submit a issue if you found a bug. Detailed installation steps are on the way!

Tech Stack

• PHP: yes, PHP
• Laravel: PHP Framework
• Composer: Dependency Manager
• MySQL: database
• AWS S3: for storing images
• AWS Lightsail: for running the website

License

The Eyeshot is open-source website licensed under the GNU AGPLv3 license.

Get in touch at my low budget email [email protected] 😅

A rare cat discovered on Google Street View

Keep Exploring 🚶‍♂️