GlideGeoPoint - Global

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 5 min. de leitura

    • . GlideGeoPoint A API 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 o. GlideGeoPoint API, você pode instanciar novos objetos GlideGeoPoint, criar novos geopoints para uma tabela específica ou recuperar valores únicos de latitude, longitude ou geotype. 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 ponto geográfico ou consultar locais de ponto geográfico próximos, consulte GlideGeoPoint Developer Guide.

    Os principais aspectos do tipo de dados geotípicos são:
    • Consiste em um par de números decimais que representam valores de longitude e latitude.
    • O intervalo de longitude é (-180, 180]. Qualquer valor fora desse intervalo é normalizado para o valor equivalente dentro desse intervalo.
    • O intervalo de latitude é [-90, 90]. Qualquer valor fora desse intervalo é normalizado para o valor equivalente dentro desse intervalo.
    • Os valores de pontos geográficos são sempre aceitos como entrada e exibidos como um par separado por vírgulas: "Longitude,latitude". Parênteses podem, opcionalmente, cercar a expressão.
    • Os valores de longitude e latitude são armazenados com até 6 casas decimais de precisão.
    Nota:
    GlideGeoPoint Os valores de API são sempre listados em longitude, ordem de 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 GlideGeoPoint objeto. . GlideGeoPoint o objeto adiciona consciência semântica aos valores de longitude e latitude que 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. GlideGeoPoint objeto 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. Retornos
    Tipo Descrição
    geopoint O resultante GlideGeoPoint objeto.

    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 (GeoPoint de objeto)

    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 ponto geográfico que você deseja copiar.
    Tabela 5. Retornos
    Tipo Descrição
    geopoint O resultante GlideGeoPoint objeto.

    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.

    . ObtDisplayValue() o método retorna um único valor de ponto geográfico. Para obter informações sobre como recuperar todos os valores de pontos geográficos de uma tabela específica, consulte GlideGeoPoint Developer Guide.

    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 campos 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. 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 exibe o valor 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 GlideGeoPoint objeto.

    Tabela 10. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 11. Retorna
    Tipo Descrição
    Cadeia de caracteres O valor de latitude do GlideGeoPoint objeto. 
    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 GlideGeoPoint objeto.

    Tabela 12. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 13. Retorna
    Tipo Descrição
    Cadeia de caracteres O valor de longitude do GlideGeoPoint objeto. 
    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 de longitude programática e latitude da atual GlideGeoPoint objeto.

    Tabela 14. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 15. Retorna
    Tipo Descrição
    Cadeia de caracteres O valor de longitude e latitude da atual GlideGeoPoint objeto. 
     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(longitude da cadeia de caracteres, latitude da cadeia de caracteres)

    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 ponto geográfico.
    Tabela 17. Retornos
    Tipo Descrição
    Cadeia de caracteres O valor de longitude e latitude definido no GlideGeoPoint objeto. 
    var gp = new GlideGeoPoint(); 
gp.setValue("-28.48,38.91");      
gs.info("geopoint: " + gp);

    Saída:

    geopoint: -28.480000,38.910000

    GlideGeoPoint - setValue(valor da cadeia de caracteres)

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

    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 GlideGeoPoint objeto.

    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