A classe javax.microedition.location (J2ME)

04/09/2006

1

A julgar pela quantidade de pessoas que utilizam telefones celulares em escritórios, na rua e em vários lugares públicos, é certo afirmar que a tecnologia sem fio já tem seu lugar no mainstream (SUN MICROSYSTEMS) e como as aplicações LBS logo serão destaques no mundo wireless e a J2ME é ideal para tornar-se um padrão para o desenvolvimento desse tipo de aplicação, pois fornece um conjunto de classes e funcionalidades voltadas para esse fim.

Direcionada para a implementação de LBS, foi desenvolvida a Location (javax.microedition.location) API for J2ME (Java Specification Request #179 - JSR-179), que é uma tentativa da indústria de padronização de uma única API que possibilita obter de dados de localização de um DM independente do método de localização.

Índice de Classes

Interfaces
LocationListener
O LocationListener representa um ouvinte que receba os eventos associados com um LocationProvider particular.

ProximityListener
Esta relação representa um ouvinte aos eventos associados com detectar a proximidade a algumas coordenadas registadas.

Classes

AddressInfo
public AddressInfo()
A classe de AddressInfo prende a informação textual do endereço sobre uma posição.
Coordinates
public Coordinates(double latitude, double longitude, float altitude)
A classe das coordenadas representa coordenadas como valores da latitude-longitude-altura.
Criteria
public Criteria()
Os critérios usados para a seleção do fornecedor da posição são definidos pelos valores nesta classe.
Landmark
public Landmark(java.lang.String name, java.lang.String description, javax.microedition.location.QualifiedCoordinates coordinates, javax.microedition.location.AddressInfo addressInfo)
A classe do marco representa um marco, isto é uma posição conhecida com um nome.
LandmarkStore
A classe de LandmarkStore fornece métodos à loja, supressão e recupera marcos de uma loja persistente do marco.
Location
A classe da posição representa o jogo padrão da informação básica da posição.
LocationProvider
Este é o ponto começar para aplicações usando este API e representa uma fonte da informação da posição.
Orientation
A classe da orientação representa a orientação física do terminal.
QualifiedCoordinates
A classe de QualifiedCoordinates representa coordenadas porque os valores da latitude-longitude-altura que são associados com um valor da exatidão.

Exceptions

LandmarkException
É jogado quando um erro relacionado a segurar marcos ocorreu.
LocationException
É jogado quando um erro específico do API da posição ocorreu.

Detalhamento
1. AddressInfo

Método
getField(int)
public java.lang.String getField(int field)
Parâmetros: field – é o ID do campo a ser recuperado

setField(int, String)
public void setField(int field, java.lang.String value)
Parâmetros: field – é o ID do campo a ser ajustado; value – é o valor do novo ID.

2. Coordinates

Método
azimuthTo(Coordinates)
public float azimuthTo(javax.microedition.location.Coordinates to)
Parâmetros: to – são as coordenadas do destino;

convert(double, int)
public static java.lang.String convert(double coordinate, int outputType)
Parâmetros: coordinate – uma representação double de uma coordenada; outputType - o identificador do tipo da respresentação int para a saída constante

convert(String)
public static double convert(java.lang.String coordinate)
Parâmetros: coordinates – coordenadas em qualquer uma da representações especificadas acima

distance(Coordinates)
public float distance(javax.microedition.location.Coordinates to)
Parâmetros: to - as coordenadas do destino

getAltitude()
public float getAltitude()
Retorno: a altura nos medidores acima do ellipsoid da referência.

getLatitude()
public double getLatitude()
Retorno: o componente da latitude desta coordenada dada na referência WGS84

getLongitude()
public double getLongitude()
Retorno: o componente da longitudedesta coordenada dada na referência WGS84

setLatitude(double)
public void setLatitude(double latitude)
Parâmetros: latitude - o componente da latitude desta posição nos graus. Escala válida: [- 90.0, 90.0].

setLongitude(double)
public void setLongitude(double longitude)
Parâmetros: longitude - a longitude da posição nos graus. Escala válida: [- 180.0, 180.0)

3. Criteria

Metodos
getHorizontalAccuracy()
public int getHorizontalAccuracy()
Retorna de valor horizontal da exatidão neste critério.

getPreferredPowerConsumption()
public int getPreferredPowerConsumption()
Retorna o consumo de potência preferido.
Retorno: o nível do consumo de potência, deve ser: NO_REQUIREMENT, POWER_USAGE_LOW, POWER_USAGE_MEDIUM, POWER_USAGE_HIGH.

getPreferredResponseTime()
public int getPreferredResponseTime()
Retorno: o tempo de resposta máximo preferido.

getVerticalAccuracy()
public int getVerticalAccuracy()
Retorno: o valor vertical da exatidão neste critérios.

isAddressInfoRequired()
public boolean isAddressInfoRequired()
Retorno: se o fornecedor da posição deve fornecer normalmente textual dirigem-se à informação. Retificar meios que deve ser meios capazes, falsos que este não está requerido.

isAllowedToCost()
public boolean isAllowedToCost()
Retorno: o ajuste preferido do custo. Retificar se reservado para custo, falso se dever estar livre da carga.

isAltitudeRequired()
public boolean isAltitudeRequired()
Retorno: se o fornecedor da posição deve determinam a altura. Retificar meios que deve ser capazes, falsos que este não está requerido.

isSpeedAndCourseRequired()
public boolean isSpeedAndCourseRequired()
Retorna se o fornecedor da posição deve determinar a velocidade e o curso.
Retorno: se o fornecedor da posição deve determinam a velocidade e o curso. retificar meios que deve ser capazes, falsos que este não está requerido.

setAddressInfoRequired(boolean)
public void setAddressInfoRequired(boolean addressInfoRequired)
Parâmetros: addressInfoRequired - se o jogo para rectificar, o LocationProvider fosse requerido determinasse normalmente a informação textual do endereço. se ajustado o falso, a informação textual do endereço não é requerido.

setAltitudeRequired(boolean)
public void setAltitudeRequired(boolean altitudeRequired)
Parâmetros: altitudeRequired - se o jogo para rectificar, o LocationProvider fosse requerido determinasse normalmente a altura se ajustado o falso, a altura não fosse requerido.

setCostAllowed(boolean)
public void setCostAllowed(boolean costAllowed)
Parâmetros: costAllowed - falso se a determinação da posição não fosse permitida cobrar, verdadeiro se fosse permitido cobrar

setHorizontalAccuracy(int)
public void setHorizontalAccuracy(int accuracy)
Parâmetros: accuracy - a exatidão horizontal definida nos medidores

setVerticalAccuracy(int)
public void setVerticalAccuracy(int accuracy)
Parâmetros: accuracy - a exatidão vertical preferida nos medidores

setPreferredPowerConsumption(int)
public void setPreferredPowerConsumption(int level)
Parâmetros: level - o nível máximo preferido do consumo de potência. Deve ser: NO_REQUIREMENT, POWER_USAGE_LOW, POWER_USAGE_MEDIUM, POWER_USAGE_HIGH.

setPreferredResponseTime(int)
public void setPreferredResponseTime(int time)
Parâmetros: time - o valor definido do confiante e de intervalo de parada do tempo em milissegundos

setSpeedAndCourseRequired(boolean)
public void setSpeedAndCourseRequired(boolean speedAndCourseRequired)
Parâmetros: speedAndCourseRequired - se verdadeiro, o LocationProvider fosse requerido determinasse normalmente a velocidade e o curso. se ajustado falso, a velocidade e o curso não são requeridos.

4. Landmark
LandmarkStore

Metodos
getAddressInfo()
public javax.microedition.location.AddressInfo getAddressInfo()
Retorna as informações do endereço do marco.

getAddressInfo()
public javax.microedition.location.AddressInfo getAddressInfo()
Retorno: as informações do endereço do marco.

getDescription()
public java.lang.String getDescription()
Retorno: a descrição do marco.

getName()
public java.lang.String getName()
Retorno: o nome do marco.

public void setQualifiedCoordinates(javax.microedition.location.QualifiedCoordinates coordinates)
Parâmetros: coordinates - as coordenadas qualificadas do marco

setAddressInfo(AddressInfo)
public void setAddressInfo(javax.microedition.location.AddressInfo addressInfo)
Parâmetros: addressInfo – informações de endereço do marco
setDescription(String)

setDescription
public void setDescription(java.lang.String description)
Parâmetros: description - a descrição para o marco, zero pode ser passada dentro para indicar que a descrição não está disponível.

setName(String)
public void setName(java.lang.String name)
Parâmetros: name - nome para o marco
setQualifiedCoordinates(QualifiedCoordinates)

5. Location

Metodos
getAddressInfo()
public javax.microedition.location.AddressInfo getAddressInfo()
Retornos: um AddressInfo associou com este objeto da posição

getCourse()
public float getCourse()
Retorno: o curso do terminal fêz bom no norte verdadeiro relative to dos graus ou no Float.NaN se o curso não fosse sabido

getExtraInfo(String)
public java.lang.String getExtraInfo(java.lang.String mimetype)
Retorno: info extra sobre a posição.
Paramêtro: mimetype - tipo de método usado para localização

getLocationMethod()
public int getLocationMethod()
Retorno: um campo de bit que identifica o método usado da posição

getQualifiedCoordinates()
public javax.microedition.location.QualifiedCoordinates getQualifiedCoordinates()
Retorno: as coordenadas desta posição e de sua exatidão.

getSpeed()
public float getSpeed()
Retorno: a velocidade à terra atual em m/s para o terminal ou o Float.NaN se a velocidade não for sabida

getTimestamp()
public long getTimestamp()
Retorno: um timestamp que representa o tempo que System.currentTimeMillis() recupera

isValid()
public boolean isValid()
Retorno: um valor booleano com verdadeiro indicando que este exemplo da posição é válido e falso indicando um exemplo inválido da posição


Responder

Posts

04/09/2006

Liclopes

6. LocationProvider

Métodos
addProximityListener(ProximityListener, Coordinates, float)
public static void addProximityListener(javax.microedition.location.ProximityListener listener, javax.microedition.location.Coordinates coordinates, float proximityRadius) throws LocationException
Parâmetros: criteria - os critérios para que a seleção ou o zero do fornecedor indique menos critérios restritivos com os valores de defeito Retornos: um LocationProvider que encontra-se com os critérios ou o zero definido se um LocationProvider que se encontre com os critérios definidos não puder ser retornado mas lá for outro os fornecedores disponíveis ou temporariamente unavailable suportados que não se encontram com os critérios.

getLastKnownLocation()
public static javax.microedition.location.Location getLastKnownLocation()
Retorno: um objeto da posição. o zero é retornado se a execução não tiver nenhuma informação precedente da posição.

getLocation()
Parâmetros: timeout - um valor de intervalo de parada nos segundos. -1 é usado indicar que a execução usará seu valor de intervalo de parada do defeito para este fornecedor.
Retorno: um objeto da posição

getState()
public abstract int getState()
Retorno: o estado da disponibilidade deste LocationProvider
removeProximityListener(ProximityListener)

public static void removeProximityListener(javax.microedition.location.ProximityListener listener)
Parâmetro: listener - ouvinte a remover

reset()
public abstract void reset()

setLocationListener(LocationListener, int, int, int)
public abstract void setLocationListener(javax.microedition.location.LocationListener listener, int interval, int timeout, int maxAge)
Parâmetros: listener - ouvinte a ser registado. Se o jogo para anular o registo do ouvinte previamente ajustado for cancelado; interval - o intervalo nos segundos. -1 é usado para o intervalo do defeito deste fornecedor. 0 são usados indicar que a aplicação quer receber - somente updates do status do fornecedor e não updates da posição em tudo; timeout - o valor de intervalo de parada nos segundos, deve ser mais grande de 0. se o valor for -1, o intervalo de parada do defeito para este fornecedor são usados. Também, se o intervalo for -1 para indicar o defeito, o valor deste parâmetro não tem nenhum efeito e o intervalo de parada do defeito para este fornecedor é usado. Se o == -1 do intervalo de parada e o intervalo > 0 e o intervalo de parada do defeito do fornecedor forem mais grandes do que o intervalo especificado, o parâmetro do intervalo de parada está segurado então como se a aplicação tinha passado o mesmo valor que intervalo de parada como o intervalo (isto é o intervalo de parada é considerado ser igual ao intervalo). Se o intervalo for 0, este parâmetro não tem nenhum efeito; o maxAge - idade máxima da posição retornada nos segundos, deve ser mais grande de 0 ou igual a -1 para indicar que a idade máxima do defeito para este fornecedor está usada. Também, se o intervalo for -1 para indicar o defeito, o valor deste parâmetro não tem nenhum efeito e a idade máxima do defeito para este fornecedor é usada. Se o == -1 do maxAge e intervalo > 0 e a idade máxima do defeito do fornecedor for mais grande do que o intervalo especificado, a seguir o parâmetro do maxAge está segurado como se a aplicação tinha passado o mesmo valor que maxAge como o intervalo (isto é o maxAge é considerado ser igual ao intervalo). Se o intervalo for 0, este parâmetro não tem nenhum efeito.

7. Orientation

Métodos
getCompassAzimuth()
public float getCompassAzimuth()
Retorno: o azimuth do compasso do terminal no norte verdadeiro dos graus ou magnético relativo

getOrientation()
public static javax.microedition.location.Orientation getOrientation() throws LocationException
Retorno: retorna um objeto da orientação que contem a orientação atual ou o zero do terminal se a orientação não puder atualmente ser determinada

getPitch()
public float getPitch()
Retorno: o passo do terminal nos graus ou no Float.NaN se nao disponível

getRoll()
public float getRoll()

Retorno: o rolo do terminal nos graus ou no Float.NaN se nao disponível
isOrientationMagnetic()
public boolean isOrientationMagnetic()
Retorno: retificar se esta orientação for relativo ao campo magnético da terra; falso se esta orientação for norte e gravidade verdadeiros relativo a gravidade

8. ProximityListener

Métodos
monitoringStateChanged(boolean)
public void monitoringStateChanged(boolean isMonitoringActive)
Parâmetros: isMonitoringActive - um booleano indicando o estado novo da monitoração da proximidade. verdadeiro indica que a monitoração da proximidade é ativa e falso indica que a monitoração da proximidade não pode ser feita atualmente.

proximityEvent(Coordinates, Location)
public void proximityEvent(javax.microedition.location.Coordinates coordinates, javax.microedition.location.Location location)
Parâmetros: coordinates - as coordenadas registadas a que a proximidade foi detectada; location - a posição atual do terminal

9. QualifiedCoordinates

Métodos
getHorizontalAccuracy()
public float getHorizontalAccuracy()
Retornos: a exatidão horizontal nos medidores. Float.NaN se isto não for sabido

getVerticalAccuracy()
public float getVerticalAccuracy()
Retornos: a exatidão vertical nos medidores. Float.NaN se isto não for sabido.

setHorizontalAccuracy(float)
public void setHorizontalAccuracy(float horizontalAccuracy)
Parâmetros: horizontalAccuracy - a exatidão horizontal deste resultado da posição nos medidores. Float.NaN significa que a exatidão horizontal não poderia ser determinada. Deve ser mais grande ou igual a 0.

setVerticalAccuracy(float)
public void setVerticalAccuracy(float verticalAccuracy)
Parâmetros: verticalAccuracy - a exatidão vertical deste resultado da posição nos medidores. Float.NaN significa que a exatidão horizontal não poderia ser determinada. Deve ser mais grande ou igual a 0.

Abraço, Elias.Lôgan-X


Responder

08/09/2006

Liclopes

[img:451e45996a]http://www.devmedia.com.br/imagens/webmobile/out2005/Java1.gif[/img:451e45996a]


Responder