GlideGeoPoint - Global

A API GlideGeoPoint permite que você obtenha e defina valores de tipo de dados de geopoint em uma tabela.

A API GlideGeoPoint está disponível por padrão. O tipo de dados de ponto geográfico permite armazenar valores de latitude e longitude em um único campo em uma tabela. Usando a API GlideGeoPoint, você pode instanciar novos objetos GlideGeoPoint, criar novos geopontos para uma tabela específica ou recuperar valores únicos de latitude, longitude ou geotipo. Para obter informações adicionais sobre como implementar casos de uso específicos, como inserir novos registros usando um ponto geográfico, calcular distâncias entre locais de geoponto ou consultar locais de geoponto próximos, consulte Guia do desenvolvedor de GlideGeoPoint.

Os principais aspectos do tipo de dados de geotipo são:

• Ele consiste em um par de números decimais que representam valores de longitude e latitude.
• O intervalo de longitude é (-180, 180]. Qualquer valor fora deste intervalo é normalizado para o valor equivalente dentro deste intervalo.
• O intervalo de latitude é [-90, 90]. Qualquer valor fora deste intervalo é normalizado para o valor equivalente dentro deste intervalo.
• Os valores de geoponto são sempre aceitos como entrada e exibidos como um par separado por vírgulas: "longitude,latitude". Os parênteses podem opcionalmente envolver a expressão.
• Os valores de longitude e latitude são armazenados com até 6 casas decimais de precisão.

Nota:

Os valores da APIGlideGeoPoint são sempre listados em ordem de longitude e latitude.

Os exemplos nesta página presumem que uma tabela personalizada seja preenchida previamente com campos que contêm o tipo de campo de ponto geográfico. Para obter mais informações sobre este tipo de dados, consulte Geo point field type e Function field.

GlideGeoPoint — GlideGeoPoint()

Instancia um objeto GlideGeoPoint. O objeto GlideGeoPoint adiciona conscientização semântica aos valores de longitude e latitude que, de outra forma, são armazenados como cadeias de caracteres.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
Nenhum

O exemplo a seguir mostra como inicializar um novo objeto GlideGeoPoint como um valor nulo.

var gp = new GlideGeoPoint();

GlideGeoPoint - GlideGeoPoint (cadeia de caracteres de longitude, cadeia de caracteres de latitude)

Instancia o objeto GlideGeoPoint de acordo com os valores de longitude e latitude fornecidos.

Tabela 2. Parâmetros

Nome	Tipo	Descrição
longitude	Cadeia de caracteres	A coordenada de longitude do ponto geográfico.
latitude	Cadeia de caracteres	A coordenada de latitude do ponto geográfico.

Tabela 3. Retorna

Tipo	Descrição
ponto geográfico	O objeto GlideGeoPoint resultante.

O exemplo a seguir mostra como fornecer valores de longitude e latitude inicializa o objeto de acordo.

// Providing longitude and latitude values initializes the object accordingly 
var gp = new GlideGeoPoint(10.123, 25.987);  
gs.info("geopoint: " + gp);

Saída:

geopoint: 10.123000,25.987000

GlideGeoPoint - GlideGeoPoint(objeto geoPoint)

Copia valores de pontos de longitude e latitude para instanciar um novo objeto GlideGeoPoint.

Tabela 4. Parâmetros

Nome	Tipo	Descrição
GeoPoint	Objeto	A instância de geopoint que você deseja copiar.

Tabela 5. Retorna

Tipo	Descrição
ponto geográfico	O objeto GlideGeoPoint resultante.

O exemplo a seguir mostra como copiar valores de longitude e latitude para instanciar um novo objeto GlideGeoPoint.

var gp = new GlideGeoPoint(135, -64);
var gpCopy = new GlideGeoPoint(gp); 
gs.info("geopoint: " + gpCopy);

Saída:

geopoint: 135,-64

GlideGeoPoint – getDisplayValue()

