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

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

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 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évia para a versão GA.

Novos recursos adicionados à versão GA

A versão GA adiciona os seguintes novos recursos que não foram incluídos na prévia:

  • Além dos IDs de lugares 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")

      As strings de endereço são geralmente a forma como 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 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 geocodingResults matriz. Para cada local na solicitação (origem, destino ou ponto de referência intermediário) 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 do lugar correspondente a um local, além de metadados adicionais 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évia 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évia, você usou uma máscara de campo para especificar o retorno de informações para esses recursos na resposta. Agora, é necessário:

  • Definir o novo parâmetro de solicitação de matriz extraComputations para ativar esses recursos.
  • Definir 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 computeRouteMatrix a menos que sejam ativados explicitamente definindo extraComputations:

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

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

  • routes.legs.travelAdvisory.tollInfo(informações de pedágio)
  • routes.travelAdvisory.tollInfo(informações de pedágio)
  • routes.travelAdvisory.fuelConsumptionMicroliters(consumo de combustível)
  • routes.travelAdvisory.speedReadingIntervals(trânsito em uma polilinha)
  • routes.legs.travelAdvisory.speedReadingIntervals(trânsito em uma polilinha)

O que eu preciso fazer?

Para receber os campos de resposta para informações de pedágio, 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: