Anunciamos novas APIs para rotas, locais e mapas do Amazon Location Service

Hoje, Serviço de localização da Amazon lançou 17 APIs novas e aprimoradas que expandem e melhoram os recursos para o Rotas, Lugarese Mapas funcionalidades, criando uma experiência mais coesa e simplificada para os desenvolvedores. Ao introduzir recursos aprimorados e oferecer migração simplificada, essas atualizações tornam o Amazon Location Service mais acessível e útil para uma ampla variedade de aplicações.

Agora você pode acessar otimização avançada de rotas, cálculos de custos de pedágio, captura de rastreamentos de GPS e uma variedade de estilos de mapa com opções de renderização estática e dinâmica, além de realizar pesquisas baseadas em proximidade e sugestões preditivas, com informações ricas e detalhadas sobre pontos de interesse.

Na Amazon, a grande maioria dos nossos roteiros é orientada pelo suggestions dos clientes. Muitos clientes que criam aplicativos com o Amazon Location Service compartilharam que precisam de APIs específicas e detalhes mais granulares, como informações de contato e horário comercial, ao trabalhar com dados baseados em localização. Embora o conjunto atual de APIs forneça ferramentas valiosas para muitos clientes, os desenvolvedores expressaram o desejo de recursos adicionais, como planejamento detalhado de rotas, pesquisas baseadas em proximidade, detalhes adicionais de locais e imagens de mapas estáticos. Essas novas APIs atendem a essas solicitações e fornecem uma solução de localização mais abrangente e pronta para uso.

Capacidades novas e aprimoradas
O lançamento de hoje apresenta 10 APIs atualizadas e sete APIs totalmente novas, respondendo diretamente aos seus comentários. Cada serviço – Rotas, Locais e Mapas – recebe melhorias específicas projetadas para oferecer suporte a uma gama mais ampla de casos de uso.

Rotas
A API Amazon Location Routes agora oferece suporte a opções avançadas de planejamento e personalização de rotas, permitindo aos usuários:

• CalculateIsolines para identificar áreas de serviço dentro de um tempo ou distância de viagem específico
• OptimizeWaypoints para determinar a sequência mais eficiente de pontos de referência, ajudando a minimizar o tempo ou a distância de viagem
• Calcule os custos de pedágio para fornecer estimativas precisas de custos para rotas que envolvem estradas com pedágio
• SnapToRoadspara permitir a correspondência precisa de traços de GPS, ajustando pontos à rede rodoviária

Com esses recursos, você pode criar experiências de rota mais precisas e dinâmicas para seus usuários. Por exemplo, uma empresa de logística poderia otimizar as rotas dos motoristas em tempo actual, tendo em conta o tráfego em tempo actual e minimizando os custos de viagem para entregas.

Mapas
A API atualizada do Amazon Location Maps inclui mais estilos de mapas específicos criados por cartógrafos qualificados. Esses estilos de mapa oferecem designs profissionais que aceleram o tempo de lançamento no mercado e eliminam a necessidade de criação de mapas personalizados. Além disso, o recurso Static Map Picture permite que os desenvolvedores integrem mapas estáticos dentro dos aplicativos, reduzindo a necessidade de streaming contínuo de dados e melhorando o desempenho em casos de uso onde a interatividade não é necessária.

Os principais recursos da API do Google Maps incluem:

• GetTilepara baixar um bloco de um conjunto de blocos, com valores de eixo X, Y e Z especificados
• GetStyleDescriptorpara retornar informações sobre o estilo
• GetStaticMapque permite a renderização de mapas não interativos para fins de relatórios ou visualização

Lugares
Os aprimoramentos da API Amazon Location Locations permitem recursos de pesquisa mais detalhados, atendendo a solicitações de maior granularidade nos dados de localização. Os novos recursos incluem:

