GlideGeoPoint - Global

A API GlideGeoPoint permite que você obtenha e defina valores de tipo de dados de ponto geográfico em uma tabela.

Esta API 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 geopoints 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 geopoint, calcular distâncias entre locais de geopoint ou consultar locais de geopoint próximos, consulte Guia do desenvolvedor do 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 ponto geográfico são sempre aceitos como entrada e são exibidos como um par separado por vírgulas: "longitude,latitude". Opcionalmente, os parênteses podem cercar 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 na ordem de longitude e latitude.

Os exemplos nesta página presumem que uma tabela personalizada é preenchida previamente com campos que contêm o tipo de campo de ponto geográfico. Para obter mais informações sobre esse 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(a)

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

var gp = new GlideGeoPoint();

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

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 geopoint.
latitude	Cadeia de caracteres	A coordenada de latitude do geopoint.

Tabela 3. Retornos

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

O exemplo a seguir mostra como o fornecimento de 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 do geopoint que você deseja copiar.

Tabela 5. Retornos

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 geopoint do usuário atual em um formato amigável.

O método getDisplayValue() retorna um único valor de ponto geográfico. Para obter informações sobre como recuperar todos os valores de geopoint de uma tabela específica, consulte Guia do desenvolvedor do 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 – getGeoPoint(cadeia de caracteres geo_point_field_name)

Retorna uma lista de valores de coordenadas de ponto geográfico para um determinado nome de campo do tipo ponto geográfico.

Tabela 8. Parâmetros

Nome	Tipo	Descrição
geo_point_field_name	Cadeia de caracteres	Nome do campo de ponto geográfico. Nota: Você também pode localizar nomes de campo em elementos de dicionário definidos em uma tabela para ver os campos associados do tipo de ponto geográfico. Tabela: entrada de dicionário [sys_dictionary]

Tabela 9. Retornos

Tipo	Descrição
Objeto	Objeto GlideGeoPoint resultante.

No exemplo a seguir, "test_table" é uma tabela que contém o campo "geo_point" do tipo de ponto geográfico. A test_table tem um registro preenchido na coluna geo_point com um valor de (-30.560000, -54.330000). O código de exemplo retorna as coordenadas de latitude e longitude e o valor de exibição do registro na coluna geo_point.

var gr_Test = new GlideRecord('test_table');
gr_Test.query();
gr_Test.next();
var gp = gr_Test.getGeoPoint('geo_point');
gs.info("getLatitude(): " + gp.getLatitude());
gs.info("getLongitude(): " + gp.getLongitude());
gs.info("getDisplayValue(): " + gp.getDisplayValue());

Saída:

getLatitude(): -54.33
getLongitude(): -30.560000000000002 
getDisplayValue(): (-30.560000, -54.330000)

GlideGeoPoint – getLatitude()

Retorna o valor de latitude do objeto GlideGeoPoint.

Tabela 10. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 11. 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 12. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 13. 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 que contém o valor programático de longitude e latitude do objeto GlideGeoPoint atual.

Tabela 14. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 15. 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 16. Parâmetros

Nome	Tipo	Descrição
longitude	Cadeia de caracteres	A coordenada longitudinal do geopoint.
latitude	Cadeia de caracteres	A coordenada de latitude do geopoint.

Tabela 17. Retornos

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(String value)

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

Tabela 18. 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 19. Retornos

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