GoogleMapsApi

A public-surface API that exposes the Google Maps API functionality.

Determines the maximum number of concurrent HTTP connections to open to this engine's host address. The default value is 2 connections.

This value is determined by the ServicePointManager and is shared across other engines that use the same host address.

Determines the maximum number of concurrent HTTPS connections to open to this engine's host address. The default value is 2 connections.

This value is determined by the ServicePointManager and is shared across other engines that use the same host address.

Occurs when the Url created. Can be used for override the Url.

Occurs when raw data from Google API recivied.

Query the Google Maps API using the provided request with the default timeout of 100,000 milliseconds (100 seconds).

The request that will be sent. The response that was received. Thrown when a null value is passed to the request parameter. Thrown when the provided Google client ID or signing key are invalid. Thrown when the operation has exceeded the allotted time. Thrown when an error occurred while downloading data.

Query the Google Maps API using the provided request and timeout period.

The request that will be sent. A TimeSpan specifying the amount of time to wait for a response before aborting the request. The specify an infinite timeout, pass a TimeSpan with a TotalMillisecond value of Timeout.Infinite. When a request is aborted due to a timeout an AggregateException will be thrown with an InnerException of type TimeoutException. The response that was received. Thrown when a null value is passed to the request parameter. Thrown when the provided Google client ID or signing key are invalid. Thrown when the operation has exceeded the allotted time. Thrown when an error occurred while downloading data.

Asynchronously query the Google Maps API using the provided request.

The request that will be sent. A Task with the future value of the response. Thrown when a null value is passed to the request parameter.

Asynchronously query the Google Maps API using the provided request.

The request that will be sent. A TimeSpan specifying the amount of time to wait for a response before aborting the request. The specify an infinite timeout, pass a TimeSpan with a TotalMillisecond value of Timeout.Infinite. When a request is aborted due to a timeout the returned task will transition to the Faulted state with a TimeoutException. A Task with the future value of the response. Thrown when a null value is passed to the request parameter. Thrown when the value of timeout is neither a positive value or infinite.

Asynchronously query the Google Maps API using the provided request.

The request that will be sent. A cancellation token that can be used to cancel the pending asynchronous task. A Task with the future value of the response. Thrown when a null value is passed to the request parameter.

Asynchronously query the Google Maps API using the provided request.

The request that will be sent. A TimeSpan specifying the amount of time to wait for a response before aborting the request. The specify an infinite timeout, pass a TimeSpan with a TotalMillisecond value of Timeout.Infinite. When a request is aborted due to a timeout the returned task will transition to the Faulted state with a TimeoutException. A cancellation token that can be used to cancel the pending asynchronous task. A Task with the future value of the response. Thrown when a null value is passed to the request parameter. Thrown when the value of timeout is neither a positive value or infinite.

Determines the maximum number of concurrent HTTP connections to open to this engine's host address. The default value is 2 connections.

This value is determined by the ServicePointManager and is shared across other engines that use the same host address.

Determines the maximum number of concurrent HTTPS connections to open to this engine's host address. The default value is 2 connections.

This value is determined by the ServicePointManager and is shared across other engines that use the same host address.

Converts a DateTime to a Unix timestamp

True to indicate that request comes from a device with a location sensor, otherwise false. This information is required by Google and does not affect the results.

It is unclear if Google refers to the device performing the request or the source of the location data. In the geocoding API reference at https://developers.google.com/maps/documentation/geocoding/ the definition is: sensor (required) — Indicates whether or not the geocoding request comes from a device with a location sensor. This implies that only mobile devices that are equipped with a location sensor (such as GPS) should set the Sensor value to True. So if a location is sent to a web server which then calls the Google API, it apparently should set the Sensor value to false, since the web server isn't a location sensor equipped device. In another page of their documentation, https://developers.google.com/maps/documentation/javascript/tutorial they say: The sensor parameter of the URL must be included, and indicates whether this application uses a sensor (such as a GPS locator) to determine the user's location. This implies something completely different, that the Sensor value must be set to true if the source of the location information is a sensor or not, regardless if the request is being performed by a location sensor equipped device or not.

True to use use the https protocol; false to use http. The default is false.