• SearchNearby e Autocompleteque oferece suporte a consultas baseadas em proximidade e habilita recursos de previsão de texto para melhores experiências do usuário
• Detalhes comerciais aprimorados com categorias como horário comercial, informações de contato e atributos adicionais para pontos de interesse

Esses recursos são especialmente úteis para aplicações onde os usuários precisam de informações detalhadas sobre locais próximos, como serviços de entrega de alimentos ou aplicações de varejo. Think about que um cliente abra um aplicativo de entrega de comida, pesquise restaurantes próximos usando SearchNearbye recupera detalhes do restaurante, como horário comercial e informações de contato, para confirmar a disponibilidade. Depois que vários pedidos de entrega são atribuídos a um motorista, o aplicativo usa OptimizeWaypoints para sugerir a rota mais eficiente para coletas e entregas. À medida que o motorista segue a rota, SnaptoRoads fornece visualização precisa de sua localização, aprimorando a experiência de rastreamento em tempo actual do cliente.

Serviço de localização aprimorado em ação
Chamar a API é simples. Você pode usar o Interface de linha de comando da AWS (AWS CLI)um de nossos SDKs da AWSou a API REST simples. No entanto, exibir as informações em um mapa em um aplicativo internet ou móvel requer algumas configurações adicionais. Embora o processo esteja bem documentado, é detalhado demais para ser abordado completamente aqui. Nesta demonstração, vou me concentrar no uso da API.

O Amazon Location Service permite que chamadas de API sejam autenticadas de duas maneiras: por meio da autenticação de API da AWS (Autenticação AWS Sigv4) ou por meio de chaves de API. As chaves de API podem ser mais convenientes para desenvolvedores de aplicativos móveis onde o usuário ultimate não está autenticado ou durante a integração com Amazon Cognito não é viável. Este é o método de autenticação recomendado para aplicativos front-end.

Para demonstrar a versatilidade das APIs e a facilidade de integração em seus aplicativos, uso uma combinação de AWS CLI, cURL e um cliente gráfico de API REST para cada etapa da demonstração.

Etapa 1: crie uma chave de API

Primeiro, crio uma chave de API para meu aplicativo usando a AWS CLI. Você também pode gerenciar chaves de API no Console de gerenciamento da AWS.

REGION=eu-central-1
KEYNAME=geo-key-seb

aws location create-key --region ${REGION} --key-name ${KEYNAME} --restrictions 
AllowActions="geo-routes:*","geo-places:*","geo-maps:*",
AllowResources="arn:aws:geo-routes:${REGION}::supplier/default",
"arn:aws:geo-places:${REGION}::supplier/default",
"arn:aws:geo-maps:${REGION}::supplier/default" 
--no-expiry 

{
    "Key": "v1.public.ey...cy",
    "KeyArn": "arn:aws:geo:eu-central-1:02345678901:api-key/geo-key-seb",
    "KeyName": "geo-key-seb",
    "CreateTime": "2024-09-29T09:35:53.115000+00:00"
}

Este comando gera a chave de API, que agora posso usar para chamar APIs de localização da Amazon.

Passo 2: Obtenha coordenadas geográficas

A seguir, eu uso cURL para recuperar as coordenadas geográficas (um longitude e latitude) para o centro da cidade de Lille, França, ligando para GeoCode e passando um endereço no QueryText parâmetro.

$ curl --silent -X "POST" "https://locations.geo.eu-central-1.amazonaws.com/v2/geocode?key=v1.public.ey...cy" 
       -d $'{ "QueryText": "Grand Place, Lille, France" }' 
 
{"ResultItems":({"PlaceId":"AQ...5U","PlaceType":"Road","Title":"Grand'Place, 59800 Lille, France",
                 "Deal with":{"Label":"Grand'Place, 59800 Lille, France",
                 "Nation":{"Code2":"FR","Code3":"FRA","Title":"France"},
                 "Area":{"Code":"HDF","Title":"Hauts-de-France"},"SubRegion":{"Title":"Nord"},
                 "Locality":"Lille","District":"Centre","PostalCode":"59800",
                 "Road":"Grand'Place","StreetComponents":({"BaseName":"Grand'Place","Language":"fr"})},
                 "Place":(3.06361,50.63706),
                 "MapView":(3.0628,50.6367,3.06413,50.63729),
                 "MatchScores":{"Total":1,"Parts":{"Deal with":{"Nation":1,"Locality":1,"Intersection":(1)}}}})}

