Partilhar via

Tutorial: Migrar serviço Web do Google Maps

O Azure e o Google Maps fornecem acesso a APIs espaciais por meio de serviços Web REST. As interfaces API dessas plataformas executam funcionalidades semelhantes. Mas, cada um deles usa diferentes convenções de nomenclatura e objetos de resposta.

Este tutorial demonstra como:

  • Geocodificação direta e reversa
  • Procurar pontos de interesse
  • Calcular rotas e direções
  • Recuperar uma imagem do mapa
  • Calcular uma matriz de distância
  • Obter detalhes de fuso horário

Você também aprenderá:

  • Qual é o serviço REST do Azure Maps ao realizar a migração de um serviço Web do Google Maps?
  • Sugestões sobre como tirar o máximo partido dos serviços do Azure Maps
  • Informações sobre outros serviços relacionados do Azure Maps

A tabela mostra as APIs de serviço do Azure Maps, que têm uma funcionalidade semelhante às APIs de serviço do Google Maps listadas.

API do serviço Google Maps API de serviço do Azure Maps
Instruções Percurso
Matriz de Distância Matriz de Rotas Pós-distribuição
Geocodificação Procurar
Pesquisa de Locais Pesquisar
Lugar Autocomplete Procurar
Encaixe na estrada Consulte a seção Calcular rotas e direções .
Limites de velocidade Consulte a seção Geocodificação reversa de uma coordenada.
Mapa estático Composição
Fuso Horário Fuso horário

As seguintes APIs de serviço não estão atualmente disponíveis no Azure Maps:

  • Geolocalização - O Azure Maps tem um serviço chamado Geolocalização, que fornece informações de localização a partir de endereço IP, mas, atualmente, não oferece suporte a triangulação de torres de celular ou de WiFi.
  • Detalhes e fotos de locais - Os números de telefone e a URL do site estão disponíveis na API de Pesquisa do Azure Maps.
  • URLs de mapas
  • Estradas mais próximas - Alcançável usando o Web SDK, conforme demonstrado no exemplo básico de lógica para ajuste à estrada, mas não está disponível atualmente como um serviço.
  • Vista de rua estática

Pré-requisitos

Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.

Nota

Para obter mais informações sobre autenticação no Azure Maps, consulte Gerenciar autenticação no Azure Maps.

Endereços de geocodificação

Geocodificação é o processo de conversão de um endereço em uma coordenada. Por exemplo, "1 Microsoft way, Redmond, WA" converte para longitude: -122.1298, latitude: 47.64005. Em seguida, as coordenadas podem ser usadas para diferentes tipos de propósitos, tais como, posicionar um marcador centralizado em um mapa.

O Azure Maps fornece vários métodos para geocodificação de endereços:

  • Obter endereço de pesquisa: a geocodificação de endereço de forma livre é usada para especificar uma única cadeia de caracteres de endereço (como "1 Microsoft way, Redmond, WA") e processar a solicitação imediatamente. Este serviço é recomendado se você precisar geocodificar endereços individuais rapidamente.
  • Obter endereço de pesquisa estruturado: especifique as partes de um único endereço, como o nome da rua, cidade, país/região e código postal e processe a solicitação imediatamente. Essa API é recomendada se você precisar geocodificar endereços individuais rapidamente e os dados já estiverem analisados em suas partes de endereço individuais.
  • Post Search Address Batch: crie uma solicitação contendo até 10.000 endereços e faça com que eles sejam processados durante um período de tempo. Todos os endereços são geocodificados em paralelo no servidor e, quando concluído, o conjunto completo de resultados pode ser baixado. Isso é recomendado para geocodificar grandes conjuntos de dados.
  • Get Search Fuzzy: A API de pesquisa difusa combina geocodificação de endereços com pesquisa de pontos de interesse. Essa API usa uma cadeia de caracteres de forma livre que pode ser um endereço, local, ponto de referência, ponto de interesse ou categoria de ponto de interesse e processa a solicitação imediatamente. Esta API é recomendada para aplicações onde os utilizadores podem procurar endereços ou pontos de interesse a partir da mesma caixa de texto.
  • Post Search Fuzzy Batch: Use a pesquisa em lote difusa para criar uma solicitação contendo até 10.000 endereços, lugares, pontos de referência ou pontos de interesse e processá-los durante um período de tempo. Todos os dados são processados em paralelo no servidor e, quando concluído, o conjunto completo de resultados pode ser baixado.

