GlideGeoPoint - Global

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 5 min. de leitura

    • 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. Retorna
    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. 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 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 O nome do campo de ponto geográfico. Localizado na tabela Entrada de Dicionário [sys_dictionary].
    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 9. Retorna
    Tipo Descrição
    Objeto O 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. 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(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. 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