Usando IDs de locais

A pesquisa por lugares retorna uma lista de resultados. A maioria dos resultados inclui um PlaceId para esse resultado. Você pode usar o PlaceId em uma operação GetPlace para retornar as informações sobre esse local (incluindo nome, endereço, localização ou outros detalhes).

nota

O uso SearchPlaceIndexForSuggestionsretornará PlaceId resultados para índices de qualquer lugar criados com qualquer fonte de dados. Usando SearchPlaceIndexForTextou SearchPlaceIndexForPositionretornará um PlaceId somente se a fonte de dados usada for AQUI.

Cada PlaceId define de forma exclusiva o local ao qual se refere, mas um único local pode ter mais de um PlaceId ao longo do tempo e com base no contexto. As regras a seguir descrevem a exclusividade e a longevidade de um PlaceId.

• As chamadas PlaceId retornadas que você faz são específicas para você Conta da AWS, para a AWS região e para o provedor de dados em seu PlaceIndex recurso. GetPlaceencontrará resultados somente quando esses três atributos corresponderem à chamada original que criou PlaceId o.

• O PlaceId para um local mudará quando os dados sobre esse local mudarem. Por exemplo, quando a empresa a que se refere muda de local ou muda de nome.

• O resultado PlaceId de uma chamada de pesquisa repetida pode mudar quando o serviço de back-end faz uma atualização. Os mais antigos PlaceId continuarão sendo encontrados, mas novas chamadas para pesquisar poderão resultar em uma ID diferente.

O PlaceId é uma string. Não há limite específico para o comprimento de um PlaceId. Veja a seguir um exemplo de um PlaceId válido.

AQAAAIAADsn2T3KdrRWeaXLeVEyjNx_JfeTsMB0NVCEAnAZoJ-o3nqdlJZAdgcT2oWi1w9pS4wXXOk3O1vsKlGsPyHjV4EJxsu289i3hVO_BUPgP7SFoWAi8BW2v7LvAjQ5NfUPy7a1v9ajT3feIqcUZszWSTqKbJHFYvQqW7wdqhpQq3Wy-et39ZQDWSPLZUzgcjN-6VD2gyKkH0Po7gSm8YSJNSQ

Chamar GetPlace com um PlaceId para um local cujos dados foram alterados (por exemplo, um local comercial que fechou) resultará em um erro 404, ResourceNotFound. Chamar GetPlace com um PlaceId que não é válido ou fora do contexto, como de outro Conta da AWS, retornará um 400 ValidationException erro.

Embora você possa usar PlaceID em solicitações subsequentes, PlaceID não pretende ser um identificador permanente e o ID pode mudar entre chamadas consecutivas de API. Veja o seguinte comportamento de placeID para cada provedor de dados:

• Esri: Os IDs de local serão alterados a cada trimestre, no mínimo. O período típico para essas mudanças seria março, junho, setembro e dezembro. Os IDs de local também podem mudar entre as alterações trimestrais típicas, mas isso será muito menos frequente.

• AQUI: Recomendamos que você armazene os dados em cache por no máximo uma semana para mantê-los atualizados. Você pode presumir que menos de 1% de mudanças de ID serão liberadas em relação ao lançamento, o que ocorre aproximadamente 1 a 2 vezes por semana.

• Grab: Os IDs de lugar podem expirar ou se tornar inválidos nas seguintes situações.

  • Operações de dados: O POI pode ser removido do banco de dados do Grab POI pelo Grab Map Ops com base na verdade fundamental, como estar fechado no mundo real, ser detectado como um POI duplicado ou ter informações incorretas. O Grab sincronizará os dados com o ambiente do Waypoint semanalmente.

  • POI interpolado: o POI interpolado é um POI temporário gerado em tempo real ao atender a uma solicitação e será marcado como derivado no campo da resposta. place.result_type As informações dos POIs interpolados serão retidas por pelo menos 30 dias, o que significa que, em 30 dias, você poderá obter detalhes do POI por ID do Place na API Place Details. Após 30 dias, os POIs interpolados (tanto o ID do local quanto os detalhes) podem expirar e ficar inacessíveis a partir da API Places Details.