Tire suas Dúvidas

Veja as perguntas mais comuns aqui no FAQ. Se a sua não estiver aqui, entre na lista de discussão e peça ajuda, troque idéias e dê sugestões.

Vocês têm bibliotecas específicas para PHP, Python, Java, .NET/C#, COBOL, Whitespace...?

Já temos algumas, mas queremos ter mais e melhores! Se você criar uma biblioteca/framework livre desse gênero (ou precisar de ajuda nese sentido), fale com a gente - teremos o maior prazer em divulgar o trabalho e seus autores.

Posso fazer uma busca pelo nome do local?

O ideal é sempre anexar uma informação geográfica na busca, mas você pode passar o nome do local no parâmetro term (disponível em todos os métodos de busca de locais), e escolher o método menos restritivo - por exemplo, o search/places/byaddress exige apenas cidade e estado (e um raio apropriado).

Cadastrei um local/avaliação ou votei, mas não apareceu ainda no Apontador ou na busca. O que houve?

Devido ao volume e abrangência do acesso, o site Apontador usa uma CDN que guarda em cache as páginas de locais, e eventualmente pode demorar alguns minutos para atualizar. Mas você pode consultar as avaliações do local pela API e verificar a sua mudança.

Além disso, as buscas são re-indexadas algumas vezes ao dia, então novos locais podem levar algumas horas para aparecer nelas. Como no caso anterior, eles podem ser recuperados imediatamente através do id.

Por que a nota média em alguns locais não bate com as minhas contas? (ex.: o local tem uma resenha com 4 estrelas, mas a média aparece como 3)

Sua matemática está correta - o que acontece é que versões antigas do Apontador permitiam o cadastro de notas (estrelas) sem a avaliação associada, o que não acontece hoje. Optamos por manter estas notas no cálculo para oferecer uma informação mais qualificada, daí a diferença.

Não conheço OAuth - e agora?

Tudo bem: é uma tecnologia relativamente recente - mas que todos serviços relevantes da web (Twitter, Facebook, Google e vários outros) usam para garantir a circulação segura de informações de usuários entre os diferentes sites.

Nossa sugestão é que você use uma biblioteca apropriada para a sua linguagem de programação - isso se a sua linguagem já não tiver uma biblioteca própria para a Apontador API.

REST/JSON? REST/XML? O que é isso?

REST já é uma tecnologia consolidada para comunicação entre sistemas, e a principal razão é a simplicidade: essencialmente o seu aplicativo vai usar conexões HTTP (as mesmas que os browsers usam para conectar nos sites) para acessar as APIs remotas.

Você não precisa conhecer muito: todas as linguagens possuem boas bibliotecas (em muitos casos, já vem na própria linguagem) para fazer conexões HTTP, bem como para processar os resultados XML ou JSON - escolha o que tiver melhor suporte na sua linguagem.

E se eu não puder suportar OAuth?

Em alguns casos você não tem como solicitar a autorização do usuário (por exemplo, em plataformas mobile mais simples). Nesses casos, você ainda pode usar as funcionalidades de busca, locais e categorias (que independem de usuário).

Se ainda assim você tiver alguma idéia na qual o OAuth seja obstáculo, fale com a gente e veremos o que pode ser feito.

Por que um local ou busca de locais não retorna o atributo extended?

O atributo é retornado apenas se a busca for filtrada por categoria (ou nos detalhes do local). Vale lembrar que nem todas as categorias informam este atributo (confira a lista), e nem todos os locais na categoria a possuem.

Minha dúvida não é nenhuma dessas. O que eu faço?

Se você ainda estiver com problemas, quiser discutir idéias de aplicativos ou fazer qualquer manifestação pública a respeito da Apontador API, assine a nossa lista de discussão: você pode buscar nos arquivos e participar por e-mail ou pela web, interagindo com nossa equipe e com outros desenvolvedores como você.