A tabela a seguir faz referência cruzada aos parâmetros da API do Google Maps com os parâmetros de API comparáveis no Azure Maps.

Parâmetro da API do Google Maps Parâmetro comparável da API do Azure Maps
address query
bounds topLeft e btmRight
components streetNumber
streetName
crossStreet
postalCode
municipality - cidade / vila
municipalitySubdivision – bairro, sub / super cidade
countrySubdivision - Estado ou província
countrySecondarySubdivision - concelho
countryTertiarySubdivision - distrito
countryCode - código de país/região de duas letras
key subscription-key – Para obter mais informações, consulte Autenticação com o Azure Maps.
language language – Para obter mais informações, consulte Suporte de localização no Azure Maps.
region countrySet

Para obter mais informações sobre como usar o serviço de pesquisa, consulte Pesquisar um local usando os serviços de Pesquisa do Azure Maps. Certifique-se de revisar as práticas recomendadas para pesquisa.

Gorjeta

A geocodificação de endereços de forma livre e as APIs de pesquisa difusa podem ser usadas no modo de preenchimento automático adicionando &typeahead=true à URL da solicitação. Isso informará ao servidor que o texto de entrada provavelmente é parcial e a pesquisa entrará no modo preditivo.

Realizar geocodificação reversa de uma coordenada

A geocodificação reversa é o processo de conversão de coordenadas geográficas em um endereço aproximado. As coordenadas com "longitude: -122.1298, latitude: 47.64005" correspondem a "1 Microsoft Way, Redmond, WA".

O Azure Maps fornece vários métodos de geocodificação inversa:

  • Obter endereço de pesquisa reverso: especifique uma única coordenada geográfica para obter o endereço aproximado correspondente a essa coordenada. Processa o pedido quase em tempo real.
  • Obter endereço de pesquisa Reverse Cross Street: especifique uma única coordenada geográfica para obter informações sobre ruas cruzadas próximas e processe a solicitação imediatamente. Por exemplo, poderá receber as seguintes ruas transversais: 1.ª Avenida e Rua Principal.
  • Post Search Address Reverse Batch: crie uma solicitação contendo até 10.000 coordenadas e processe-as durante um período de tempo. Todos os dados são processados em paralelo no servidor. Quando a solicitação for concluída, você poderá baixar o conjunto completo de resultados.

Esta tabela faz referência cruzada aos parâmetros da API do Google Maps com os parâmetros de API comparáveis no Azure Maps.

Parâmetro da API do Google Maps Parâmetro comparável da API do Azure Maps
key subscription-key – Para obter mais informações, consulte Autenticação com o Azure Maps.
language language – Para obter mais informações, consulte Suporte de localização no Azure Maps.
latlng query
location_type N/D
result_type entityType

Para obter mais informações, consulte as práticas recomendadas de pesquisa.

A API de geocodificação reversa do Azure Maps tem alguns outros recursos, que não estão disponíveis no Google Maps. Esses recursos podem ser úteis para integração com seu aplicativo, à medida que você migra seu aplicativo:

  • Recuperar dados de limite de velocidade
  • Recuperar informações de uso da estrada: estrada local, arterial, acesso limitado, rampa e assim por diante
  • Recuperar o lado da rua em que uma coordenada está localizada

Procurar pontos de interesse

