Palestra apresentada no PythonBrasil[6] (Out/2010), na qual a recém-lançada API do Apontador é apresentada para os desenvolvedores com foco particular no uso com Python (através da biblioteca própria de código livre).

1. Apontador API
(para programadores Python)
chester@apontador.com
@chesterbr
http://www.apontador.com.br

2. Palestrante
● Bacharel em Matemática Aplicada e
Computacional (IME/USP)
● Desenvolvedor profissional há 2e1 anos
● Python: cruzalinhas
● Arquiteto de Produtos no Apontador
● Twitter: @chesterbr
● Mais informações: http://chester.me

3. O que vamos ver
● Apontador
(empresa, site, plataforma)
● Apontador API
● Python e a Apontador API
● A vida, o universo e tudo mais

4. Apontador

5. “Aquele site de mapas
que virou pago”

6. “Aquele site de mapas
que virou pago”

7. Conectar locais, pessoas e
informações ao seu redor

8. Conectar locais, pessoas e
informações ao seu redor
(tá, e daí?)

9. daí que...

11. Plataforma
Nossa Visão

12. Web Services - Clientes e Parceiros

13. Plataforma
Presente(i.e., passado recente)

14. Plataforma
Futuro

15. (é, você aí mesmo!)

16. Apontador API

17. APIs
Application Programming Interface

19. APIs no Brasil
Fonte:

20. APIs no Brasil
Fonte:

21. Possibilidades
● Criar sites/aplicativos novos
usando informações de locais
● Integrar nos já existentes
● Mashups com outros serviços
● Armazenar locais e informações

22. Regras do Jogo
● Dê linkback/crédito
● Abra a aplicação o ao público
● Mantenha o “fair play”
● Vários aplicativos diferntes é ok
● Uso comercial é ok!
● Uso acadêmico é muito ok!!!!

23. O que dá pra fazer?
● Busca local
● Informações, fotos, avaliações
● Segmentação (categorias)
● Informações do usuário
● Cadastrar coisas novas

24. Busca Local
● Busca: o que
● Busca local: o que + onde

25. Busca Local
● Busca: o que
● Busca local: o que + onde

26. Busca Local
● Busca: o que
● Busca local: o que + onde

27. Busca Local na Apontador API
● search/places/byaddress
● search/places/byzipcode
● search/places/bypoint
● search/places/bybox

28. Tecnologia Agnóstica
● REST (HTTP)
● Respostas JSON, XML e KML
● OAuth para ações em nome de
usuários Apontador

29. Python

30. Idéia Original
“Vamos fazer bibliotecas para todas
as linguagens populares, facilitando a
vida do desenvolvedor”

31. Errr...
● Quais linguagens são “populares”?
● Qual o estilo das bibliotecas?
● Quanto vamos demorar?
● E se os usuários não gostarem?

32. Solução Adotada
● Começamos com Python e PHP
● Bibliotecas livres (Apache 2.0)
● Erramos? Analise, dê feedback,
mande seus patches!

33. http://github.com/apontador
/apontador-api-libs
Github

34. Hello World
1) Cadastre seu usuário no
http://api.apontador.com.br
2) Entre na edição
do perfil, e lá
em aplicativos

35. Hello World
3) Clique em Criar Aplicativo e
informe os dados solicitados
4) O cadastro vai gerar o Consumer
Key e o Consumer Secret – eles
são o “usuário e senha” do app
5) Agora é só brincar de Python :-)

36. apontador-api-libs/python
>>> from apontador import ApontadorAPI
>>> api = ApontadorAPI(
consumer_key = "...",
consumer_secret = "...")
>>> api.search_places_by_address(
state="PR",
city="Curitiba",
term="Universidade Federal do Parana",
limit=1)

37. UFPR?

38. UFPR!
Universidade Federal
Do Paraná

39. E veio certo?
<street>Rua XV de Novembro</street>
<number>1299</number>

41. Mas veio certo mesmo?
<lat>-25.42722</lat>
<lng>-49.26154</lng>

43. Postos na Região
>>> import json
>>> postos = json.loads(
api.search_places_by_point(
latitude=-25.42722,
longitude=-49.26154,
category_id=65,
type="json"))['search']['places']
>>> postos[0]['place']['name']
u'IRMAOS BERTOLDI LTDA'
>>> postos[1]['place']['name']
u'A. S. J - COMERCIO DE COMBUSTIVEIS LTDA'
>>> postos[2]['place']['name']
u'POSTO MONALISA CHEVRON R MARECHAL HERMES'

44. E o posto é bom?
>>> posto_id = postos[0]['place']['id']
>>> reviews = json.loads(
api.get_place_reviews(
posto_id,
type="json"))['place']['reviews']
>>> reviews[0]['review']['content']
u'Esse posto xe9 legal por causa da
localizaxe7xe3o...perto da pista de sk8
do gaxfacho...e o prexe7o xe9 bacana
tbm..mas o atendimento xe9 mto zoado...os
frentistas Sao Mt mal educados e sem
atencao...um dia que passei lxe1 tava
rolando ate uma briga entre a atendente do
caixa e os frentistas...Sxf3 recomendo se
vc tiver paciencia!'

45. Inserindo Informações
Não é obrigatório, mas:
● É mais fácil ter tudo num lugar
● Aumenta o engajamento
● Faz a plataforma crescer

46. Inserindo Informações

47. OAuth
● Solicite um token inicial
● Troque ele pela URL de auth
● Redirecione o usuário para a
URL resultante

48. OAuth

49. OAuth
● Sua URL de callback é chamada,
recebendo o token e seu secret;
guarde-os com carinho
● Para apps desktop/mobile, use
PIN Code (vide pincode.py)

50. OAuth
>>> api = ApontadorAPI(
consumer_key = "...",
consumer_secret = "...",
oauth_token = "...",
oauth_token_secret = "...")
>>> api.create_new_review(
place_id=posto_id,
rating=4,
content="Eu gostei...")
>>> api.vote_place_up(place_id=posto_id)
>>> api.add_photo_to_place(
place_id=posto_id,
image_file="/tmp/foto.jpg")

51. Aprenda Mais
● Veja os exemplos (na biblioteca)
● Documentação:
http://api.apontador.com.br
● Lista de discussão:
http://groups.google.com/group/
apontador-api
● Use o Apontador!

52. A vida, o universo
e tudo mais

53. Futuro próximo
● Apontador Mobile (checkins)
● API JavaScript
● Informações setoriais (ex.: preço
da gasolina nos postos)

54. Meta de Longo Prazo
e missão pessoal
Trazer toda a Plataforma Apontador
para o lado open da força

55. Meta de Longo Prazo
e missão pessoal
Trazer toda a Plataforma Apontador
para o lado open da força
(ou conquistar 24 territórios
à nossa escolha)

56. Conclusões
Pensem “open” onde vocês
trabalham: o que a empresa tem
que pode ir pro mundo, com
vantagem para ambos?
A API está no ar, agora é com
vocês escrever os aplicativos!

57. Dúvidas?
Obrigado!
chester@apontador.com
@chesterbr
http://www.apontador.com.br