https://github.com/mhulse/rand-street-view
Random Google Street View.
https://github.com/mhulse/rand-street-view
coordinates geo google latitude longitude maps random streetview
Last synced: 4 months ago
JSON representation
Random Google Street View.
- Host: GitHub
- URL: https://github.com/mhulse/rand-street-view
- Owner: mhulse
- License: apache-2.0
- Created: 2019-02-06T05:59:15.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-03-04T03:08:29.000Z (over 3 years ago)
- Last Synced: 2024-04-14T20:24:56.691Z (about 2 years ago)
- Topics: coordinates, geo, google, latitude, longitude, maps, random, streetview
- Language: JavaScript
- Size: 35.2 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# rand-street-view
Get random Google Street View data.
## In the real world
See [Kludgy](https://github.com/mhulse/kludgy)
## Usage
See [`test.js`](test.js) for an example.
## Options
option | default | description
--- | --- | ---
`key` | | Required. **Your** [Google Maps API key](https://developers.google.com/maps/documentation/javascript/get-api-key).
`coords` | | Custom starting coordinates in the form of `{lattitude:0, longitude:0}`. If not defined, randomly picked coordinates will be used.
`debug` | `false` | Among other things, this option pipes the browser process `stdout` and `stderr` into `process.stdout` and `process.stderr`.
`radius` | `100` | Starting radius (in meters) from given `LatLng` to look for `StreetViewPanoramaData`.
`multiplier` | `2` | Exponentially grows the radius by this number on each attempt.
`attempts` | `1` | Number of times the script should grow the radius to search for a nearby panorama.
`throttle` | `1` | Seconds to delay next API call to search for a panorama.
`google` | `false` | Google-only pano data? Based on pano data copyright string.
## Return value
```js
{
status: 'success',
message: 'Panorama found within 13 attempts.',
lat: 16.921235,
lng: 145.78154399999994,
id: 'CAoSLEFGMVFpcE1iNk1oUTBQN3BoZzVxVW1MMTNNMVdjTmI3aDdJcThjdE9EMWRo',
copyright: '© Paul Toogood',
link: 'https://maps.google.com/?q=16.921235,145.78154399999994&ll=16.921235,145.78154399999994&z=0',
tiles: {
centerHeading: 0,
originHeading: 0,
originPitch: 0,
tileSize: {
width: 512,
height: 512
},
worldSize: {
width: 10782,
height: 5391
}
}
}
```
## Development notes
Notes pertaining to module development … More information coming soon.
### Debugging the Google Maps HTML
Set `debug` to `true`. Next, locate `temp.html` and open it in Chrome and enable the Web Developer Toolbar.
### Google Maps API key
In order to make testing easier, create a `key.js` file and add in your [Google Maps API key](https://developers.google.com/maps/documentation/javascript/get-api-key):
```js
// Non-functional example key (you’ll have to generate your own):
module.exports = 'AIzaSyDNuylDKnjnYY46zkORPEt2-g4HK3O6wnw';
```
## License
Copyright © 2019 [Michael Hulse](http://mky.io).
Licensed under the Apache License, Version 2.0 (the “License”); you may not use this work except in compliance with the License. You may obtain a copy of the License in the LICENSE file, or at:
[http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
