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 versão em disponibilidade geral.

Novos recursos adicionados à versão GA

A versão de GA adiciona os seguintes novos recursos que não foram incluídos no pré-lançamento:

  • Além dos IDs de lugar e das 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 são muitas vezes 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 uma rota.

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

    • Plus Codes

      Plus Codes são como endereços para pessoas ou lugares que não têm um endereço real. Em vez de nomes e números, os Plus Codes têm como base a latitude e a longitude e são mostrados como números e letras.

  • A resposta de rotas de computação agora contém a matriz geocodingResults. A API realiza uma pesquisa de ID de lugar para cada local da solicitação (origem, destino ou waypoint intermediário) especificado como uma string de endereço ou como um Plus Code. 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 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 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 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 computeRouteMatrix, a menos que sejam explicitamente ativados 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 sobre informações de pedágio, consumo de combustível ou tráfego em uma polilinha, defina o novo campo de matriz de solicitação, extraComputations, para incluir um ou mais dos seguintes valores: