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

A API Routes foi lançada como um pré-lançamento público (pré-GA) em setembro de 2022. Todos os produtos 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 de disponibilidade GA.

Novos recursos adicionados à versão de disponibilidade geral

A versão de disponibilidade geral adiciona estes novos recursos que não foram incluídos no pré-lançamento:

  • Além dos IDs de lugares e coordenadas de latitude/longitude, agora você pode especificar um local na versão do GA usando:

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

      As strings de endereço geralmente são 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 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 têm como base a latitude e a longitude e são exibidos como números e letras.

  • A resposta de rotas do Compute agora contém a matriz geocodingResults. A API executa uma pesquisa de ID de lugar para cada local na solicitação (origem, destino ou waypoint intermediário) especificado como uma string de endereço ou um Plus code. Cada elemento dessa matriz contém o ID de 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 coordenadas de latitude/longitude são ignorados.

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

Agora, você precisa ativar explicitamente os seguintes recursos no 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 o retorno de informações sobre esses recursos na resposta. Agora é preciso fazer o seguinte:

  • Defina o novo parâmetro de solicitação da matriz extraComputations para ativar esses recursos.
  • Defina uma máscara de campo a ser especificada para retornar as informações na resposta.

O que eu preciso saber?

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

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

Os campos a seguir não serão mais incluídos nas respostas do computeRoutes, a menos que sejam explicitamente ativados pela configuração de 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 de informações sobre pedágio, consumo de combustível ou trânsito em uma polilinha, defina o novo campo de matriz da solicitação, extraComputations, para incluir um ou mais dos seguintes valores: