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

Desenvolvedores do Espaço Econômico Europeu (EEE)

A API Routes foi lançada como Acesso antecipado (pré-GA) em setembro de 2022. Os produtos e recursos em pré-GA são cobertos 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 em GA adiciona os seguintes novos recursos que não foram incluídos na prévia:

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

    • Strings de endereço ("Chicago, IL" ou "Darwin, NT, Austrália")

      Geralmente, é assim que um usuário insere um endereço. No entanto, o {product_name} precisa primeiro geocodificar a string de endereço internamente para convertê-la em coordenadas de latitude/longitude antes de calcular um trajeto.

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

    • Plus Codes

      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 e números de ruas, os Plus Codes são baseados em latitude e longitude e são mostrados como números e letras.

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

Mudanças nos recursos em fase de pré-lançamento atuais

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

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

  • Defina o novo parâmetro de solicitação de matriz extraComputations para ativar esses recursos.
  • Defina uma máscara de campo para especificar as informações que serão retornadas 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 definindo extraComputations:

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

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

  • routes.legs.travelAdvisory.tollInfo(informações sobre pedágio)
  • 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 sobre pedágios, consumo de combustível ou trânsito em uma polilinha, defina o novo campo de matriz de solicitação, extraComputations, para incluir um ou mais dos seguintes valores: