POIs

Lista de parâmetros

Os seguintes parâmetros são necessários:

  • legs – Array de objetos onde cada objeto representa um trecho da rota (obrigatório apenas para o endpoint independente). Cada objeto presente em legs irá conter os seguintes parâmetros:
    • points – Coordenadas que compõem o trecho da rota. O parâmetro points aceita as coordenadas como objetos, arrays, codificadas em geohash ou codificadas como polyline, conforme os exemplos abaixo.
  • bufferRouteInMeters – Número inteiro com o raio de busca de pontos de interesse ao longo da rota. Limite de 500 metros.
  • bufferStoppingPointsInMeters – Número inteiro com o raio de busca de pontos de interesse nos pontos de paradas. Limite de 500 metros.
  • onlyMyPlaces – Valor booleano que indica se apenas os estabelecimentos da sua base própria serão retornados ou se a base nativa do serviço também deve ser usada.
  • categories – Array com as categorias dos estabelecimentos desejados.
  • subCategories – (Opcional) Array com as subcategorias dos estabelecimentos desejados.

Nota: Para consultar as categorias e subcategorias disponíveis para consulta e cadastro, basta fazer uma requisição para os seguintes endpoints (método GET): https://api.maplink.global/place/v1/places/category e https://api.maplink.global/place/v1/places/subcategory

Formatos de coordenadas aceitos

Os seguintes formatos são suportados como entrada das coordenadas no parâmetro points:

Objeto – Objetos compostos pelos parâmetros latitude e longitude:

"points": [
	{
		"latitude": -19.50489,
		"longitude": -57.43231 
	}
]

Array – Arrays contendo a latitude e longitude respectivamente:

"points": [
	[-19.50489,-57.43231],
]

Geohash – Strings com a latitude e longitude codificadas em geohash:

"points": [
	"6sx1j15pf",
]

Polyline – String com todas as coordenadas da rota codificadas como polyline:

"points": "pp`vB|fp}IlAFhCI"