Os dados de pontos de interesse podem ser pesquisados no Google Maps usando a API de pesquisa de lugares. Esta API fornece três maneiras diferentes de pesquisar pontos de interesse:

  • Localizar local a partir do texto: pesquisa um ponto de interesse com base no nome, endereço ou número de telefone.
  • Pesquisa nas proximidades: pesquisa pontos de interesse que estão a uma certa distância de um local.
  • Pesquisa de texto: pesquisa lugares usando um texto de forma livre, que inclui informações de ponto de interesse e localização. Por exemplo, "pizza em Nova York" ou "restaurantes perto da rua principal".

O Azure Maps fornece várias APIs de pesquisa para pontos de interesse:

  • Obter POI de pesquisa: Pesquise pontos de interesse pelo nome. Por exemplo, "Starbucks".
  • Obter Categoria de Pesquisa de POI: Pesquisar pontos de interesse por categoria. Por exemplo, "restaurante".
  • Pesquisar nas proximidades: Pesquisas por pontos de interesse que estão a uma determinada distância de um local.
  • Get Search Fuzzy: A API de pesquisa difusa combina geocodificação de endereços com pesquisa de pontos de interesse. Essa API usa uma cadeia de caracteres de forma livre que pode ser um endereço, local, ponto de referência, ponto de interesse ou categoria de ponto de interesse e processa a solicitação imediatamente. Esta API é recomendada para aplicações onde os utilizadores podem procurar endereços ou pontos de interesse a partir da mesma caixa de texto.
  • Post Search Inside Geometry: Procure pontos de interesse que estejam dentro de uma geometria especificada. Por exemplo, pesquise um ponto de interesse dentro de um polígono.
  • Pesquisa ao longo da rota: pesquise pontos de interesse que estão ao longo de uma rota especificada.
  • Post Search Fuzzy Batch: Use a pesquisa em lote difusa para criar uma solicitação contendo até 10.000 endereços, lugares, pontos de referência ou pontos de interesse e processá-los durante um período de tempo. Todos os dados são processados em paralelo no servidor e, quando concluído, o conjunto completo de resultados pode ser baixado.

Atualmente, o Azure Maps não tem uma API comparável à API de Pesquisa de Texto no Google Maps.

Gorjeta

As APIs de pesquisa POI, pesquisa de categoria POI e pesquisa difusa podem ser usadas no modo de preenchimento automático adicionando &typeahead=true ao URL da solicitação. Isso informará ao servidor que o texto de entrada é provavelmente parcial. A API conduzirá a pesquisa no modo preditivo.

Para obter mais informações, consulte as práticas recomendadas de pesquisa.

Encontrar um lugar a partir do texto

Use o Azure Maps Get Search POI e Get Search Fuzzy para pesquisar pontos de interesse por nome ou endereço.

A tabela faz referência cruzada aos parâmetros da API do Google Maps com os parâmetros comparáveis da API do Azure Maps.

Parâmetro da API do Google Maps Parâmetro comparável da API do Azure Maps
fields N/A
input query
inputtype N/D
key subscription-key – Para obter mais informações, consulte Autenticação com o Azure Maps.
language language – Para obter mais informações, consulte Suporte de localização no Azure Maps.
locationbias lat, lon e radius
topLeft e btmRight
countrySet

Use a API Obter Pesquisa nas Proximidades para recuperar pontos de interesse próximos, no Azure Maps.

A tabela mostra os parâmetros da API do Google Maps com os parâmetros comparáveis da API do Azure Maps.

Parâmetro da API do Google Maps Parâmetro comparável da API do Azure Maps
key subscription-key – Para obter mais informações, consulte Autenticação com o Azure Maps.
keyword categorySet e brandSet
language language – Para obter mais informações, consulte Suporte de localização no Azure Maps.
location lat e lon
maxprice N/A
minprice N/D
name categorySet e brandSet
opennow N/D
pagetoken ofs e limit
radius radius
rankby N/D
type categorySet – Para obter mais informações, consulte Categorias de pesquisa suportadas.

Calcular rotas e direções

Calcule rotas e direções usando o Azure Maps. O Azure Maps tem muitas das mesmas funcionalidades que o serviço de roteamento do Google Maps, como:

  • Horários de chegada e partida.
  • Rotas de tráfego em tempo real e baseadas em predição.
  • Diferentes modos de transporte. Como dirigir, caminhar e andar de bicicleta.

Nota

O Azure Maps exige que todos os waypoints sejam coordenadas. Os endereços devem ser geocodificados primeiro.

O serviço de roteamento do Azure Maps fornece as seguintes APIs para calcular rotas:

  • Obter direções de rota: calcule uma rota e tenha a solicitação processada imediatamente. Esta API suporta tanto GET como POST solicitações. POST as solicitações são recomendadas ao especificar um grande número de pontos de passagem ou ao usar muitas das opções de rota para garantir que a solicitação de URL não se torne muito longa e cause problemas. A POST Direção de Rota no Azure Maps tem uma opção que aceita milhares de pontos de suporte e os usa para recriar um caminho de rota lógico entre eles (ajustar à estrada).
  • Post Route Directions Batch: crie uma solicitação contendo até 1.000 solicitações de rota e processe-as durante um período de tempo. Todos os dados são processados em paralelo no servidor e, quando concluído, o conjunto completo de resultados pode ser baixado.

A tabela faz referência cruzada aos parâmetros da API do Google Maps com os parâmetros de API comparáveis no Azure Maps.

Parâmetro da API do Google Maps Parâmetro comparável da API do Azure Maps
alternatives maxAlternatives
arrival_time arriveAt
avoid avoid
departure_time departAt
destination query – coordenadas no formato "lat0,lon0:lat1,lon1…."
key subscription-key – Para obter mais informações, consulte Autenticação com o Azure Maps.
language language – Para obter mais informações, consulte Suporte de localização no Azure Maps.
mode travelMode
optimize computeBestOrder
origin query
region N/D – Esta funcionalidade está relacionada com a geocodificação. Use o parâmetro countrySet ao usar a API de geocodificação do Azure Maps.
traffic_model N/D – Só pode especificar se os dados de tráfego devem ser usados com o parâmetro traffic .
units N/D – O Azure Maps usa apenas o sistema métrico.
waypoints query

Gorjeta

Por padrão, a API de Rota do Azure Maps retorna apenas um resumo. Ele retorna a distância e os tempos e as coordenadas para o caminho da rota. Use o parâmetro instructionsType para recuperar instruções passo a passo. E utilize o parâmetro routeRepresentation para filtrar o resumo e o caminho da rota.

A API de roteamento do Azure Maps tem outros recursos que não estão disponíveis no Google Maps. Ao migrar seu aplicativo, considere usar estes recursos:

  • Suporte para o tipo de rota: mais curto, mais rápido, trilling e mais eficiente em termos de combustível.
  • Suporte para outros modos de viagem: ônibus, motocicleta, táxi, caminhão e van.
  • Suporte para 150 pontos de passagem.
  • Calcule vários tempos de viagem num único pedido; Tráfego histórico, tráfego em tempo real, sem tráfego.
  • Evite outros tipos de estradas: estradas de carona, estradas não pavimentadas, estradas já usadas.
  • Especifique áreas personalizadas a serem evitadas.
  • Limite a elevação que o percurso pode subir.
  • Rota baseada nas especificações do motor. Calcule rotas para veículos a combustão ou elétricos com base nas especificações do motor e no combustível ou carga restantes.
  • Suporte a parâmetros de rota de veículos comerciais. Como dimensões do veículo, peso, número de eixos e tipo de carga.
  • Especificar a velocidade máxima do veículo.

Além disso, o serviço de rotas no Azure Maps dá suporte ao Obter Intervalo de Rota. O cálculo de intervalos roteáveis também é conhecido como isocronas. Implica gerar um polígono cobrindo uma área que pode ser viajada em qualquer direção a partir de um ponto de origem. Tudo dentro de uma quantidade especificada de tempo ou de combustível ou carga elétrica.

Para obter mais informações, consulte Práticas recomendadas para roteamento.

Recuperar uma imagem do mapa

O Azure Maps fornece uma API para renderizar as imagens de mapa estático com dados sobrepostos. A API Get Map Static Image no Azure Maps é comparável à API de mapa estático no Google Maps.

Nota

O Azure Maps exige que o centro, todos os marcadores e as localizações do percurso estejam em coordenadas no formato "longitude, latitude". Enquanto o Google Maps usa o formato "latitude, longitude". Os endereços precisarão ser geocodificados primeiro.

A tabela faz referência cruzada aos parâmetros da API do Google Maps com os parâmetros de API comparáveis no Azure Maps.

Parâmetro da API do Google Maps Parâmetro comparável da API do Azure Maps
center center
format format – especificado como parte do caminho da URL. Atualmente apenas PNG suportado.
key subscription-key – Para obter mais informações, consulte Autenticação com o Azure Maps.
language language – Para obter mais informações, consulte Suporte de localização no Azure Maps.
maptype layer e style – Para obter mais informações, consulte Estilos de mapa suportados.
markers pins
path path
region N/D – Uma característica relacionada com geocodificação. Use o countrySet parâmetro ao usar a API de geocodificação do Azure Maps.
scale N/D
size width e height – O tamanho máximo é 8192 x 8192.
style N/D
visible N/D
zoom zoom

Nota

No sistema de mosaicos do Azure Maps, os mosaicos têm o dobro do tamanho dos mosaicos de mapa utilizados no Google Maps. Como tal, o valor do nível de zoom no Azure Maps aparecerá um nível de zoom mais próximo no Azure Maps em comparação com o Google Maps. Para compensar essa diferença, diminua o nível de zoom nas solicitações que você está migrando.

Para obter mais informações, consulte Representar dados personalizados num mapa raster.

Além de poder gerar uma imagem de mapa estática, o serviço Azure Maps Render permite o acesso direto de blocos de mapa em formato raster (PNG) e vetorial:

  • Obter imagem estática do mapa: recupere blocos raster (PNG) e vetoriais para os mapas base (estradas, limites, plano de fundo).
  • Obter mosaico de mapa: Recupere mosaicos de imagens aéreas e de satélite.

Gorjeta

Muitos aplicativos do Google Maps foram trocados de experiências de mapas interativos para imagens de mapas estáticos há alguns anos. Isto foi feito como um método de redução de custos. No Azure Maps, geralmente é mais econômico usar o controle de mapa interativo no SDK da Web. As tarifas pelo controlo do mapa interativo baseiam-se no número de carregamentos de blocos. Os blocos de mapa no Azure Maps são grandes. Muitas vezes, são necessários apenas alguns blocos para recriar a mesma visualização de mapa que um mapa estático. Os blocos de mapa são armazenados em cache automaticamente pelo navegador. Como tal, o controle de mapa interativo geralmente gera uma fração de uma transação ao reproduzir uma visualização de mapa estático. Panorama e zoom carregarão mais blocos; no entanto, há opções no controlo do mapa para desativar esse comportamento. O controle de mapa interativo também fornece muito mais opções de visualização do que os serviços de mapa estático.

Comparação de formato de parâmetro de URL do marcador

Antes: Google Maps

Adicione marcadores usando o markers parâmetro na URL. O markers parâmetro leva em um estilo e uma lista de locais a serem renderizados no mapa com esse estilo, como mostrado abaixo:

&markers=markerStyles|markerLocation1|markerLocation2|...

Para adicionar outros estilos, use os parâmetros markers no URL com um estilo diferente e um conjunto de localizações.

Especifique os locais dos marcadores com o formato "latitude,longitude".

Adicione estilos de marcador com o optionName:value formato, com vários estilos separados por caracteres pipe (|) como este "optionName1:value1|optionName2:value2". Observe que os nomes e valores das opções são separados por dois pontos (:). Use a seguinte opção de nomes de estilo para definir o estilo dos marcadores no Google Maps:

  • color – A cor do ícone do marcador padrão. Pode ser uma cor hexadecimal de 24 bits (0xrrggbb) ou um dos seguintes valores; black, brown, green, purple, yellow, blue, grayorangeredwhite.
  • label – Um único caractere alfanumérico maiúsculo para exibir na parte superior do ícone.
  • size - O tamanho do marcador. Pode ser tiny, mid, ou small.

Use os seguintes nomes de opções de estilo para ícones personalizados no Google Maps:

  • anchor – Especifica como alinhar a imagem do ícone à coordenada. Pode ser um valor de pixel (x,y) ou um dos seguintes valores; top, bottom, , left, right, centertopleft, topright, bottomleft, ou bottomright.
  • icon – Um URL apontando para a imagem do ícone.

Por exemplo, vamos adicionar um marcador vermelho de tamanho médio ao mapa em longitude: -110, latitude: 45:

&markers=color:red|size:mid|45,-110

Marcador do Google Maps

Depois: Azure Maps

Adicione marcadores a uma imagem de mapa estático especificando o pins parâmetro na URL. Como o Google Maps, especifique um estilo e uma lista de locais no parâmetro. O pins parâmetro pode ser especificado várias vezes para suportar marcadores com estilos diferentes.

&pins=iconType|pinStyles||pinLocation1|pinLocation2|...

Para usar outros estilos, adicione parâmetros extras pins ao URL com um estilo e um conjunto de locais diferentes.

No Azure Maps, a localização do pino precisa estar no formato "longitude, latitude". O Google Maps usa o formato "latitude, longitude". Um espaço, não uma vírgula, separa longitude e latitude no formato do Azure Maps.

O iconType indica o tipo de pino a criar. Pode ter os seguintes valores:

  • default – O ícone de pino padrão.
  • none – Nenhum ícone é exibido, apenas etiquetas são renderizadas.
  • custom – Especifica que um ícone personalizado deve ser usado. Um URL apontando para a imagem do ícone pode ser adicionado ao final do parâmetro após as pins informações de localização do pino.

Adicione estilos de pino com o optionNameValue formato. Separe vários estilos com os caracteres pipe (|). Por exemplo: iconType|optionName1Value1|optionName2Value2. Os nomes e valores das opções não são separados. Use os seguintes nomes de opção de estilo para marcadores de estilo:

  • al – Especifica a opacidade (alfa) do marcador. Escolha um número entre 0 e 1.
  • an – Especifica a âncora do pino. Especifique os valores de pixel X e Y no formato "x y".
  • co – A cor do alfinete. Especifique uma cor hexadecimal de 24 bits: 000000 para FFFFFF.
  • la – Especifica a âncora do rótulo. Especifique os valores de pixel X e y no formato "x y".
  • lc – A cor do rótulo. Especifique uma cor hexadecimal de 24 bits: 000000 para FFFFFF.
  • ls – O tamanho da etiqueta em pixels. Escolha um número maior que 0.
  • ro – Um valor em graus para girar o ícone. Escolha um número entre -360 e 360.
  • sc – Um valor de escala para o ícone de pino. Escolha um número maior que 0.

Especifique valores de rótulo para cada localização do pino. Essa abordagem é mais eficiente do que aplicar um único valor de rótulo a todos os marcadores na lista de locais. O valor do rótulo pode ser uma cadeia de caracteres de vários caracteres. Envolva o texto com aspas simples para garantir que não seja confundido com um valor de estilo ou localização.

Vamos adicionar um ícone vermelho (FF0000) padrão, com o rótulo "Space Needle", posicionado abaixo (15 50). O ícone está na longitude: -122.349300, latitude: 47.620180:

