thinkzone.wlonk.com

Solar System Scale Model Calculator
Instructions for Website Developers

The Main Page - SolarSystemModel.php

Use this URL to link to the Solar System Scale Model Calculator main page.

URL Query fields - Options

URL query fields may be used to pre-define the model and set options for the main page (SolarSystemModel.php), the Map page (SolarSystemMap.html), or the KML page (SolarSystem.kml.php).

These fields are required to define the scale a model: (scale) or (obj & dia) or (obj & dist).

These fields are required to define a location on the map: (lat & lon) or (loc).

For the Map page or KML page, the only applicable fields are: scale, obj, dia, dist, lat, lon, loc, and the planet options.

Field Value Description
Scaling fields
scale= number > 1 Model scale.
obj= sun or planet name Base object for scaling: Sun, Mercury, Venus, Earth, Mars, Ceres, Jupiter, Saturn, Uranus, Neptune, Pluto, Eris, Planet9
dia= number+m|cm|ft|in
example: 2.5m
Model diameter of sun or planet.
dist= number+m|cm|ft|in
example: 1000ft
Model distance of planet from the sun.
Location fields
lat= -90 to 90 Latitude of center of solar system on map.
lon= -180 to 180 Longitude of center of solar system on map.
loc= lat,lon Latitude and longitude, comma-separated. (Alternative)
Section options
table= y/n (default y) Show solar system table on main page.
map= y/n (default n) Show solar system map on main page.
Units options
us= y/n (default n) Show US units (mi/ft/in) rather than metric (km/m/cm) on table.
Planet options
mercury= y/n (default y) Show Mercury.
venus= y/n (default y) Show Venus.
earth= y/n (default y) Show Earth.
mars= y/n (default y) Show Mars.
ceres= y/n (default y) Show Ceres - Asteroid Belt.
jupiter= y/n (default y) Show Jupiter.
saturn= y/n (default y) Show Saturn.
uranus= y/n (default y) Show Uranus.
neptune= y/n (default y) Show Neptune.
pluto= y/n (default y) Show Pluto - Kuiper Belt.
eris= y/n (default n) Show Eris - Scattered Disk.
planet9= y/n (default n) Show Planet 9 - Distant Detached Objects.
Table options
rings= y/n (default n) Show rings table.
moons= y/n (default n) Show moons table.
stars= y/n (default n) Show stars and galaxies table.
minmax= y/n (default n) Show min/max distances on table.
au= y/n (default n) Show astronomical units on table.
light= y/n (default n) Show light travel times on table.

Examples:

The boolean options will accept values y/n or 1/0.

Change Notice (July 2016): Added options for all individual planets (previously, the main eight planets were always shown). Added new lat & lon query fields (old loc=lat,lon is still supported).

KML Files

Thinkzone Solar System Model uses KML files or KML layers to draw the planet orbit circles on a map.

You may use KML files with tools like Google Maps API, Google My Maps, or Google Earth.

KML is XML. You can read and edit KML.

The Map Page - SolarSystemMap.html

The Map page shows nothing but a full-window Google map with the solar system KML layer applied. Use this URL to link to or embed an interactive solar system map in your webpage.

Examples:

Change Notice (Jan 2015): Old map URLs containing "maps.google.com" with custom KML layer are no longer supported. Please change any existing old map URLs to the new map page URL.

The KML Page - SolarSystem.kml.php

This KML URL generates a KML file with the planet orbits to be applied to a map. You may reference this URL live or use it to download a KML file that you keep.

Examples:

Methods of Linking and Embedding

Here are some ways you can make your web page link to or embed an interactive map of your solar system model.

Method 1: Your web page may simply link to the Solar System Scale Model Calculator main page (SolarSystemModel.php), with the scale, location, and options preset as you choose. You can use table=y/n and map=y/n options to set whether it initially shows the table, the map, or both. The main page gives the user the freedom to explore and change the scale, location, and options.

HTML example:

<a href="http://thinkzone.wlonk.com/SS/SolarSystemModel.php?obj=Sun&dia=1m&lat=47.622493&lon=-122.352017&table=n&map=y">Solar System Scale Model Calculator</a>

Method 2: Your web page may link to the Map page (SolarSystemMap.html) with the scale, location, and options set as you choose.

HTML example:

<a href="http://thinkzone.wlonk.com/SS/SolarSystemMap.html?obj=Sun&dia=30ft&lat=47.622493&lon=-122.352017">Solar System Map</a>

Method 3: Your web page may embed (for example, with iframe) the Map page (SolarSystemMap.html) with the scale, location, and options set as you choose.

HTML example:

<iframe width="500" height="500" src="http://thinkzone.wlonk.com/SS/SolarSystemMap.html?obj=Sun&dia=30ft&lat=47.622493&lon=-122.352017"></iframe>

Method 4: Your web page may create your own customizable map (with Google Maps API) and apply the Thinkzone KML layer with a live reference to the Thinkzone KML page (SolarSystem.kml.php) with the scale, location, and options set as you choose.

JavaScript example:

var map = new google.maps.Map(document.getElementById('map-canvas'), {});
var kmlUrl = "http://thinkzone.wlonk.com/SS/SolarSystemMap.html?obj=Sun&dia=30ft&lat=47.622493&lon=-122.352017";
var kmlLayer = new google.maps.KmlLayer(kmlUrl, {});
kmlLayer.setMap(map);

Method 5: Your web page may create your own customizable map (with Google Maps API) and apply the Thinkzone KML layer from a local copy of the KML file that you downloaded from the Thinkzone KML page (SolarSystem.kml.php) with the scale, location, and options set as you choose.

JavaScript example:

var map = new google.maps.Map(document.getElementById('map-canvas'), {});
var kmlUrl = "http://mywebsite/mySolarSystemModel.kml";
var kmlLayer = new google.maps.KmlLayer(kmlUrl, {});
kmlLayer.setMap(map);

Terms of Use - KML

You may use (and modify) the downloaded Solar System Model KML files without restriction. The KML files are internally marked as created by thinkzone.wlonk.com, Keith Enevoldsen, with No Rights Reserved (Creative Commons CC0).