Isso retorna vários pontos de dados, incluindo as coordenadas GPS do centro da cidade: (3.06361, 50.63706).

Etapa 3: pesquise lugares próximos

Usando as coordenadas recuperadas, uso uma ferramenta cliente REST API para chamar o SearchNearby API para encontrar locais de interesse no centro da cidade de Lille.

No lado direito da tela, posso ler a resposta da API: uma lista de locais próximos, como restaurantes, bancos e áreas de estacionamento. Posso refinar ainda mais a pesquisa especificando categorias ou restringindo a área de pesquisa.

O SearchNearby API aceita um opcional Filter parâmetro que ajuda a restringir a pesquisa dentro de uma caixa delimitadora ou a incluir ou excluir cadeias de negócios, categorias, países ou tipos de alimentos.

"Filter": {
   "BoundingBox": ( quantity ),
   "ExcludeBusinessChains": ( "string" ),
   "ExcludeCategories": ( "string" ),
   "ExcludeFoodTypes": ( "string" ),
   "IncludeBusinessChains": ( "string" ),
   "IncludeCategories": ( "string" ),
   "IncludeCountries": ( "string" ),
   "IncludeFoodTypes": ( "string" )
},

Na minha pesquisa por pontos de interesse próximos, um dos resultados devolvidos foi um McDonald’s, uma conhecida referência internacional 🍔.

Etapa 4: obter instruções de direção

Por fim, uso a AWS CLI para calcular rotas de direção entre dois centros de cidades: BruxelasBélgica e LilleFrança.

aws location calculate-routes    
    --origin 4.35278 50.84687      
    --destination 3.06361 50.63706 
    --key "v1.public.ey...cy"

A resposta inclui uma polilinha para renderizar o caminho em um mapa e uma lista passo a passo de instruções de direção.

...
          "TravelMode": "Automotive",
          "Sort": "Car",
          "VehicleLegDetails": {
            "TravelSteps": (
              {
                "Period": 15,
                "Distance": 75,
                "ExitNumber": (),
                "GeometryOffset": 0,
                "Sort": "Depart"
              },
              {
                "Period": 10,
                "Distance": 8,
                "ExitNumber": (),
                "GeometryOffset": 2,
                "Sort": "Flip",
                "TurnStepDetails": {
                  "Intersection": (),
                  "SteeringDirection": "Proper",
                  "TurnIntensity": "Typical"
                }
              },
...

Etapa 5: exibir as instruções de direção em um mapa

Para visualizar a rota em um mapa, eu uso o MapLibre biblioteca, que é um mecanismo de renderização para exibir mapas em aplicativos da internet e móveis. Seguindo o Guia do desenvolvedor do Amazon Location Servicecriei um aplicativo básico para exibir a rota.

Além de MapLibrevocê pode usar AWS Amplificar para integrar e exibir dados de localização da Amazon em seus aplicativos.

Começando
Com essas APIs novas e atualizadas, o Amazon Location Service oferece um conjunto mais abrangente de mapeamento e dados de localização para suas necessidades comerciais. Isso ajudará a acelerar seu ciclo de vida de desenvolvimento, aumentando a agilidade e a escalabilidade dos desenvolvedores.

Para começar, discover o atualizado Guia do desenvolvedor do Amazon Location Service e comece a integrar esses recursos hoje mesmo. Você também pode visitar o Página do serviço de localização da Amazon para saber mais ou experimentar as APIs com seus favoritos SDKs da AWS para ver como eles podem aprimorar seus aplicativos.

– seb