&pins=default|coFF0000|la15 50||'Space Needle' -122.349300 47.620180

Marcador do Azure Maps

Adicione três pinos com os valores do rótulo '1', '2' e '3':

&pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12

Azure Maps vários marcadores

Comparação do formato de parâmetro de URL do caminho

Antes: Google Maps

Adicione linhas e polígono a uma imagem de mapa estático usando o path parâmetro no URL. O path parâmetro aceita um estilo e uma lista de locais a serem renderizados no mapa.

&path=pathStyles|pathLocation1|pathLocation2|...

Use outros estilos adicionando parâmetros extras path ao URL com um estilo e um conjunto de locais diferentes.

Os locais dos caminhos são especificados com o latitude1,longitude1|latitude2,longitude2|… formato. Os caminhos podem ser codificados ou conter endereços para pontos.

Adicione estilos de caminho com o formato optionName:value, separando vários estilos pelos caracteres de barra vertical (|). Separe também nomes e valores de opção com dois pontos (:). Por exemplo: optionName1:value1|optionName2:value2. Os seguintes nomes de opções de estilo podem ser usados para definir o estilo de caminhos no Google Maps:

  • color – A cor do contorno do caminho ou polígono. Pode ser uma cor hexadecimal de 24 bits (0xrrggbb), uma cor hexadecimal de 32 bits (0xrrggbbbaa) ou um dos seguintes valores: preto, marrom, verde, roxo, amarelo, azul, cinza, laranja, vermelho, branco.
  • fillColor – A cor para preencher a área do caminho com (polígono). Pode ser uma cor hexadecimal de 24 bits (0xrrggbb), uma cor hexadecimal de 32 bits (0xrrggbbbaa) ou um dos seguintes valores: preto, marrom, verde, roxo, amarelo, azul, cinza, laranja, vermelho, branco.
  • geodesic – Indica se o caminho deve ser uma linha que segue a curvatura da terra.
  • weight – A espessura da linha de caminho em pixels.

Adicione uma opacidade de linha vermelha e espessura de pixel ao mapa entre as coordenadas, no parâmetro URL. Para o exemplo a seguir, a linha tem uma opacidade de 50% e uma espessura de quatro pixels. As coordenadas são longitude: -110, latitude: 45 e longitude: -100, latitude: 50.

&path=color:0xFF000088|weight:4|45,-110|50,-100

Polilinha do Google Maps

Depois: Azure Maps

Adicione linhas e polígonos a uma imagem de mapa estático especificando o path parâmetro na URL. Como o Google Maps, especifique um estilo e uma lista de locais nesse parâmetro. Especifique o path parâmetro várias vezes para renderizar vários círculos, linhas e polígonos com estilos diferentes.

&path=pathStyles||pathLocation1|pathLocation2|...

Quando se trata de locais de caminho, o Azure Maps exige que as coordenadas estejam no formato "longitude, latitude". O Google Maps usa o formato "latitude, longitude". Um espaço, não uma vírgula, separa longitude e latitude no formato do Azure Maps. O Azure Maps não suporta caminhos ou endereços codificados para pontos.

Adicione estilos de caminho com o formato optionNameValue. Separe vários estilos por caracteres de barra vertical (|), como este optionName1Value1|optionName2Value2. Os nomes e valores das opções não são separados. Use os seguintes nomes de opção de estilo para estilizar caminhos no Azure Maps:

  • fa - A opacidade da cor de preenchimento (alfa) usada ao renderizar polígonos. Escolha um número entre 0 e 1.
  • fc - A cor de preenchimento usada para renderizar a área de um polígono.
  • la – A opacidade da cor da linha (alfa) usada ao renderizar linhas e o contorno de polígonos. Escolha um número entre 0 e 1.
  • lc – A cor da linha usada para renderizar linhas e o contorno de polígonos.
  • lw – A largura da linha em pixels.
  • ra – Especifica um raio de círculos em metros.

