{"id":229598,"date":"2022-11-06T17:21:00","date_gmt":"2022-11-06T14:21:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=229598"},"modified":"2022-11-09T08:38:30","modified_gmt":"2022-11-09T05:38:30","slug":"latitude-e-longitude-em-php-algumas-praticas-uteis","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/pt-pt\/latitude-e-longitude-em-php-algumas-praticas-uteis\/","title":{"rendered":"Latitude e Longitude em PHP: Algumas Pr\u00e1ticas \u00dateis"},"content":{"rendered":"\n

Nos posts anteriores, escrevi um pouco sobre como trabalhar com a API do Google Maps<\/a>. Sinceramente, eu n\u00e3o trabalhei com isso desde aquele post.<\/p>\n

No entanto, tive que trabalhar com latitude e longitude em PHP, e existem algumas pr\u00e1ticas que comecei a usar que acho que podem nos servir bem ao trabalhar com coordenadas ou valores de ponto flutuante, em geral.<\/p>\n

No trecho de c\u00f3digo a seguir, detalharei a abordagem que usei e por que fiz isso. Mas quero deixar claro que, se voc\u00ea estiver lendo isso em rela\u00e7\u00e3o \u00e0 API do Google Maps, n\u00e3o h\u00e1 muito que eu possa oferecer sobre como isso funciona e a vers\u00e3o atual de sua API.<\/p>\n

Latitude e Longitude em PHP<\/h2>\n

Sempre que voc\u00ea est\u00e1 trabalhando com latitude e longitude em PHP, voc\u00ea est\u00e1 trabalhando com valores de ponto flutuante, certo? Ent\u00e3o voc\u00ea nunca quer analis\u00e1-los em nada menos do que isso; caso contr\u00e1rio, voc\u00ea estar\u00e1 perdendo dados e n\u00e3o conseguir\u00e1 localizar o que quer que esteja tentando localizar.<\/p>\n

Portanto, para todos os efeitos, vamos supor que voc\u00ea tenha informa\u00e7\u00f5es chegando ao servidor e precise trabalhar com elas usando PHP.<\/p>\n

As duas coisas que voc\u00ea quer lembrar s\u00e3o:<\/p>\n

    \n
  1. higienizar os dados recebidos,<\/li>\n
  2. certifique-se de que seja convertido em um valor de ponto flutuante.<\/li>\n<\/ol>\n

    Isso pode ser feito atrav\u00e9s do uso das fun\u00e7\u00f5es filter_var<\/a> e floatval<\/a> do PHP, sobre as quais falarei brevemente. Observe, no entanto, que se o resultado de floatval<\/strong> n\u00e3o retornar um ponto flutuante, voc\u00ea precisa ter uma maneira elegante de lidar com isso.<\/p>\n

    De acordo com o manual, floatval<\/strong> pode retornar o seguinte:<\/p>\n

    \n

    O valor float da vari\u00e1vel fornecida. Arrays vazios retornam 0, arrays n\u00e3o vazios retornam 1. Strings provavelmente retornar\u00e3o 0, embora isso dependa dos caracteres mais \u00e0 esquerda da string. As regras comuns de fundi\u00e7\u00e3o de flutua\u00e7\u00e3o se aplicam.<\/p>\n<\/blockquote>\n

    Veremos como lidar com isso mais graciosamente mais adiante no post.<\/p>\n

    Analisando Latitude e Longitude de Entrada<\/h3>\n

    Vamos supor que os valores recebidos estejam na cole\u00e7\u00e3o $_REQUEST<\/a> do PHP (que se refere \u00e0s solicita\u00e7\u00f5es HTTP que chegam ao servidor) codificados como acme-demo-latitude<\/strong> e acme-demo-longitude.\u00a0<\/strong><\/p>\n

    Podemos recuper\u00e1-los assim<\/a> :<\/p>\n

    <?php\n\n$latitude  = $_REQUEST['acme-demo-latitude'];\n$longitude = $_REQUEST['acme-demo-longitude'];<\/code><\/pre>\n
    Mas isso n\u00e3o \u00e9 suficiente. Primeiro, precisamos usar filter_var<\/strong> para garantir que os dados sejam higienizados e sigam o esquema de ponto flutuante<\/a> :<\/p>\n
    <?php\n\n$latitude  = filter_var(\n    $_REQUEST['acme-demo-latitude'],\n    FILTER_SANITIZE_NUMBER_FLOAT\n);\n\n$longitude = filter_var(\n    $_REQUEST['acme-demo-longitude'],\n    FILTER_SANITIZE_NUMBER_FLOAT\n);<\/code><\/pre>\n
    Em seguida, acho \u00fatil usar floatval<\/strong> para analisar o resultado como um valor de ponto flutuante. Isso deixa o seguinte bloco de c\u00f3digo assim<\/a> :<\/p>\n
    <?php\n\n$latitude  = floatval(\n  filter_var(\n    $_REQUEST['acme-demo-latitude'],\n    FILTER_SANITIZE_NUMBER_FLOAT) );\n\n$longitude = floatval(\n  filter_var(\n    $_REQUEST['acme-demo-latitude'],\n    FILTER_SANITIZE_NUMBER_FLOAT) );<\/code><\/pre>\n
    Depois disso, voc\u00ea est\u00e1 livre para us\u00e1-lo. Mas lembre-se, ainda precisamos ter certeza de que os valores retornados s\u00e3o valores de ponto flutuante.<\/p>\n
    Validando os dados<\/h3>\n
    Agora que temos as informa\u00e7\u00f5es, precisamos ter certeza de que parece bom. E se isso n\u00e3o acontecer, precisamos lidar com isso adequadamente. Se n\u00e3o for, ent\u00e3o podemos simplesmente:<\/p>\n
      \n
    1. retorne false da fun\u00e7\u00e3o da qual est\u00e1 contido,<\/li>\n
    2. lan\u00e7ar uma exce\u00e7\u00e3o e permitir que o chamador a trate da maneira que achar melhor.<\/li>\n<\/ol>\n
      Cada um desses exemplos pode ter esta<\/a> apar\u00eancia :<\/p>\n
      <?php\n\n\/\/ Return false...\nif (! (is_float( $latitude) && is_float( $longitude) )) {\n  return false;\n}\n\n\/\/ Or throw an exception...\nif (! (is_float( $latitude) && is_float( $longitude) )) {\n  throw new Exception('Latitude and longitude are not valid floating point values.');\n}\n<\/code><\/pre>\n
      Em \u00faltima an\u00e1lise, por\u00e9m, a decis\u00e3o \u00e9 sua sobre como lidar com os valores quando eles n\u00e3o est\u00e3o no formato adequado depois de analis\u00e1-los.<\/p>\n
      Essas s\u00e3o as melhores pr\u00e1ticas?<\/h2>\n
      Para ser sincero, duvido. Eu sei que estas s\u00e3o as coisas que eu tenho usado e que achei \u00fateis. Ele tamb\u00e9m fornece uma maneira defensiva e resiliente de garantir que seus valores estejam corretos.<\/p>\n
      Mas se houver maneiras melhores de fazer isso, estou aberto a ouvi-las nos coment\u00e1rios.<\/p>\n
      Fonte de grava\u00e7\u00e3o:  tommcfarlin.com<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"
      Eu tenho trabalhado com latitude e longitude em PHP. Existem pr\u00e1ticas que acho que nos servem bem ao trabalhar com valores de ponto flutuante.<\/p>\n","protected":false},"author":1,"featured_media":166466,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":"","_wp_rev_ctl_limit":""},"categories":[920,846,867],"tags":[1170],"class_list":["post-229598","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-outro","category-tutoriais","category-wordpress-8","tag-affiai-pt-pt"],"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts\/229598","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/comments?post=229598"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts\/229598\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/media\/166466"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/media?parent=229598"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/categories?post=229598"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/tags?post=229598"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}