Dev (Back & Front)ARTIGO
Como buscar uma loja através de suas coordenadas usando a API do BuscaPé
Dev Buscapé CompanyAutor
15 de setembro de 2011 às 10:00
8 min de leitura
Para obtermos o resultado desejado, utilizaremos o serviço findSellers. Através dele, as requisições feitas à API do BuscaPé retornam dados de lojas de acordo com sua localização, conforme os parâmetros informados.
Os parâmetros que passaremos na URL são ‘latitude’, ‘longitude’ e ‘radius’. Os dois primeiros servem para indicar as coordenadas (como o próprio nome já diz, latitude e longitude) exatas do local do vendedor. Porém, como não podemos dizer perfeitamente onde está localizado um determinado ponto, informamos o último dos três parâmetros: radius. A busca não funciona sem esses três parâmetros. Aqui informamos o valor, em metros, da distância ao redor do ponto gerado pela abscissa e ordenada. Ou seja, digamos que queremos uma localização de uma loja num raio de 10 km do local escolhido no plano cartesiano. O valor para ‘radius’ deve ser 10000.
Após decidirmos qual o valor das coordenadas e o valor do raio delas, devemos informá-los na URL REST da seguinte maneira:
http://sandbox.buscape.com/service/findSellers/application_id/BR/?latitude=latitude&longitude=longitude&radius=radius
Lembrando que sandbox é o ambiente de testes do BuscaPé e qualquer desenvolvedor pode acessá-lo.
Veremos agora um exemplo prático de como fazer a requisição à API do BuscaPé. Indicaremos as coordenadas geográficas por lojas em um raio de 5 km:
http://sandbox.buscape.com/service/findSellers/564771466d477a4458664d3d/BR/?latitude=-23.508313&longitude=-46.64247&radius=5000
Observe os dados retornados da solicitação feita acima:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Result xmlns="urn:buscape" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" page="1" totalPages="2241" totalResultsReturned="16" totalResultsAvailable="35854" xsi:schemaLocation="http://developer.buscape.com/admin/buscape.xsd">
<details>
<applicationID>564771466d477a4458664d3d</applicationID>
<applicationVersion>1.0.0.0</applicationVersion>
<applicationPath>http://bws-apps.buscape.com/mobile/update</applicationPath>
<date>2011-08-19T11:14:18.471-03:00</date>
<elapsedTime>2</elapsedTime>
<status>success</status>
<code>0</code>
<message>success</message>
</details>
<sellers>
<seller pagamentoDigital="false" isTrustedStore="false" id="960875">
<sellerName>Sindicato Oficiais M T I M M S C T M C L A C F M M J V V C E</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em SP, São Paulo, Sé</extra>
<contacts>
<contact label="Dúvidas" value="11-31078438"/>
<contact label="Informações" value="11-31078430"/>
</contacts>
<rating>
<userAverageRating>
<numComments>9</numComments>
<rating>1.4</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="960051">
<sellerName>Sind Trab Ind T M S M A A R S A O A R B P C B D C A M A B S</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em SP, São Paulo, Liberdade</extra>
<contacts>
<contact label="Informações" value="11-32093902"/>
</contacts>
<rating>
<userAverageRating>
<numComments>7</numComments>
<rating>2.4</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="960052">
<sellerName>Sind Trab Ind T M S M A A R S A O A R B P C B D C A M A B SP</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em SP, São Paulo, Liberdade</extra>
<contacts>
<contact label="Informações" value="11-32093966"/>
</contacts>
<rating>
<userAverageRating>
<numComments>6</numComments>
<rating>4.0</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="960062">
<sellerName>Sind Trabalhadores Ind F T M M C e A C M T e T F e T SP I C</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em SP, São Paulo, Brás</extra>
<contacts>
<contact label="Informações" value="11-33135861"/>
</contacts>
<rating>
<userAverageRating>
<numComments>7</numComments>
<rating>1.4</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="960084">
<sellerName>Sindeepres-Sind e e P S T C A M O T T L M e Av Est S Paulo</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em SP, São Paulo, Centro</extra>
<contacts>
<contact label="Informações" value="11-31154468"/>
</contacts>
<rating>
<userAverageRating>
<numComments>6</numComments>
<rating>2.4</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="960085">
<sellerName>Sindeepres-Sind e e P S T C A M O T T L M e Av Est São Paulo</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em SP, São Paulo, Centro</extra>
<contacts>
<contact label="Informações" value="11-31154694"/>
</contacts>
<rating>
<userAverageRating>
<numComments>6</numComments>
<rating>2.4</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="960718">
<sellerName>Sindicato Empregados Empr S P C A A S P C Emp P P Est São Pa</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em SP, São Paulo, Bela Vista</extra>
<contacts>
<contact label="Informações" value="11-32581439"/>
</contacts>
<rating>
<userAverageRating>
<numComments>7</numComments>
<rating>1.4</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="960756">
<sellerName>Sindicato Hospitais C C S L P A C T B R F e Estado São Paulo</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em SP, São Paulo, República</extra>
<contacts>
<contact label="Informações" value="11-32232773"/>
</contacts>
<rating>
<userAverageRating>
<numComments>8</numComments>
<rating>2.0</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="960000">
<sellerName>Sind Hosp Clin C Saúde Lab Peso A C I B Rel Fil e S Paulo</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em SP, São Paulo, República</extra>
<contacts>
<contact label="Informações" value="11-33311244"/>
</contacts>
<rating>
<userAverageRating>
<numComments>6</numComments>
<rating>4.0</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="960001">
<sellerName>Sind Hosp Clin C Saúde Lab Pesq Anal Clin I B Fil e S Paulo</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em SP, São Paulo, República</extra>
<contacts>
<contact label="Informações" value="11-32220251"/>
</contacts>
<rating>
<userAverageRating>
<numComments>6</numComments>
<rating>4.0</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="960065">
<sellerName>Sind Trabs Ind Fiação Tecel Mal Meias Cord e A C M T T F e T</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em SP, São Paulo, Brás</extra>
<contacts>
<contact label="Informações" value="11-33116815"/>
</contacts>
<rating>
<userAverageRating>
<numComments>6</numComments>
<rating>4.0</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="960755">
<sellerName>Sindicato Hosp Clin C Saúde Lab Pesq A C I B Rel Fil Est SP</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em SP, São Paulo, República</extra>
<contacts>
<contact label="Dúvidas" value="11-33310126"/>
<contact label="Informações" value="11-32226391"/>
<contact label="SAC" value="11-33312373"/>
<contact label="Televendas" value="11-33312515"/>
<contact label="Televendas" value="11-33316401"/>
<contact label="Televendas" value="11-33336697"/>
<contact label="Televendas" value="11-33337319"/>
</contacts>
<rating>
<userAverageRating>
<numComments>0</numComments>
<rating>0.0</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="855377">
<sellerName>Transfretur-Sind Emp Tran Pas Fret Tur SP Os Gu It Se Car Ta</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em SP, São Paulo, Vila Buarque</extra>
<contacts>
<contact label="Informações" value="11-33318339"/>
</contacts>
<rating>
<userAverageRating>
<numComments>0</numComments>
<rating>0.0</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="855378">
<sellerName>Transfretur-Sindicato Emp Tran Pas Tur S P Os Gu It Se Car T</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em SP, São Paulo, Vila Buarque</extra>
<contacts>
<contact label="Informações" value="11-33318766"/>
</contacts>
<rating>
<userAverageRating>
<numComments>0</numComments>
<rating>0.0</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="930441">
<sellerName>Assoc D Pais E Amigos D Pessoas Port D Def dos Func D Bco Br</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em SP, São Paulo, Centro</extra>
<contacts>
<contact label="Informações" value="11-31077766"/>
</contacts>
<rating>
<userAverageRating>
<numComments>0</numComments>
<rating>0.0</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="959839">
<sellerName>Sin Emp Tr Pas Fr Tur SP Os Gr It Sr Car Taboão Serra</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em SP, São Paulo, Vila Buarque</extra>
<contacts>
<contact label="Informações" value="11-33540235"/>
</contacts>
<rating>
<userAverageRating>
<numComments>0</numComments>
<rating>0.0</rating>
</userAverageRating>
</rating>
</seller>
</sellers>
</Result>
Caso seja necessário informar uma loja específica para a busca podemos informá-la através do parâmetro ‘sellerName’:
http://sandbox.buscape.com/service/findSellers/564771466d477a4458664d3d/BR/?sellerName=saraiva
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Result xmlns="urn:buscape" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" page="1" totalPages="20" totalResultsReturned="16" totalResultsAvailable="306" xsi:schemaLocation="http://developer.buscape.com/admin/buscape.xsd">
<details>
<applicationID>564771466d477a4458664d3d</applicationID>
<applicationVersion>1.0.0.0</applicationVersion>
<applicationPath>http://bws-apps.buscape.com/mobile/update</applicationPath>
<date>2011-08-19T11:14:59.290-03:00</date>
<elapsedTime>3</elapsedTime>
<status>success</status>
<code>0</code>
<message>success</message>
</details>
<sellers>
<seller pagamentoDigital="false" isTrustedStore="true" id="916769">
<sellerName>Saraiva</sellerName>
<thumbnail url="http://imagem.buscape.com.br/vitrine/logo916769.gif"/>
<links>
<link type="seller" url="http://www.livrariasaraiva.com.br"/>
</links>
<contacts/>
<rating>
<userAverageRating>
<numComments>74666</numComments>
<rating>8.0</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="true" id="155">
<sellerName>Saraiva.com.br</sellerName>
<thumbnail url="http://imagem.buscape.com.br/vitrine/logo155.gif"/>
<links>
<link type="seller" url="http://www.livrariasaraiva.com.br/?PAC_ID=25371"/>
</links>
<extra>Vende pela Internet</extra>
<contacts>
<contact label="SAC" value="11-39334000"/>
<contact label="Televendas" value="4003-3390"/>
</contacts>
<rating>
<userAverageRating>
<numComments>134793</numComments>
<rating>8.0</rating>
</userAverageRating>
<eBitRating>
<numComments>134793</numComments>
<rating>diamante</rating>
</eBitRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="188475">
<sellerName>Geraldo Saraiva</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em CE, Fortaleza, Centro</extra>
<contacts>
<contact label="Atendimento" value="85-32269460"/>
</contacts>
<rating>
<userAverageRating>
<numComments>0</numComments>
<rating>0.0</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="200152">
<sellerName>Gráfica Saraiva</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em BA, Correntina, Centro</extra>
<contacts>
<contact label="Atendimento" value="77-34882566"/>
</contacts>
<rating>
<userAverageRating>
<numComments>0</numComments>
<rating>0.0</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="253531">
<sellerName>Saraiva Data</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em SP, São Paulo, Várzea da Barra Funda</extra>
<contacts>
<contact label="Informações" value="11-36113100"/>
</contacts>
<rating>
<userAverageRating>
<numComments>0</numComments>
<rating>0.0</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="318965">
<sellerName>Arnaldo Saraiva</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em RJ, Niterói, Piratininga</extra>
<contacts>
<contact label="Atendimento" value="21-26094820"/>
</contacts>
<rating>
<userAverageRating>
<numComments>0</numComments>
<rating>0.0</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="412909">
<sellerName>Casa Saraiva</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em MG, Januária, Várzea Bonita</extra>
<contacts>
<contact label="Atendimento" value="38-36211225"/>
</contacts>
<rating>
<userAverageRating>
<numComments>0</numComments>
<rating>0.0</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="449302">
<sellerName>Paulo Saraiva</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em SP, São Paulo, Campos Elíseos</extra>
<contacts>
<contact label="Informações" value="11-32222454"/>
</contacts>
<rating>
<userAverageRating>
<numComments>0</numComments>
<rating>0.0</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="467677">
<sellerName>Comercial Saraiva</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em MA, Balsas, Centro</extra>
<contacts>
<contact label="Atendimento" value="99-35413049"/>
</contacts>
<rating>
<userAverageRating>
<numComments>0</numComments>
<rating>0.0</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="507956">
<sellerName>Contabilidade Saraiva</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em ES, Guarapari, Centro</extra>
<contacts>
<contact label="Atendimento" value="27-32627185"/>
</contacts>
<rating>
<userAverageRating>
<numComments>0</numComments>
<rating>0.0</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="540244">
<sellerName>Depósito Saraiva</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em CE, Fortaleza, Parangaba</extra>
<contacts>
<contact label="Atendimento" value="85-32922592"/>
</contacts>
<rating>
<userAverageRating>
<numComments>0</numComments>
<rating>0.0</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="579984">
<sellerName>Editora Saraiva</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em GO, Goiânia, Setor Aeroporto</extra>
<contacts>
<contact label="Atendimento" value="62-32243016"/>
<contact label="Atendimento" value="62-32252882"/>
</contacts>
<rating>
<userAverageRating>
<numComments>0</numComments>
<rating>0.0</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="581670">
<sellerName>Edson Saraiva</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em MG, Machado, Centro</extra>
<contacts>
<contact label="Atendimento" value="35-32953965"/>
</contacts>
<rating>
<userAverageRating>
<numComments>0</numComments>
<rating>0.0</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="589224">
<sellerName>Eletrônica Saraiva</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em CE, Ibiapina, Centro</extra>
<contacts>
<contact label="Atendimento" value="88-36531223"/>
</contacts>
<rating>
<userAverageRating>
<numComments>0</numComments>
<rating>0.0</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="641708">
<sellerName>Farmácia Saraiva</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em CE, Iracema, Centro</extra>
<contacts>
<contact label="Atendimento" value="88-34281154"/>
</contacts>
<rating>
<userAverageRating>
<numComments>0</numComments>
<rating>0.0</rating>
</userAverageRating>
</rating>
</seller>
<seller pagamentoDigital="false" isTrustedStore="false" id="667971">
<sellerName>Ionice Saraiva</sellerName>
<links>
<link type="seller" url=""/>
</links>
<extra>Loja em RS, Porto Alegre, Jardim Itu Sabará</extra>
<contacts>
<contact label="Atendimento" value="51-33470522"/>
</contacts>
<rating>
<userAverageRating>
<numComments>0</numComments>
<rating>0.0</rating>
</userAverageRating>
</rating>
</seller>
</sellers>
</Result>
Para uma busca mais detalhada informe o nome da loja juntamente com as coordenadas na URL, definindo os parâmetros ‘sellerName’, ‘latitude’, ‘longitude’ e ‘radius’. Fiquem à vontade para testar suas aplicações junto à API do BuscaPé e encontrar a melhor forma de efetuar a busca.
É isso aí developers. Caso ainda tenham alguma dúvida sobre o funcionamento da API do BuscaPé e seus serviços, visite nossa página com a documentação completa.
Dev Buscapé CompanyAutor
pelo Dev Buscapé Developer desenvolvedores externos podem utilizar o WebService disponível pelo Buscapé para criar suas próprias aplicações. No Githun, acompanhe /devbuscapecompany
