Estimar corrida programada
curl --request POST \
--url https://api-vendas.taximachine.com.br/api/v2/integracao/corridas/programadas/estimativas \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'api-key: <api-key>' \
--data '
{
"lat_partida": -22.904445,
"lng_partida": -43.175508,
"endereco_partida": "Rua da Assembleia, 10",
"bairro_partida": "Centro",
"cidade_partida": "Rio de Janeiro",
"estado_partida": "RJ",
"lat_desejado": -22.90789,
"lng_desejado": -43.177878,
"endereco_desejado": "Rua do Rosário, 320",
"bairro_desejado": "Centro",
"cidade_desejado": "Rio de Janeiro",
"estado_desejado": "RJ",
"multicategorias": true,
"latlng_paradas": "-22.904434,-43.175555|-22.912385,-43.226663",
"data": "2026-05-05",
"hora": "15:00:00"
}
'import requests
url = "https://api-vendas.taximachine.com.br/api/v2/integracao/corridas/programadas/estimativas"
payload = {
"lat_partida": -22.904445,
"lng_partida": -43.175508,
"endereco_partida": "Rua da Assembleia, 10",
"bairro_partida": "Centro",
"cidade_partida": "Rio de Janeiro",
"estado_partida": "RJ",
"lat_desejado": -22.90789,
"lng_desejado": -43.177878,
"endereco_desejado": "Rua do Rosário, 320",
"bairro_desejado": "Centro",
"cidade_desejado": "Rio de Janeiro",
"estado_desejado": "RJ",
"multicategorias": True,
"latlng_paradas": "-22.904434,-43.175555|-22.912385,-43.226663",
"data": "2026-05-05",
"hora": "15:00:00"
}
headers = {
"Authorization": "Basic <encoded-value>",
"api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
Authorization: 'Basic <encoded-value>',
'api-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
lat_partida: -22.904445,
lng_partida: -43.175508,
endereco_partida: 'Rua da Assembleia, 10',
bairro_partida: 'Centro',
cidade_partida: 'Rio de Janeiro',
estado_partida: 'RJ',
lat_desejado: -22.90789,
lng_desejado: -43.177878,
endereco_desejado: 'Rua do Rosário, 320',
bairro_desejado: 'Centro',
cidade_desejado: 'Rio de Janeiro',
estado_desejado: 'RJ',
multicategorias: true,
latlng_paradas: '-22.904434,-43.175555|-22.912385,-43.226663',
data: '2026-05-05',
hora: '15:00:00'
})
};
fetch('https://api-vendas.taximachine.com.br/api/v2/integracao/corridas/programadas/estimativas', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-vendas.taximachine.com.br/api/v2/integracao/corridas/programadas/estimativas",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'lat_partida' => -22.904445,
'lng_partida' => -43.175508,
'endereco_partida' => 'Rua da Assembleia, 10',
'bairro_partida' => 'Centro',
'cidade_partida' => 'Rio de Janeiro',
'estado_partida' => 'RJ',
'lat_desejado' => -22.90789,
'lng_desejado' => -43.177878,
'endereco_desejado' => 'Rua do Rosário, 320',
'bairro_desejado' => 'Centro',
'cidade_desejado' => 'Rio de Janeiro',
'estado_desejado' => 'RJ',
'multicategorias' => true,
'latlng_paradas' => '-22.904434,-43.175555|-22.912385,-43.226663',
'data' => '2026-05-05',
'hora' => '15:00:00'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json",
"api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api-vendas.taximachine.com.br/api/v2/integracao/corridas/programadas/estimativas"
payload := strings.NewReader("{\n \"lat_partida\": -22.904445,\n \"lng_partida\": -43.175508,\n \"endereco_partida\": \"Rua da Assembleia, 10\",\n \"bairro_partida\": \"Centro\",\n \"cidade_partida\": \"Rio de Janeiro\",\n \"estado_partida\": \"RJ\",\n \"lat_desejado\": -22.90789,\n \"lng_desejado\": -43.177878,\n \"endereco_desejado\": \"Rua do Rosário, 320\",\n \"bairro_desejado\": \"Centro\",\n \"cidade_desejado\": \"Rio de Janeiro\",\n \"estado_desejado\": \"RJ\",\n \"multicategorias\": true,\n \"latlng_paradas\": \"-22.904434,-43.175555|-22.912385,-43.226663\",\n \"data\": \"2026-05-05\",\n \"hora\": \"15:00:00\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api-vendas.taximachine.com.br/api/v2/integracao/corridas/programadas/estimativas")
.header("Authorization", "Basic <encoded-value>")
.header("api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"lat_partida\": -22.904445,\n \"lng_partida\": -43.175508,\n \"endereco_partida\": \"Rua da Assembleia, 10\",\n \"bairro_partida\": \"Centro\",\n \"cidade_partida\": \"Rio de Janeiro\",\n \"estado_partida\": \"RJ\",\n \"lat_desejado\": -22.90789,\n \"lng_desejado\": -43.177878,\n \"endereco_desejado\": \"Rua do Rosário, 320\",\n \"bairro_desejado\": \"Centro\",\n \"cidade_desejado\": \"Rio de Janeiro\",\n \"estado_desejado\": \"RJ\",\n \"multicategorias\": true,\n \"latlng_paradas\": \"-22.904434,-43.175555|-22.912385,-43.226663\",\n \"data\": \"2026-05-05\",\n \"hora\": \"15:00:00\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-vendas.taximachine.com.br/api/v2/integracao/corridas/programadas/estimativas")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"lat_partida\": -22.904445,\n \"lng_partida\": -43.175508,\n \"endereco_partida\": \"Rua da Assembleia, 10\",\n \"bairro_partida\": \"Centro\",\n \"cidade_partida\": \"Rio de Janeiro\",\n \"estado_partida\": \"RJ\",\n \"lat_desejado\": -22.90789,\n \"lng_desejado\": -43.177878,\n \"endereco_desejado\": \"Rua do Rosário, 320\",\n \"bairro_desejado\": \"Centro\",\n \"cidade_desejado\": \"Rio de Janeiro\",\n \"estado_desejado\": \"RJ\",\n \"multicategorias\": true,\n \"latlng_paradas\": \"-22.904434,-43.175555|-22.912385,-43.226663\",\n \"data\": \"2026-05-05\",\n \"hora\": \"15:00:00\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"estimativa_minutos": 30,
"estimativa_km": 13.99,
"categorias": [
{
"estimativa_valor": 40,
"categoria_nome": "Comum",
"tarifa_nome": "Tarifa padrão"
},
{
"estimativa_valor": 22,
"categoria_nome": "15 Reais",
"tarifa_nome": "Tarifa padrão"
}
]
}
}Corridas
Estimar corrida programada
Calcula estimativa de corrida programada a partir de data, hora e dados de origem e destino.
POST
/
corridas
/
programadas
/
estimativas
Estimar corrida programada
curl --request POST \
--url https://api-vendas.taximachine.com.br/api/v2/integracao/corridas/programadas/estimativas \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'api-key: <api-key>' \
--data '
{
"lat_partida": -22.904445,
"lng_partida": -43.175508,
"endereco_partida": "Rua da Assembleia, 10",
"bairro_partida": "Centro",
"cidade_partida": "Rio de Janeiro",
"estado_partida": "RJ",
"lat_desejado": -22.90789,
"lng_desejado": -43.177878,
"endereco_desejado": "Rua do Rosário, 320",
"bairro_desejado": "Centro",
"cidade_desejado": "Rio de Janeiro",
"estado_desejado": "RJ",
"multicategorias": true,
"latlng_paradas": "-22.904434,-43.175555|-22.912385,-43.226663",
"data": "2026-05-05",
"hora": "15:00:00"
}
'import requests
url = "https://api-vendas.taximachine.com.br/api/v2/integracao/corridas/programadas/estimativas"
payload = {
"lat_partida": -22.904445,
"lng_partida": -43.175508,
"endereco_partida": "Rua da Assembleia, 10",
"bairro_partida": "Centro",
"cidade_partida": "Rio de Janeiro",
"estado_partida": "RJ",
"lat_desejado": -22.90789,
"lng_desejado": -43.177878,
"endereco_desejado": "Rua do Rosário, 320",
"bairro_desejado": "Centro",
"cidade_desejado": "Rio de Janeiro",
"estado_desejado": "RJ",
"multicategorias": True,
"latlng_paradas": "-22.904434,-43.175555|-22.912385,-43.226663",
"data": "2026-05-05",
"hora": "15:00:00"
}
headers = {
"Authorization": "Basic <encoded-value>",
"api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
Authorization: 'Basic <encoded-value>',
'api-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
lat_partida: -22.904445,
lng_partida: -43.175508,
endereco_partida: 'Rua da Assembleia, 10',
bairro_partida: 'Centro',
cidade_partida: 'Rio de Janeiro',
estado_partida: 'RJ',
lat_desejado: -22.90789,
lng_desejado: -43.177878,
endereco_desejado: 'Rua do Rosário, 320',
bairro_desejado: 'Centro',
cidade_desejado: 'Rio de Janeiro',
estado_desejado: 'RJ',
multicategorias: true,
latlng_paradas: '-22.904434,-43.175555|-22.912385,-43.226663',
data: '2026-05-05',
hora: '15:00:00'
})
};
fetch('https://api-vendas.taximachine.com.br/api/v2/integracao/corridas/programadas/estimativas', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-vendas.taximachine.com.br/api/v2/integracao/corridas/programadas/estimativas",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'lat_partida' => -22.904445,
'lng_partida' => -43.175508,
'endereco_partida' => 'Rua da Assembleia, 10',
'bairro_partida' => 'Centro',
'cidade_partida' => 'Rio de Janeiro',
'estado_partida' => 'RJ',
'lat_desejado' => -22.90789,
'lng_desejado' => -43.177878,
'endereco_desejado' => 'Rua do Rosário, 320',
'bairro_desejado' => 'Centro',
'cidade_desejado' => 'Rio de Janeiro',
'estado_desejado' => 'RJ',
'multicategorias' => true,
'latlng_paradas' => '-22.904434,-43.175555|-22.912385,-43.226663',
'data' => '2026-05-05',
'hora' => '15:00:00'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json",
"api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api-vendas.taximachine.com.br/api/v2/integracao/corridas/programadas/estimativas"
payload := strings.NewReader("{\n \"lat_partida\": -22.904445,\n \"lng_partida\": -43.175508,\n \"endereco_partida\": \"Rua da Assembleia, 10\",\n \"bairro_partida\": \"Centro\",\n \"cidade_partida\": \"Rio de Janeiro\",\n \"estado_partida\": \"RJ\",\n \"lat_desejado\": -22.90789,\n \"lng_desejado\": -43.177878,\n \"endereco_desejado\": \"Rua do Rosário, 320\",\n \"bairro_desejado\": \"Centro\",\n \"cidade_desejado\": \"Rio de Janeiro\",\n \"estado_desejado\": \"RJ\",\n \"multicategorias\": true,\n \"latlng_paradas\": \"-22.904434,-43.175555|-22.912385,-43.226663\",\n \"data\": \"2026-05-05\",\n \"hora\": \"15:00:00\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api-vendas.taximachine.com.br/api/v2/integracao/corridas/programadas/estimativas")
.header("Authorization", "Basic <encoded-value>")
.header("api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"lat_partida\": -22.904445,\n \"lng_partida\": -43.175508,\n \"endereco_partida\": \"Rua da Assembleia, 10\",\n \"bairro_partida\": \"Centro\",\n \"cidade_partida\": \"Rio de Janeiro\",\n \"estado_partida\": \"RJ\",\n \"lat_desejado\": -22.90789,\n \"lng_desejado\": -43.177878,\n \"endereco_desejado\": \"Rua do Rosário, 320\",\n \"bairro_desejado\": \"Centro\",\n \"cidade_desejado\": \"Rio de Janeiro\",\n \"estado_desejado\": \"RJ\",\n \"multicategorias\": true,\n \"latlng_paradas\": \"-22.904434,-43.175555|-22.912385,-43.226663\",\n \"data\": \"2026-05-05\",\n \"hora\": \"15:00:00\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-vendas.taximachine.com.br/api/v2/integracao/corridas/programadas/estimativas")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"lat_partida\": -22.904445,\n \"lng_partida\": -43.175508,\n \"endereco_partida\": \"Rua da Assembleia, 10\",\n \"bairro_partida\": \"Centro\",\n \"cidade_partida\": \"Rio de Janeiro\",\n \"estado_partida\": \"RJ\",\n \"lat_desejado\": -22.90789,\n \"lng_desejado\": -43.177878,\n \"endereco_desejado\": \"Rua do Rosário, 320\",\n \"bairro_desejado\": \"Centro\",\n \"cidade_desejado\": \"Rio de Janeiro\",\n \"estado_desejado\": \"RJ\",\n \"multicategorias\": true,\n \"latlng_paradas\": \"-22.904434,-43.175555|-22.912385,-43.226663\",\n \"data\": \"2026-05-05\",\n \"hora\": \"15:00:00\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"estimativa_minutos": 30,
"estimativa_km": 13.99,
"categorias": [
{
"estimativa_valor": 40,
"categoria_nome": "Comum",
"tarifa_nome": "Tarifa padrão"
},
{
"estimativa_valor": 22,
"categoria_nome": "15 Reais",
"tarifa_nome": "Tarifa padrão"
}
]
}
}Authorizations
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Obrigatório. Sua chave API.
Body
application/json
Data da programação em YYYY-MM-DD.
Hora da programação.
Quando multicategorias é true, a API calcula a estimativa de múltiplas categorias.
Response
200 - application/json
Sucesso
The response is of type object.
⌘I
