Recuperar propriedades de itens e detalhes de recursos do Portal for ArcGIS ou ArcGIS Online usando ArcGIS API for Python

Resumo

As propriedades do item e os recursos de uma feição descrevem e referenciam o conteúdo no ArcGIS Pro, ArcGIS Online e ArcGIS Enterprise. As propriedades são usadas na pesquisa para identificar os itens específicos solicitados pelo usuário, por exemplo, uma pesquisa usando o ID do item. Quando se trata de grandes volumes de dados, a Esri recomenda o uso de scripts em Python para facilitar o processo. A identificação de propriedades do item pode ser feita utilizando a função resources.list() no ArcGIS API for Python. No entanto, um resultado vazio pode ser retornado quando a função é executada em itens hospedados. Esse é o comportamento esperado, pois os detalhes da propriedade de um item hospedado residem no JSON do item.

Este artigo descreve como utilizar o ArcGIS API for Python para acessar as propriedades do item no JSON. O script fornecido pode ser executado em um arquivo .py independente ou no ArcGIS Notebook.

Procedimento

1. Importe o módulo necessário.

from arcgis.gis import GIS
import json

2. Conecte-se à conta e especifique as credenciais.
   • Para ArcGIS Online:

gis = GIS('https://arcgis.com', '<username>', '<password>')

• Para uma conta da organização do ArcGIS Online com configuração do SAML. Consulte ArcGIS API for Python: obtendo um ID do cliente para obter mais informações:

gis = GIS(r'https://essorg.maps.arcgis.com', client_id='<client_id>', client_secret='<client_secret>', verify_cert=False)

• Para Portal for ArcGIS:

gis = GIS(r'https://<machine>.<domain>/<web adaptor name>/home', 'username', 'password', verify_cert=False)

3. Especifique o ID do item. Isso pode ser feito individualmente usando um único parâmetro ou em conjunto usando um parâmetro de matriz.

• Para um único item.

item_id = "<item_id>"

• Para vários itens, mais IDs do item podem ser adicionados modificando o script, conforme mostrado no exemplo.

items = ["<item_id_1>", "<item_id_2>", "<item_id_3>", "<item_id_4>"]

4. Obtenha os detalhes de recurso do item.
• Para obter detalhes completos de um único item:

item = gis.content.get(item_id)
print(json.dumps(dict(item), indent=4))

• Para obter detalhes completos de vários itens:

for item_id in items:
    item = gis.content.get(item_id)
    print(json.dumps(dict(item), indent=4))

• Para obter detalhes específicos de um único item, modifique a instrução de impressão para retornar o detalhe desejado.

item = gis.content.get(item_id)
print(item["type"])
print(item["owner"])
print(item["title"])
print(item["url"])

• Para obter detalhes específicos de vários itens, modifique a instrução de impressão para retornar o detalhe desejado.

for item_id in items:
    item = gis.content.get(item_id)
    print(item["type"])
    print(item["typeKeywords"])
    print(item["title"])
    print(item["url"])

O seguinte mostra o script completo para imprimir todos os detalhes do item para vários itens.

from arcgis.gis import GIS
import json

gis = GIS("https://essorg.maps.arcgis.com", client_id="bcqwu37r8uboeqsample", client_secret="c2safh3q48hrinf487cbriecbsample", verify_cert=False)

items = ["cf9983q4fciuewn4b3rev983qncubwei6", "1097h13498hcunc2405bffn549"]

for item_id in items:
    item = gis.content.get(item_id)
    print(json.dumps(dict(item), indent=4))