Migrar da versão de pré-lançamento

A API Routes foi lançada como uma prévia pública (pré-GA) em setembro de 2022. As Soluções pré-GA são cobertas pelos Termos de Serviço específicos da Plataforma Google Maps. Para mais informações, consulte as descrições da fase de lançamento.

Esta seção descreve como migrar um app da versão de pré-lançamento para a versão GA.

Novos recursos adicionados à versão GA

A versão GA adiciona os seguintes novos recursos que não estavam incluídos na pré-visualização:

  • Além dos IDs de lugar e das coordenadas de latitude/longitude, agora é possível especificar um local na versão do GA usando:

    • Strings de endereço ("Chicago, IL" ou "Darwin, NT, Australia")

      As strings de endereço geralmente são a forma como um usuário insere um endereço. No entanto, {product_name} precisa primeiro geocodificar a string de endereço internamente para convertê-la em coordenadas de latitude/longitude antes de calcular uma rota.

      Além disso, o suporte ao parâmetro de solicitação regionCode foi adicionado, o que permite especificar a devolução de resultados geocodificados para uma região geográfica específica.

    • Códigos Plus

      Os Plus Codes são como endereços para pessoas ou lugares que não têm um endereço real. Em vez de endereços com nomes de rua e números, os Plus Codes são baseados em latitude e longitude e são exibidos como números e letras.

  • A resposta de rotas de computação agora contém a matriz geocodingResults. Para cada local na solicitação (origem, destino ou ponto de passagem intermediário) especificado como uma string de endereço ou um Plus Code, a API realiza uma pesquisa de ID de lugar. Cada elemento dessa matriz contém o ID do lugar correspondente a um local, além de outros metadados sobre o local. Os locais na solicitação especificados como um ID de lugar ou como coordenadas de latitude/longitude são ignorados.

Mudanças nos recursos de pré-lançamento

Agora, é necessário ativar explicitamente os seguintes recursos no GA, adicionando o novo campo extraComputations de matriz à solicitação:

Na versão de pré-lançamento, você usou uma máscara de campo para especificar o retorno de informações desses recursos na resposta. Agora, você precisa:

  • Defina o novo parâmetro de solicitação de matriz extraComputations para ativar esses recursos.
  • Defina uma máscara de campo para especificar o retorno das informações na resposta.

O que preciso saber?

Os campos a seguir não serão mais incluídos nas respostas de computeRouteMatrix, a menos que sejam ativados explicitamente com a configuração extraComputations:

  • travelAdvisory.tollInfo (informações sobre pedágios)

Os campos a seguir não serão mais incluídos nas respostas de computeRoutes, a menos que sejam explicitamente ativados com a configuração extraComputations:

  • routes.legs.travelAdvisory.tollInfo(informações sobre pedágios)
  • routes.travelAdvisory.tollInfo(informações sobre pedágios)
  • routes.travelAdvisory.fuelConsumptionMicroliters(Consumo de combustível)
  • routes.travelAdvisory.speedReadingIntervals(Tráfego em uma polilinha)
  • routes.legs.travelAdvisory.speedReadingIntervals(Tráfego em uma polilinha)

O que eu preciso fazer?

Para receber os campos de resposta com informações de pedágio, consumo de combustível ou tráfego em uma poligonal, defina o novo campo de matriz de solicitação, extraComputations, para incluir um ou mais dos seguintes valores: