com.here.mobility.sdk.core.services.timezone

Class TimeZoneClient

java.lang.Object

com.here.mobility.sdk.core.net.ClientBase<TimeZoneNetworkClient>

com.here.mobility.sdk.core.services.timezone.TimeZoneClient

All Implemented Interfaces:

INetworkClient

public final class TimeZoneClient
extends ClientBase<TimeZoneNetworkClient>

The client class that find a timezones for the given location and an optional time for future DST calculation.
Code example:

 		Calendar calendar = Calendar.getInstance(java.util.TimeZone.getTimeZone("UTC"));
 		calendar.set(Calendar.YEAR, year);
 		calendar.set(Calendar.MONTH, month);
 		calendar.set(Calendar.DAY_OF_MONTH, dayOfMonth);
 		calendar.set(Calendar.MINUTE, minute);
 		calendar.set(Calendar.HOUR_OF_DAY, hourOfDay);
 		TimeZoneClient client = TimeZoneClient.newInstance();
 		LatLng location = LatLng.fromDegrees(lat, lng);
 		ResponseFuture<TimeZone> timeZoneFuture = client.findTimeZone(location, calendar.getTimeInMillis());
 		timeZoneFuture.registerListener(new ResponseListener<TimeZone>() {

 			public void onResponse(TimeZone timeZone) {
 				// Use the updated time zone.
 			}

 			public void onError(ResponseException exception) {
 				// Handle errors.
 			}
 		});

 		// Don't forgot call shutdownNow.
 		// client.shutdownNow();
 
 

Field Summary

Fields inherited from class com.here.mobility.sdk.core.net.ClientBase

client

Method Summary

Modifier and Type	Method and Description
ResponseFuture<TimeZone>	findTimeZone(LatLng latLng, Long timeInMillis) Requests a TimeZone for the specified LatLng and an optional time for future DST calculation.
static TimeZoneClient	newInstance() Creates a new TimeZoneClient.

Methods inherited from class com.here.mobility.sdk.core.net.ClientBase

cancelAllActiveRequests, shutdown, shutdownNow

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

newInstance

public static TimeZoneClient newInstance()

Creates a new TimeZoneClient.

findTimeZone

public ResponseFuture<TimeZone> findTimeZone(LatLng latLng,
                                             Long timeInMillis)

Requests a TimeZone for the specified LatLng and an optional time for future DST calculation. This request can throw the following exceptions: HMTimeZoneNotFoundException UserAuthenticationException

Parameters:

latLng - is the request LatLng to find a timezone.

timeInMillis - time in millis without any time zone shifting Can be retrieve by set a Calendar and call Calendar.getTimeInMillis()