Adicione uma opacidade de linha vermelha e espessura de pixel entre as coordenadas, no parâmetro URL. Para o exemplo a seguir, a linha tem 50% de opacidade e uma espessura de quatro pixels. As coordenadas têm os seguintes valores: longitude: -110, latitude: 45 e longitude: -100, latitude: 50.

&path=lcFF0000|la.5|lw4||-110 45|-100 50

Azure Maps polyline

Calcular uma matriz de distância

O Azure Maps fornece a API da matriz de distância. Use esta API para calcular os tempos de viagem e as distâncias entre um conjunto de locais, com uma matriz de distância. É comparável à API da matriz de distância no Google Maps.

  • Post Route Matrix: Calcula assíncronamente os tempos de viagem e as distâncias para um conjunto de pontos de partida e destino. Suporta até 700 células por solicitação. Esse é o número de origens multiplicado pelo número de destinos. Com essa restrição em mente, exemplos de dimensões matriciais possíveis são: 700x1, 50x10, 10x10, 28x25, 10x70.

Nota

Uma solicitação para a API da matriz de distância só pode ser feita usando uma POST solicitação com as informações de origem e destino no corpo da solicitação. Além disso, o Azure Maps exige que todas as origens e destinos sejam coordenadas. Os endereços precisarão ser geocodificados primeiro.

Esta tabela faz referência cruzada aos parâmetros da API do Google Maps com os parâmetros comparáveis da API do Azure Maps.

Parâmetro da API do Google Maps Parâmetro comparável da API do Azure Maps
arrival_time arriveAt
avoid avoid
departure_time departAt
destinations destination – especificar no corpo da POST solicitação como GeoJSON.
key subscription-key – Para obter mais informações, consulte Autenticação com o Azure Maps.
language language – Para obter mais informações, consulte Suporte de localização no Azure Maps.
mode travelMode
origins origins – especificar no corpo do POST pedido como GeoJSON.
region N/D – Esta funcionalidade está relacionada com a geocodificação. Use o countrySet parâmetro ao usar a API de geocodificação do Azure Maps.
traffic_model N/D – Só pode especificar se os dados de tráfego devem ser usados com o traffic parâmetro.
transit_mode N/D - Matrizes de distância baseadas em trânsito não são suportadas no momento.
transit_routing_preference N/D - Matrizes de distância baseadas em trânsito atualmente não são suportadas.
units N/D – O Azure Maps usa apenas o sistema métrico.

Gorjeta

Todas as opções avançadas de roteamento disponíveis na API de roteamento do Azure Maps são suportadas na API de matriz de distância do Azure Maps. As opções avançadas de roteamento incluem: roteamento de caminhão, especificações do motor e assim por diante.

Para obter mais informações, consulte Práticas recomendadas para roteamento.

Obter um fuso horário

O Azure Maps fornece uma API para recuperar o fuso horário de uma coordenada. A API de fuso horário do Azure Maps é comparável à API de fuso horário no Google Maps:

Esta tabela faz referência cruzada aos parâmetros da API do Google Maps com os parâmetros de API comparáveis no Azure Maps.

Parâmetro da API do Google Maps Parâmetro comparável da API do Azure Maps
key subscription-key – Para obter mais informações, consulte Autenticação com o Azure Maps.
language language – Para obter mais informações, consulte Suporte de localização no Azure Maps.
location query
timestamp timeStamp

Além dessa API, o Azure Maps fornece muitas APIs de fuso horário. Essas APIs convertem a hora com base nos nomes ou IDs do fuso horário:

Bibliotecas de cliente

O Azure Maps fornece bibliotecas de cliente para as seguintes linguagens de programação:

Estas bibliotecas de cliente de código aberto são para outras linguagens de programação:

Limpar recursos

Não há recursos a serem limpos.

Próximos passos

Saiba mais sobre os serviços REST do Azure Maps:

Práticas recomendadas para pesquisa