Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/actuallyakash/streetviewhub

🌏 Discover Random Destinations & Cities explored by people on Google Street View.
https://github.com/actuallyakash/streetviewhub

eyeshot google-maps google-streetview panorama panorama-viewer photosphere photosphere-images streetview streetviewhub

Last synced: about 1 month ago
JSON representation

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

Host: GitHub
URL: https://github.com/actuallyakash/streetviewhub
Owner: actuallyakash
Created: 2019-11-20T09:22:01.000Z (about 5 years ago)
Default Branch: master
Last Pushed: 2023-04-19T20:49:54.000Z (over 1 year ago)
Last Synced: 2024-07-30T18:54:32.629Z (5 months ago)
Topics: eyeshot, google-maps, google-streetview, panorama, panorama-viewer, photosphere, photosphere-images, streetview, streetviewhub
Language: PHP
Homepage: http://streetviewhub.com
Size: 2.4 MB
Stars: 22
Watchers: 7
Forks: 4
Open Issues: 5
Metadata Files:
- Readme: readme.md

Awesome Lists containing this project

README

        


  


  

  

  Random Street View on Steroids 👀








  

    

  

  

    

  

  



Welcome to the [streetviewhub.com](https://streetviewhub.com) 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 streetviewhub.com?

[streetviewhub.com](https://streetviewhub.com) is a visual discovery of the world around us, explored by people like you. StreetviewHub'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?

[streetviewhub.com](https://streetviewhub.com) 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 StreetviewHub, I just added the randomness and community to it. Now, stop reading and start [exploring](https://streetviewhub.com).

## Table of Contents

- [What is streetviewhub.com?](#what-is-streetviewhub)

- [Why?](#why)

- [Table of Contents](#table-of-contents)

- [How Randomizer Works?](#how-randomizer-works)

- [Contributing](#contributing)

- [Tech Stack](#tech-stack)

- [License](#license)

## How randomizer works?

The randomizer is the vital part of StreetviewHub 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](https://github.com/actuallyakash/StreetviewHub/blob/master/public/js/index.js#L253) from which a random coordinate is picked up and sent through a [function](https://github.com/actuallyakash/StreetviewHub/blob/master/public/js/index.js#L224) that generates more random coordinates within a [specific radius](https://jsfiddle.net/actuallyakash/putxLv39/latest/) 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 streetviewhub.

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](https://php.net/): yes, PHP

- [Laravel](https://laravel.com): PHP Framework

- [Composer](https://getcomposer.org/): Dependency Manager

- [MySQL](https://www.mysql.com/): database

- [AWS S3](https://aws.amazon.com/s3/): for storing images

- [AWS Lightsail](https://aws.amazon.com/lightsail/): for running the website

## License

The StreetviewHub is open-source website licensed under the [GNU AGPLv3 license](https://opensource.org/licenses/AGPL-3.0).

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






  

  


   A rare cat discovered on Google Street View

  



  Keep Exploring 🚶‍♂️