Your application's API key. This key identifies your application for purposes of quota management and so that Places added from your application are made immediately available to your app. Visit the APIs Console to create an API Project and obtain your key.

Place Photo.

PhotoReference — a string used to identify the photo when you perform a Photo request.

Height — the maximum height of the image.

Width — the maximum width of the image.

HtmlAttributions — contains any required attributions. This field will always be present, but may be empty.

An abstract base class for requests that can be authenticated via URL signing.

See https://developers.google.com/maps/documentation/business/webservices for details about signing.

The client ID provided to you by Google Enterprise Support, or null to disable URL signing. All client IDs begin with a "gme-" prefix.

A cryptographic signing key (secret shared key), in base64url format, provided to you by Google Enterprise Support. The key will only be used if the ClientID property is set, otherwise it will be ignored.

This cryptographic signing key is not the same as the (freely available) Maps API key (typically beginning with 'ABQ..') that developers without a Maps API for Business license are required to use when loading the Maps JavaScript API V2 and Maps API for Flash, or the keys issued by the Google APIs Console for use with the Google Places API. Based on the C# sample from: https://developers.google.com/maps/documentation/business/webservices

origin (Required) - The address or textual latitude/longitude value from which you wish to calculate directions. If you pass an address as a string, the Directions service will geocode the string and convert it to a latitude/longitude coordinate to calculate directions. If you pass coordinates, ensure that no space exists between the latitude and longitude values.

destination (required) — The address or textual latitude/longitude value from which you wish to calculate directions. If you pass an address as a string, the Directions service will geocode the string and convert it to a latitude/longitude coordinate to calculate directions. If you pass coordinates, ensure that no space exists between the latitude and longitude values.

The time of departure. Required when TravelMode = Transit

The time of arrival. Required when TravelMode = Transit

waypoints (optional) specifies an array of waypoints. Waypoints alter a route by routing it through the specified location(s). A waypoint is specified as either a latitude/longitude coordinate or as an address which will be geocoded. (For more information on waypoints, see Using Waypoints in Routes below.)

optimize the provided route by rearranging the waypoints in a more efficient order. (This optimization is an application of the Travelling Salesman Problem.) http://en.wikipedia.org/wiki/Travelling_salesman_problem

alternatives (optional), if set to true, specifies that the Directions service may provide more than one route alternative in the response. Note that providing route alternatives may increase the response time from the server.

avoid (optional) indicates that the calculated route(s) should avoid the indicated features. Currently, this parameter supports the following two arguments: tolls indicates that the calculated route should avoid toll roads/bridges. highways indicates that the calculated route should avoid highways. (For more information see Route Restrictions below.)

language (optional) — The language in which to return results. See the supported list of domain languages. Note that we often update supported languages so this list may not be exhaustive. If language is not supplied, the Directions service will attempt to use the native language of the browser wherever possible. You may also explicitly bias the results by using localized domains of http://map.google.com. See Region Biasing for more information.

(optional, defaults to driving) — specifies what mode of transport to use when calculating directions. Valid values are specified in Travel Modes.

