Diretrizes de geolocalização

Última atualização: 22 de outubro de 2014.

Introdução

Publicação com Localização é o recurso de geotagging na X API. Esse recurso ajuda a oferecer uma experiência mais relevante para os usuários, tornando os Posts mais contextuais. Por exemplo, “Fogos de artifício!” é muito mais significativo quando associado a uma localização: “Fogos de artifício!” no bairro SoMa, em San Francisco, Califórnia. Estamos ansiosos para trabalhar com o ecossistema de desenvolvedores para criar experiências excelentes em torno dessa funcionalidade!

Privacidade do usuário e controle do usuário sobre suas informações de localização

Para garantir uma experiência segura e de qualidade, os desenvolvedores devem ser atentos à privacidade do usuário ao lidar com dados de localização e também oferecer consistência básica na experiência de “Publicar com localização”. A seguir, alguns pontos essenciais a serem considerados que ajudam a proteger a privacidade do usuário e a garantir que os usuários compreendam o impacto de suas ações:

Diretrizes Gerais

• Os usuários devem optar por usar o recurso Postar com Localização (ativar a localização).
• Os usuários devem conceder permissão explícita para que sua localização exata seja exibida com seus posts. Se o recurso de localização no seu cliente for “persistente” — isto é, uma vez ativada, a localização sempre acompanha um post — você pode optar por exibir apenas nomes de lugares (place_ids) e permitir que os usuários optem adicionalmente por latitude e longitude exatas por post ou como uma configuração alternativa específica.
• Quando você acessar os dados de localização dos seus usuários para publicar um post, essas informações não devem ser armazenadas por você separadamente do post sem a permissão explícita do usuário.
• Deve ficar claro para os usuários qual nível de informação de localização, se houver, será exibido em associação ao post deles. Uma forma de fazer isso é mostrar um mapa de como essas informações serão exibidas antes de o post ser publicado. Se a latitude e longitude exatas fizerem parte das informações (ou forem as únicas informações) publicadas pelo usuário no cliente, deve ficar claro para o usuário que suas coordenadas exatas serão publicadas.
• Os usuários devem poder ativar e desativar sua localização toda vez que redigirem um post.
• Você deve seguir os termos da Developer Policy da X — incluindo a exigência de que você não pode agregar, armazenar em cache ou armazenar dados de localização e outras informações geográficas da X API, exceto como parte de um post, e não pode usar tais dados de localização ou informações geográficas de forma independente.

Exemplos Específicos

Exemplo 1: Sem adição de latitude e longitude explícitas (esta é a UI atual do X Web Client)

1. Mostrar um link para “Adicionar sua localização” quando o usuário estiver compondo um Post;
2. Em segundo plano, usar a chamada à API do X reverse_geocode e enviar a latitude, longitude, a precisão do seu posicionamento e a granularidade preferida do usuário (que, por padrão, é “bairro”);
3. Exibir o nome do local padrão (o X tentará ordenar esses itens de forma que faça sentido — a ordenação permite que um cliente do X simplesmente exiba a lista sem necessidade de modificação);
4. Permitir que o usuário selecione um local diferente na lista (por exemplo, mudar de “SoMa, San Francisco” para “South Beach, San Francisco”).
5. Importante: seja transparente com o usuário se você for exibir informações de localização exata. Certifique-se de que o usuário saiba se informações de localização exata serão exibidas.
6. Permitir que o usuário escolha ativar ou desativar a localização a cada composição de Post.

Exemplo 2: Implementações de geotagging existentes

Vários apps cliente do X têm implementado o recurso original de geotagging (que apenas transmitia lat/lon sem fornecer place_ids). O comportamento padrão da API imita esse comportamento — isto é, como desenvolvedor, você não precisa fazer alterações no seu app existente para manter o comportamento atual. De fato, se você simplesmente enviar uma coordenada de lat/lon para o X, o X fará automaticamente o reverse geocode dessa latitude e longitude e exibirá o place_id além de lat/lon nas áreas onde temos dados disponíveis.

Garanta transparência para seus usuários de que as coordenadas exatas deles estão sendo usadas e exibidas no X. Uma prática recomendada para apps existentes é permitir que os usuários ativem ou desativem a localização por Post. Você também pode permitir que seus usuários compartilhem apenas place_ids em vez de coordenadas exatas como uma configuração padrão “persistente”.

Armazenamento de dados de localização de usuários pela X

A X armazenará os dados enviados pelo cliente da seguinte forma:

• A X salvará todos os dados que um usuário optar por exibir publicamente para seus seguidores. Isso é semelhante à forma como a X armazena o carimbo de data/hora que indica quando o Post foi feito; ou seja, se um usuário publicar com suas coordenadas exatas, a X armazenará essa localização exata junto com o Post enquanto o Post existir. Os usuários podem limpar os dados de localização de seus Posts clicando no botão “limpar meu histórico de localização” na página de Configurações, conforme descrito aqui.

Resumo

Adicionar localização a um Post agrega muito contexto e valor do ponto de vista do usuário. Porém, as implementações de localização no seu cliente devem tratar a privacidade e a transparência do usuário como considerações essenciais ao projetar um produto com foco em localização.

Se você tiver dúvidas ou comentários sobre privacidade, localização e outros recursos de geolocalização, entre em contato conosco.