Retorna o ponto geográfico do usuário atual em um formato amigável.

A função getDisplayValue() retorna um único valor de geopoint. Para obter informações sobre como recuperar todos os valores de geopoint de uma tabela específica, consulte Guia do desenvolvedor de GlideGeoPoint.

Tabela 6. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 7. Retorna

Tipo	Descrição
Cadeia de caracteres	O valor das coordenadas de longitude e latitude definidas no objeto.

var gp = new GlideGeoPoint(); 
gp.setValue(76.25, 49.75);      
gs.info("geopoint: " + gp); 
gs.info("getDisplayValue(): " + gp.getDisplayValue());

Saída:

geopoint: 76.250000,49.750000 
getDisplayValue(): (76.250000, 49.750000)

GlideGeoPoint – getLatitude()

Retorna o valor de latitude do objeto GlideGeoPoint.

Tabela 8. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 9. Retorna

Tipo	Descrição
Cadeia de caracteres	O valor de latitude do objeto GlideGeoPoint.

var gp = new GlideGeoPoint(); 
gp.setValue(76.25, 49.75);      

gs.info("geopoint: " + gp); 
gs.info("getLatitude(): " + gp.getLatitude());

Saída:

geopoint: 76.250000,49.750000 
getLatitude(): 49.75

GlideGeoPoint – getLongitude()

Retorna o valor de longitude do objeto GlideGeoPoint.

Tabela 10. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 11. Retorna

Tipo	Descrição
Cadeia de caracteres	O valor de longitude do objeto GlideGeoPoint.

var gp = new GlideGeoPoint(); 
gp.setValue(76.25, 49.75);      
gs.info("geopoint: " + gp);  
gs.info("getLongitude(): " + gp.getLongitude());

Saída:

geopoint: 76.250000,49.750000 
 getLongitude(): 76.25

GlideGeoPoint – getValue()

Retorna uma cadeia de caracteres contendo o valor programático de longitude e latitude do objeto GlideGeoPoint atual.

Tabela 12. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 13. Retorna

Tipo	Descrição
Cadeia de caracteres	O valor de longitude e latitude do objeto GlideGeoPoint atual.

 var gp = new GlideGeoPoint(); 
gp.setValue(76.25, 49.75);      
gs.info("geopoint: " + gp);
gs.info("getValue(): " + gp.getValue());

Saída:

geopoint: 76.250000,49.750000
getValue(): 76.250000,49.750000

GlideGeoPoint - setValue(cadeia de caracteres de longitude, cadeia de caracteres de latitude)

Define os valores de longitude e latitude do ponto geográfico.

Tabela 14. Parâmetros

Nome	Tipo	Descrição
longitude	Cadeia de caracteres	A coordenada longitudinal do geoponto.
latitude	Cadeia de caracteres	A coordenada de latitude do ponto geográfico.

Tabela 15. Retorna

Tipo	Descrição
Cadeia de caracteres	O valor de longitude e latitude definido no objeto GlideGeoPoint.

var gp = new GlideGeoPoint(); 
gp.setValue("-28.48,38.91");      
gs.info("geopoint: " + gp);

Saída:

geopoint: -28.480000,38.910000

GlideGeoPoint - setValue(cadeia de caracteres value)

Define os valores de longitude e latitude do ponto geográfico usando um único valor delimitado por vírgulas.

Tabela 16. Parâmetros

Nome	Tipo	Descrição
valor	Cadeia de caracteres	Um valor delimitado por vírgulas que contém pontos de longitude e latitude, respectivamente.

Tabela 17. Retorna

Tipo	Descrição
Cadeia de caracteres	O valor de longitude e latitude definido no objeto GlideGeoPoint.

O exemplo a seguir mostra como definir os valores de longitude e latitude usando uma única cadeia de caracteres.

var gp = new GlideGeoPoint();
gp.setValue(23.4, 56.7);

Saída:

geopoint: -23.400000,56.700000