This parameter takes a region code, specified as a IANA language region subtag (http://www.iana.org/assignments/language-subtag-registry/language-subtag-registry). In most cases, these tags map directly to familiar ccTLD ("top-level domain") two-character values such as "uk" in "co.uk" for example. In some cases, the region tag also supports ISO-3166-1 codes, which sometimes differ from ccTLD values ("GB" for "Great Britain" for example).

Error message recived from the server when the call fails

Error message

"status" contains metadata on the request. See Status Codes below.

"routes" contains an array of routes from the origin to the destination. See Routes below.

value indicates the distance in meters

text contains a human-readable representation of the distance, displayed in units as used at the origin, in the language specified in the request. (For example, miles and feet will be used for any origin within the United States.) Note that regardless of what unit system is displayed as text, the distance.value field always contains a value expressed in meters.

duration indicates the total duration of this leg These fields may be absent if the duration is unknown.

value indicates the duration in seconds.

text contains a human-readable representation of the duration.

Each element in the legs array specifies a single leg of the journey from the origin to the destination in the calculated route. For routes that contain no waypoints, the route will consist of a single "leg," but for routes that define one or more waypoints, the route will consist of one or more legs, corresponding to the specific legs of the journey.

steps[] contains an array of steps denoting information about each separate step of the leg of the journey. (See Directions Steps below.)

distance indicates the total distance covered by this leg

duration indicates the total duration of this leg,

duration_in_traffic indicates the total duration of this leg. This value is an estimate of the time in traffic based on current and historical traffic conditions.

start_location contains the latitude/longitude coordinates of the origin of this leg. Because the Directions API calculates directions between locations by using the nearest transportation option (usually a road) at the start and end points, start_location may be different than the provided origin of this leg if, for example, a road is not near the origin.

end_location contains the latitude/longitude coordinates of the given destination of this leg. Because the Directions API calculates directions between locations by using the nearest transportation option (usually a road) at the start and end points, end_location may be different than the provided destination of this leg if, for example, a road is not near the destination.

start_address contains the human-readable address (typically a street address) reflecting the start_location of this leg.

end_addresss contains the human-readable address (typically a street address) reflecting the end_location of this leg.

The time of arrival. Only avaliable when using TravelMode = Transit

The time of departure. Only avaliable when using TravelMode = Transit

Contains the full name of this transit line. eg. "7 Avenue Express".

Contains the short name of this transit line. This will normally be a line number, such as "M7" or "355".

Contains the color commonly used in signage for this transit line. The color will be specified as a hex string such as: #FF0033.

Contains a List of TransitAgency objects that each provide information about the operator of the line.

Contains the URL for this transit line as provided by the transit agency.

Contains the URL for the icon associated with this line.

Contains the color of text commonly used for signage of this line. The color will be specified as a hex string.

Contains the type of vehicle used on this line.

Contains the encoded and decoded data returned in the overview_polyline field.

The encoded string containing the overview path points as they were received.

An array of Location objects representing the points in the overview path, decoded from the string contained in the EncodedPoints property.

Unexpectedly couldn't decode points

The RAW data of points from Google

When the Directions API returns results, it places them within a (JSON) routes array. Even if the service returns no results (such as if the origin and/or destination doesn't exist) it still returns an empty routes array. (XML responses consist of zero or more route elements.) Each element of the routes array contains a single result from the specified origin and destination. This route may consist of one or more legs depending on whether any waypoints were specified. As well, the route also contains copyright and warning information which must be displayed to the user in addition to the routing information.

summary contains a short textual description for the route, suitable for naming and disambiguating the route from alternatives.

bounds (optionally returned) contains the viewport bounding box of the overview_polyline.

legs[] contains an array which contains information about a leg of the route, between two locations within the given route. A separate leg will be present for each waypoint or destination specified. (A route with no waypoints will contain exactly one leg within the legs array.) Each leg consists of a series of steps. (See Directions Legs below.)

waypoint_order contains an array indicating the order of any waypoints in the calculated route. This waypoints may be reordered if the request was passed optimize:true within its waypoints parameter.

overview_path contains an object holding an array of encoded points and levels that represent an approximate (smoothed) path of the resulting directions.

copyrights contains the copyrights text to be displayed for this route. You must handle and display this information yourself.

warnings[] contains an array of warnings to be displayed when showing these directions. You must handle and display these warnings yourself.

Each element in the steps array defines a single step of the calculated directions. A step is the most atomic unit of a direction's route, containing a single step describing a specific, single instruction on the journey. E.g. "Turn left at W. 4th St." The step not only describes the instruction but also contains distance and duration information relating to how this step relates to the following step. For example, a step denoted as "Merge onto I-80 West" may contain a duration of "37 miles" and "40 minutes," indicating that the next step is 37 miles/40 minutes from this step.

html_instructions contains formatted instructions for this step, presented as an HTML text string.

Contains an object holding an array of encoded points that represent an approximate (smoothed) path of the resulting directions.

distance contains the distance covered by this step until the next step. (See the discussion of this field in Directions Legs above.) This field may be undefined if the distance is unknown.

duration contains the typical time required to perform the step, until the next step (See the description in Directions Legs above.) This field may be undefined if the duration is unknown.

start_location contains the location of the starting point of this step, as a single set of lat and lng fields.

end_location contains the location of the starting point of this step, as a single set of lat and lng fields.

More information about the step. Only avaliable when TravelMode = Transit

Contains detailed directions for walking or driving steps in transit directions. Substeps are only available when TravelMode is set to Transit. * NOTE : Google documentations states that it should be 'sub_steps' but implemented as 'steps' so we use the actual implementation

Gets the mode of transportation used in this step

Contains information about the stop/station for this part of the trip

The name of the transit station/stop. eg. "Union Square".

The location of the transit station/stop, represented as lattitude and longitude.

Information about the transit agency. Note: You must display the names and URLs of the transit agencies servicing the trip results.

Contains the name of the transit agency.

Contains the URL for the transit agency.

Contains the phone number of the transit agency.

Contains information about the stop/station for this part of the trip

Contains information about the stop/station for this part of the trip.

Contain the arrival times for this leg of the journey

Contain the departure times for this leg of the journey

Specifies the direction in which to travel on this line, as it is marked on the vehicle or at the departure stop. This will often be the terminus station.

Specifies the expected number of seconds between departures from the same stop at this time. For example, with a headway value of 600, you would expect a ten minute wait if you should miss your bus.

Contains the number of stops in this step, counting the arrival stop, but not the departure stop. For example, if your directions involve leaving from Stop A, passing through stops B and C, and arriving at stop D, num_stops will return 3.

Contains information about the transit line used in this step.

Contains the name of the vehicle on this line. eg. "Subway."

Contains the type of vehicle that runs on this line.

Contains the URL for an icon associated with this vehicle type.

Contains the URL for a localized icon associated with this vehicle type.

All other vehicles will return this type.

Rail.

Light rail transit.

Underground light rail.

Above ground light rail.

Monorail.

Heavy rail.

Commuter rail.

High speed train.

Bus.

Intercity bus.

Trolleybus.

Share taxi is a kind of bus with the ability to drop off and pick up passengers anywhere on its route.

Ferry.

A vehicle that operates on a cable, usually on the ground. Aerial cable cars may be of the type GONDOLA_LIFT.

An aerial cable car.

A vehicle that is pulled up a steep incline by a cable. A Funicular typically consists of two cars, with each car acting as a counterweight for the other.

The desired time of departure.

The desired time of arrival.

traffic_model (defaults to best_guess) — Specifies the assumptions to use when calculating time in traffic. This setting affects the value returned in the duration_in_traffic field in the response, which contains the predicted time in traffic based on historical averages. The traffic_model parameter may only be specified for requests where the travel mode is driving, and where the request includes a departure_time, and only if the request includes an API key or a Google Maps APIs Premium Plan client ID. The available values for this parameter are: - best_guess(default) indicates that the returned duration_in_traffic should be the best estimate of travel time given what is known about both historical traffic conditions and live traffic.Live traffic becomes more important the closer the departure_time is to now. - pessimistic indicates that the returned duration_in_traffic should be longer than the actual travel time on most days, though occasional days with particularly bad traffic conditions may exceed this value. - optimistic indicates that the returned duration_in_traffic should be shorter than the actual travel time on most days, though occasional days with particularly good traffic conditions may be faster than this value.

transit_routing_preference — Specifies preferences for transit requests. Using this parameter, you can bias the options returned, rather than accepting the default best route chosen by the API. This parameter may only be specified for requests where the mode is transit. The parameter supports the following arguments: - less_walking indicates that the calculated route should prefer limited amounts of walking. - fewer_transfers indicates that the calculated route should prefer a limited number of transfers.

transit_mode — Specifies one or more preferred modes of transit. This parameter may only be specified for requests where the mode is transit. The parameter supports the following arguments: - bus indicates that the calculated route should prefer travel by bus. - subway indicates that the calculated route should prefer travel by subway. - train indicates that the calculated route should prefer travel by train. - tram indicates that the calculated route should prefer travel by tram and light rail. - rail indicates that the calculated route should prefer travel by train, tram, light rail, and subway. This is equivalent to transit_mode= train | tram | subway.

Distances may be calculated that adhere to certain restrictions. Restrictions are indicated by use of the avoid parameter, and an argument to that parameter indicating the restriction to avoid. The following restrictions are supported: tolls, highways, ferries indoor * Note: the addition of restrictions does not preclude routes that include the restricted feature; it simply biases the result to more favorable routes.

Distance Matrix results contain text within distance fields to indicate the distance of the calculated route. The unit system to use can be specified: - metric(default) returns distances in kilometers and meters. - imperial returns distances in miles and feet. * Note: this unit system setting only affects the text displayed within distance fields.The distance fields also contain values which are always expressed in meters.

value indicates the distance in meters

"status" contains metadata on the request. See Status Codes below.

duration indicates the total duration of this leg These fields may be absent if the duration is unknown.

value indicates the duration in seconds.

text contains a human-readable representation of the duration.

"status" See Status Codes for a list of possible status codes.

distance: The total distance of this route, expressed in meters (value) and as text

duration: The length of time it takes to travel this route

duration_in_traffic The length of time it takes to travel this route, based on current and historical traffic conditions. See the traffic_model request parameter for the options you can use to request that the returned value is optimistic, pessimistic, or a best-guess estimate.

element[] The information about each origin-destination pairing is returned in an element entry

The Elevation API provides elevation data for all locations on the surface of the earth, including depth locations on the ocean floor (which return negative values). In those cases where Google does not possess exact elevation measurements at the precise location you request, the service will interpolate and return an averaged value using the four nearest locations. With the Elevation API, you can develop hiking and biking applications, mobile positioning applications, or low resolution surveying applications. You access the Elevation API through an HTTP interface Users of the Google JavaScript API V3 may also access this API directly by using the ElevationService() object. (See Elevation Service for more information.) The Elevation API is a new service; we encourage you to join the Maps API discussion group to give us feedback.

locations (required) defines the location(s) on the earth from which to return elevation data. This parameter takes either a single location as a comma-separated {latitude,longitude} pair (e.g. "40.714728,-73.998672") or multiple latitude/longitude pairs passed as an array or as an encoded polyline. For more information, see Specifying Locations below.

A location element (containing lat and lng elements) of the position for which elevation data is being computed. Note that for path requests, the set of location elements will contain the sampled points along the path.

An elevation element indicating the elevation of the location in meters.

matches long or short name of a route.

matches against both locality and sublocality types.

matches all the administrative_area levels.

matches postal_code and postal_code_prefix.

matches a country name or a two letter ISO 3166-1 country code.

address (required) — The address that you want to geocode.*

latlng (required) — The textual latitude/longitude value for which you wish to obtain the closest, human-readable address.* If you pass a latlng, the geocoder performs what is known as a reverse geocode. See Reverse Geocoding for more information.

bounds (optional) — The bounding box of the viewport within which to bias geocode results more prominently. (For more information see Viewport Biasing below.) The bounds and region parameters will only influence, not fully restrict, results from the geocoder.

region (optional) — The region code, specified as a ccTLD ("top-level domain") two-character value. (For more information see Region Biasing below.) The bounds and region parameters will only influence, not fully restrict, results from the geocoder.

language (optional) — The language in which to return results. See the supported list of domain languages. Note that we often update supported languages so this list may not be exhaustive. If language is not supplied, the geocoder will attempt to use the native language of the domain from which the request is sent wherever possible.

A component filter for which you wish to obtain a geocode. The components filter will also be accepted as an optional parameter if an address is provided. See more info: https://developers.google.com/maps/documentation/geocoding/intro#ComponentFiltering

types[] is an array indicating the type of the address component.

short_name is an abbreviated textual name for the address component, if available. For example, an address component for the state of Alaska may have a long_name of "Alaska" and a short_name of "AK" using the 2-letter postal abbreviation.

long_name is the full text description or name of the address component as returned by the Geocoder.

location contains the geocoded latitude,longitude value. For normal address lookups, this field is typically the most important.

location_type stores additional data about the specified location.

viewport contains the recommended viewport for displaying the returned result, specified as two latitude,longitude values defining the southwest and northeast corner of the viewport bounding box. Generally the viewport is used to frame a result when displaying it to a user.

bounds (optionally returned) stores the bounding box which can fully contain the returned result. Note that these bounds may not match the recommended viewport. (For example, San Francisco includes the Farallon islands, which are technically part of the city, but probably should not be returned in the viewport.)

Indicates that the returned result is a precise geocode for which we have location information accurate down to street address precision.

Indicates that the returned result reflects an approximation (usually on a road) interpolated between two precise points (such as intersections). Interpolated results are generally returned when rooftop geocodes are unavailable for a street address.

Indicates that the returned result is the geometric center of a result such as a polyline (for example, a street) or polygon (region).

Indicates that the returned result is approximate.

When the geocoder returns results, it places them within a (JSON) results array. Even if the geocoder returns no results (such as if the address doesn't exist) it still returns an empty results array. (XML responses consist of zero or more result elements.)

The types[] array indicates the type of the returned result. This array contains a set of one or more tags identifying the type of feature returned in the result. For example, a geocode of "Chicago" returns "locality" which indicates that "Chicago" is a city, and also returns "political" which indicates it is a political entity.

formatted_address is a string containing the human-readable address of this location. Often this address is equivalent to the "postal address," which sometimes differs from country to country. (Note that some countries, such as the United Kingdom, do not allow distribution of true postal addresses due to licensing restrictions.) This address is generally composed of one or more address components. For example, the address "111 8th Avenue, New York, NY" contains separate address components for "111" (the street number, "8th Avenue" (the route), "New York" (the city) and "NY" (the US state). These address components contain additional information as noted below.

address_components[] is an array containing the separate address components

geometry contains information such as latitude, longitude, location_type, viewport, bounds

indicates that the geocoder did not return an exact match for the original request, though it did match part of the requested address. You may wish to examine the original request for misspellings and/or an incomplete address. Partial matches most often occur for street addresses that do not exist within the locality you pass in the request.

provides the Google PlaceId

The "status" field within the Geocoding response object contains the status of the request, and may contain debugging information to help you track down why Geocoding is not working. The "status" field may contain the following values:

Indicates that no errors occurred; the address was successfully parsed and at least one geocode was returned.

Indicates that the geocode was successful but returned no results. This may occur if the geocode was passed a non-existent address or a latlng in a remote location.

Indicates that you are over your quota.

Indicates that your request was denied, generally because of lack of a sensor parameter.

Generally indicates that the query (address or latlng) is missing.

The Place Autocomplete service is a web service that returns place predictions in response to an HTTP request. The request specifies a textual search string and optional geographic bounds. The service can be used to provide autocomplete functionality for text-based geographic searches, by returning places such as businesses, addresses and points of interest as a user types.

Input (required) - the text string on which to search

The position, in the input term, of the last character that the service uses to match predictions (optional). For example, if the input is 'Google' and the offset is 3, the service will match on 'Goo'. The string determined by the offset is matched against the first word in the input term only. For example, if the input term is 'Google abc' and the offset is 3, the service will attempt to match against 'Goo abc'. If no offset is supplied, the service will use the whole term. The offset should generally be set to the position of the text caret.

location (optional) — The textual latitude/longitude value from which you wish to retrieve place information.

Defines the distance (in meters) within which to return Place results (optional). The maximum allowed radius is 50 000 meters. Note that radius must not be included if rankby=distance (described under Optional parameters below) is specified.

The language code, indicating in which language the results should be returned, if possible. See the list of supported languages and their codes. Note that we often update supported languages so this list may not be exhaustive.

(optional) Restricts the results to Places matching the specified type . See the list of supported types - https://developers.google.com/maps/documentation/places/supported_types

A grouping of places to which you would like to restrict your results (optional). Currently, you can use components to filter by country. The country must be passed as a two character, ISO 3166-1 Alpha-2 compatible country code. For example: components=country:fr would restrict your results to places within France.

Describes the location of the entered term in the PlaceAutocomplete result text, so that the term can be highlighted if desired

The start position of this term in the description, measured in Unicode characters

The length of this term in the description, measured in Unicode characters

"status" contains metadata on the request.

"results" contains an array of predictions rather than full results, each including a description and a reference which can be queried further to get the full place details

When the PlaceAutocomplete service returns results from a search, it places them within a predictions array. Even if the service returns no results (such as if the location is remote) it still returns an empty predictions array.

Contains the human-readable name for the returned result. For establishment results, this is usually the business name.

Contains a unique identifier for this place. To retrieve information about this place, pass this identifier in the placeId field of a Places API request.

Contains a unique token that you can use to retrieve additional information about this place in a Place Details request. You can store this token and use it at any time in future to refresh cached data about this place, but the same token is not guaranteed to be returned for any given place across different searches.

Contains a unique stable identifier denoting this place. This identifier may not be used to retrieve information about this place, but can be used to consolidate data about this place, and to verify the identity of a place across separate searches.

Contains an array of terms identifying each section of the returned description (a section of the description is generally terminated with a comma). Each entry in the array has a value field, containing the text of the term, and an offset field, defining the start position of this term in the description, measured in Unicode characters.

Contains an array of types that apply to this place. For example: [ "political", "locality" ] or [ "establishment", "geocode" ].

Contains an offset value and a length. These describe the location of the entered term in the prediction result text, so that the term can be highlighted if desired.

Identifies a section of description in a PlaceAutocomplete search result

The text of the term

The start position of this term in the description, measured in Unicode characters

Event id.

Contains the location

is a boolean value indicating if the Place is open at the current time.

periods[] is an array of opening periods covering seven days, starting from Sunday, in chronological order. Each period contains: open contains a pair of day and time objects describing when the Place opens: day a number from 0–6, corresponding to the days of the week, starting on Sunday. For example, 2 means Tuesday. time may contain a time of day in 24-hour hhmm format. Values are in the range 0000–2359. The time will be reported in the Place’s time zone. close may contain a pair of day and time objects describing when the Place closes. Note: If a Place is always open, the close section will be missing from the response. Clients can rely on always-open being represented as an open period containing day with value 0 and time with value 0000, and no close.

"status" contains metadata on the request.

"results" contains an array of places, with information about the place. See Place Search Results for information about these results. The Places API returns up to 20 establishment results. Additionally, political results may be returned which serve to identify the area of the request.

Event id.

name contains the human-readable name for the returned result. For establishment results, this is usually the canonicalized business name.

Opening hours information

Indicates that no errors occurred; the place was successfully detected and at least one result was returned.

Indicates a server-side error; trying again may be successful.

Indicates that the search was successful but returned no results. This may occur if the search was passed a latlng in a remote location.

Indicates that you are over your quota.

Indicates that your request was denied, generally because of lack of a sensor parameter.

Generally indicates that the query parameter (location or radius) is missing.

Indicates that the referenced location was not found in the Places database.

.net's DayOfWeek follows the same numbering as google (Sunday == 0) therefor a specific conversion step is not needed, the deserializer's direct casting will work. http://msdn.microsoft.com/en-us/library/system.dayofweek.aspx

May contain a time of day in 24-hour hhmm format (values are in the range 0000–2359). The time will be reported in the Place’s timezone.

Didn't make this stronly typed due to .net's lack of an explicit 'Time' class. http://noda-time.blogspot.com.au/2011/08/what-wrong-with-datetime-anyway.html

The Google Places API is a service that returns information about a "place" (hereafter referred to as a Place) — defined within this API as an establishment, a geographic location, or prominent point of interest — using an HTTP request. Place requests specify locations as latitude/longitude coordinates. Two basic Place requests are available: a Place Search request and a Place Details request. Generally, a Place Search request is used to return candidate matches, while a Place Details request returns more specific information about a Place. This service is designed for processing place requests generated by a user for placement of application content on a map; this service is not designed to respond to batch of offline queries, which are a violation of its terms of use.

location (required) — The textual latitude/longitude value from which you wish to retrieve place information.

Defines the distance (in meters) within which to return Place results. The maximum allowed radius is 50 000 meters. Note that radius must not be included if rankby=distance (described under Optional parameters below) is specified.

A term to be matched against all content that Google has indexed for this Place, including but not limited to name, type, and address, as well as customer reviews and other third-party content.

A term to be matched against the names of Places. Results will be restricted to those containing the passed name value.

Specifies the order in which results are listed

Restricts the results to Places matching the specified type. See the list of supported types - https://developers.google.com/maps/documentation/places/supported_types

If there is a next page of results, this token will be supplied by Google in a previous PlacesResponse. PageToken should be set to the previous response value to get the next page of results from Google. When PageToken is set, all other Request parameters are ignored.

Specifies the order in which results are listed

This option sorts results based on their importance. Ranking will favor prominent places within the specified area. Prominence can be affected by a Place's ranking in Google's index, the number of check-ins from your application, global popularity, and other factors.

This option sorts results in ascending order by their distance from the specified location. A radius should not be supplied, and bounds is not supported. One or more of keyword, name, or types is required.

Contains the location

"status" contains metadata on the request.

If there is a next page of results, the token will be supplied by Google. Token should be set on the next PlacesRequest object to get the next page of results from Google. If null is returned, there is no next page of results.

name contains the human-readable name for the returned result. For establishment results, this is usually the canonicalized business name.

The Google Places API Radar Search Service allows you to search for up to 200 places at once, but with less detail than is typically returned from a Text Search or Nearby Search request.

Required. The latitude/longitude around which to retrieve place information. This must be specified as latitude,longitude.

Required. Defines the distance (in meters) within which to return place results. The maximum allowed radius is 50 000 meters.

Optional. A term to be matched against all content that Google has indexed for this place, including but not limited to name, type, and address, as well as customer reviews and other third-party content.

Optional. Restricts results to only those places within the specified price level. Valid values are in the range from 0 (most affordable) to 4 (most expensive), inclusive. The exact amount indicated by a specific value will vary from region to region.

Optional. One or more terms to be matched against the names of places, separated by a space character. Results will be restricted to those containing the passed name values. Note that a place may have additional names associated with it, beyond its listed name. The API will try to match the passed name value against all of these names. As a result, places may be returned in the results whose listed names do not match the search term, but whose associated names do.

Optional. Set to true to only return those places that are open for business at the time the query is sent. Places that do not specify opening hours in the Google Places database will not be returned if you include this parameter in your query.

Optional. Restricts the results to Places matching the specified type. See the list of supported types - https://developers.google.com/maps/documentation/places/supported_types

Contains the location

"status" contains metadata on the request.

Contains the location

"status" contains metadata on the request.

name contains the human-readable name for the returned result. For establishment results, this is usually the canonicalized business name.

location (required) — The textual latitude/longitude value from which you wish to retrieve place information.

A term to be matched against all content that Google has indexed for this Place, including but not limited to name, type, and address, as well as customer reviews and other third-party content.

A term to be matched against the names of Places. Results will be restricted to those containing the passed name value.

Specifies the order in which results are listed

Restricts the results to Places matching the specified type. See the list of supported types - https://developers.google.com/maps/documentation/places/supported_types

Specifies the order in which results are listed

Contains the location

"status" contains metadata on the request.

name contains the human-readable name for the returned result. For establishment results, this is usually the canonicalized business name.

location: a comma-separated lat,lng tuple (eg. location=-33.86,151.20), representing the location to look up

Timestamp specifies the desired time as seconds since midnight, January 1, 1970 UTC. The Time Zone API uses the timestamp to determine whether or not Daylight Savings should be applied. Times before 1970 can be expressed as negative values.

The language in which to return results. See the list of supported domain languages. Note that we often update supported languages so this list may not be exhaustive. Defaults to en

The language in which to return results. See the list of supported domain languages. Note that we often update supported languages so this list may not be exhaustive. Defaults to en.

"status" contains metadata on the request.

DstOffset: the offset for daylight-savings time in seconds. This will be zero if the time zone is not in Daylight Savings Time during the specified timestamp.

RawOffset: the offset from UTC (in seconds) for the given location. This does not take into effect daylight savings.

TimeZoneId: a string containing the ID of the time zone, such as "America/Los_Angeles" or "Australia/Sydney".

TimeZoneName: a string containing the long form name of the time zone. This field will be localized if the language parameter is set. eg. "Pacific Daylight Time" or "Australian.

Perform geocoding operations.

Perform directions operations.

Perform elevation operations.

Perform places operations.

Perform places text search operations.

Perform places radar search operations.

Perform places text search operations.

Perform places details operations.

Perform place autocomplete operations.

Perform near by places operations.

Retrieve duration and distance values based on the recommended route between start and end points.