Search - Post Search Inside Geometry

Servizio:

Maps

Versione API:

1.0

Utilizzare per eseguire ricerche in formato libero all'interno di un'altra geometria.

L'API Post Search Inside Geometry è e HTTP POST request that allows you to perform a free form search inside a single geometry or multiple geometries. The search results that fall inside the geometry/geometries will be returned.<br><br>To send the geometry you will use a POSTrequest where the request body will contain thegeometryobject represented as aGeoJSONtype and theContent-Typeheader will be set toapplication/json. The geographical features to be searched can be modeled as Polygon and/or Circle geometries represented using any one of the following GeoJSONtypes:<ul><li>**GeoJSON FeatureCollection** <br>Thegeometrycan be represented as aGeoJSON FeatureCollectionobject. This is the recommended option if the geometry contains both Polygons and Circles. TheFeatureCollectioncan contain a max of 50GeoJSON Featureobjects. EachFeatureobject should represent either a Polygon or a Circle with the following conditions:<ul style="list-style-type:none"><li>AFeatureobject should represent either a Polygon or a Circle with the following conditions:<ul style="list-style-type:none"><li>AFeatureobject for the Polygon geometry can have a max of 50 coordinates and it's properties must be empty.</li><li>Aobject should represent either a Polygon or a Circle with the following conditions:<ul style="list-style-type:none"><li>AFeatureobject for the Circle geometry is composed of a _center_ represented using aGeoJSON Pointtype and a _radius_ value (in meters) which must be specified in the object's properties along with the _subType_ property whose value should be 'Circle'.</li></ul><br> Please see the Examples section below for a sampleFeatureCollectionrepresentation.<br><br></li><li>**GeoJSON GeometryCollection**<br>Thegeometrycan be represented as aGeoJSON GeometryCollectionobject. This is the recommended option if the geometry contains a list of Polygons only. TheGeometryCollectioncan contain a max of 50GeoJSON Polygonobjects. EachPolygonobject can have a max of 50 coordinates. Please see the Examples section below for a samplePolygonobject can have a max of 50 coordinates. Please see the Examples section below for a sampleGeometryCollectionrepresentation.<br><br></li><li>**GeoJSON Polygon**<br>Thegeometrycan be represented as aGeoJSON Polygonobject. This is the recommended option if the geometry contains a single Polygon. ThePolygonobject can have a max of 50 coordinates. Please see the Examples section below for a samplePolygon'.

.

POST https://atlas.microsoft.com/search/geometry/{format}?api-version=1.0&query={query}

Con parametri facoltativi:

POST https://atlas.microsoft.com/search/geometry/{format}?api-version=1.0&query={query}&limit={limit}&language={language}&categorySet={categorySet}&extendedPostalCodesFor={extendedPostalCodesFor}&idxSet={idxSet}&view={view}&openingHours=nextSevenDays

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
format	path	True	ResponseFormat	Formato desiderato della risposta. Il valore può essere json o xml.
api-version	query	True	string	Numero di versione dell'API mappe di Azure.
query	query	True	string	Nome poi da cercare (ad esempio, "statua della libertà", "starbucks", "pizza"). Deve essere codificato correttamente l'URL.
categorySet	query		integer[]	Elenco delimitato da virgole di ID set di categorie che possono essere usati per limitare il risultato a categorie di punti di interesse specifiche. L'ordine ID non è importante. Il numero massimo di valori di categorySet supportati per richiesta è 10. Quando vengono forniti più identificatori di categoria, verranno restituiti solo i POI che appartengono (almeno) a una delle categorie dell'elenco fornito. È possibile individuare l'elenco delle categorie supportate usando Categorie di punti di interesse API. Esempi di utilizzo: categorySet=7315 (Punti di ricerca di interesse dalla categoria Ristorante) categorySet=7315025,7315017 (Punti di interesse di ricerca di categoria italiano o francese)
extendedPostalCodesFor	query		SearchIndexes[]	Indici per i quali i codici postali estesi devono essere inclusi nei risultati. Gli indici disponibili sono: Addr = Intervalli di indirizzi Geo = Aree geografiche PAD = Indirizzi punto punto di interesse = Punti di interesse Str = Strade XStr = Cross Street (intersezioni) Il valore deve essere un elenco delimitato da virgole di tipi di indice (in qualsiasi ordine) o Nessuna per nessun indice. Per impostazione predefinita, i codici postali estesi sono inclusi per tutti gli indici tranne Geo. Gli elenchi di codici postali estesi per le aree geografiche possono essere molto lunghi, quindi devono essere richiesti in modo esplicito quando necessario. Esempi di utilizzo: extendedPostalCodesFor=POI extendedPostalCodesFor=PAD,Addr,POI extendedPostalCodesFor=None Il codice postale esteso viene restituito come proprietà extendedPostalCode di un indirizzo. La disponibilità dipende dall'area.
idxSet	query		SearchIndexes[]	Elenco delimitato da virgole di indici che devono essere utilizzati per la ricerca. L'ordine degli articoli non è importante. Gli indici disponibili sono: Addr = Interpolazione dell'intervallo di indirizzi, Geo = Geographies, PAD = Point Addresses, POI = Points of interest, Str = Streets, Xstr = Cross Streets (intersezioni)
language	query		string	Lingua in cui devono essere restituiti i risultati della ricerca. Deve essere uno dei tag di lingua IETF supportati, senza distinzione tra maiuscole e minuscole. Quando i dati nella lingua specificata non sono disponibili per un campo specifico, viene usata la lingua predefinita. Per informazioni dettagliate, vedere lingue supportate.
limit	query		integer minimum: 1 maximum: 100	Numero massimo di risposte che verranno restituite. Impostazione predefinita: 10, minimo: 1 e massimo: 100
openingHours	query		OperatingHoursRange	Ore di funzionamento per un punto di interesse (Punti di interesse). La disponibilità delle ore di funzionamento varia in base ai dati disponibili. Se non viene superato, non verranno restituite informazioni sulle ore di apertura. Valore supportato: nextSevenDays
view	query		LocalizedMapView	Il parametro View (detto anche parametro "area utente") consente di visualizzare le mappe corrette per un determinato paese/area geografica per aree geopolitiche contestate. Diversi paesi/aree geografiche hanno visualizzazioni diverse di tali aree e il parametro View consente all'applicazione di rispettare la visualizzazione richiesta dal paese o dall'area geografica in cui verrà utilizzata l'applicazione.Different countries/regions have different views of such regions, and the View parameter allows your application to comply with the view required by the country/region your application will be serving. Per impostazione predefinita, il parametro View è impostato su "Unified" anche se non è stato definito nella richiesta. È responsabilità dell'utente determinare la posizione degli utenti e quindi impostare correttamente il parametro View per tale posizione. In alternativa, è possibile impostare 'View=Auto', che restituirà i dati della mappa in base all'indirizzo IP della richiesta. Il parametro View in Mappe di Azure deve essere usato in conformità alle leggi applicabili, incluse quelle relative al mapping, del paese/area geografica in cui sono disponibili mappe, immagini e altri dati e altri contenuti di terze parti autorizzati ad accedere tramite Mappe di Azure. Esempio: view=IN. Per informazioni dettagliate e per visualizzare le visualizzazioni disponibili, vedere viste supportate.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
x-ms-client-id		string	Specifica quale account è destinato all'utilizzo in combinazione con il modello di sicurezza Microsoft Entra ID. Rappresenta un ID univoco per l'account mappe di Azure e può essere recuperato dall'API dell'account del piano di gestione di Mappe di Azure. Per usare la sicurezza di Microsoft Entra ID in Mappe di Azure, vedere gli articoli di seguenti per indicazioni.

Corpo della richiesta

Nome	Tipo	Descrizione
geometry	GeoJsonObject: GeoJsonFeature GeoJsonFeatureCollection	Oggetto GeoJSON valido. Per informazioni dettagliate, vedere RFC 7946.

Risposte

Nome	Tipo	Descrizione
200 OK	SearchAddressResult	Va bene
Other Status Codes	ErrorResponse	Errore imprevisto.

Sicurezza

AADToken

Questi sono i flussi di Microsoft Entra OAuth 2.0. Se abbinato a l'accesso in base al ruolo di Azure controllarlo, può essere usato per controllare l'accesso alle API REST di Mappe di Azure. I controlli di accesso in base al ruolo di Azure vengono usati per designare l'accesso a uno o più account di risorse di Mappe di Azure o a risorse secondarie. A qualsiasi utente, gruppo o entità servizio può essere concesso l'accesso tramite un ruolo predefinito o un ruolo personalizzato composto da una o più autorizzazioni per le API REST di Mappe di Azure.

Per implementare scenari, è consigliabile visualizzare concetti di autenticazione. In sintesi, questa definizione di sicurezza offre una soluzione per la modellazione di applicazioni tramite oggetti in grado di controllare l'accesso su API e ambiti specifici.

Nota

• Questa definizione di sicurezza richiede l'uso dell'intestazione x-ms-client-id per indicare a quale risorsa di Mappe di Azure l'applicazione richiede l'accesso. Questa operazione può essere acquisita dall'API di gestione Maps.
• Il Authorization URL è specifico dell'istanza del cloud pubblico di Azure. I cloud sovrani hanno URL di autorizzazione univoci e configurazioni microsoft Entra ID.
• Il controllo degli accessi in base al ruolo di Azure viene configurato dal piano di gestione di Azure tramite il portale di Azure, PowerShell, l'interfaccia della riga di comando, gli SDK di Azure o le API REST.
• L'utilizzo della Sdk Web di Mappe di Azure consente la configurazione basata sulla configurazione di un'applicazione per più casi d'uso.
• Per altre informazioni su Microsoft Identity Platform, vedere panoramica di Microsoft Identity Platform.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Si tratta di una chiave condivisa di cui viene effettuato il provisioning quando si Creare un account di Mappe di Azure nel portale di Azure o usando PowerShell, l'interfaccia della riga di comando, gli SDK di Azure o l'API REST.

Con questa chiave, qualsiasi applicazione può accedere a tutte le API REST. In altre parole, questa chiave può essere usata come chiave master nell'account in cui vengono rilasciati.

Per le applicazioni esposte pubblicamente, è consigliabile usare l'approccio applicazioni client riservate per accedere alle API REST di Mappe di Azure in modo che la chiave possa essere archiviata in modo sicuro.

Tipo: apiKey
In: query

SAS Token

Si tratta di un token di firma di accesso condiviso creato dall'operazione List SAS nell'risorsa di Mappe di Azure tramite il piano di gestione di Azure tramite il portale di Azure, PowerShell, l'interfaccia della riga di comando, gli SDK di Azure o le API REST.

Con questo token, qualsiasi applicazione è autorizzata ad accedere ai controlli di accesso in base al ruolo di Azure e al controllo granulare per la scadenza, la frequenza e le aree d'uso per il token specifico. In altre parole, il token di firma di accesso condiviso può essere usato per consentire alle applicazioni di controllare l'accesso in modo più protetto rispetto alla chiave condivisa.

Per le applicazioni esposte pubblicamente, è consigliabile configurare un elenco specifico di origini consentite nella risorsa account mappa per limitare l'abuso di rendering e rinnovare regolarmente il token di firma di accesso condiviso.

Tipo: apiKey
In: header

Esempio

Search for burger joints inside a geometry represented as a GeoJSON GeometryCollection type

Search for pizza places inside a geometry represented as a GeoJSON FeatureCollection type

Search for subs joints inside a geometry represented as a GeoJSON Polygon type

Search for burger joints inside a geometry represented as a GeoJSON GeometryCollection type

Esempio di richiesta

HTTP

POST https://atlas.microsoft.com/search/geometry/json?api-version=1.0&query=burger&limit=2&openingHours=nextSevenDays

{
  "geometry": {
    "type": "GeometryCollection",
    "geometries": [
      {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -122.43576049804686,
              37.7524152343544
            ],
            [
              -122.43301391601562,
              37.70660472542312
            ],
            [
              -122.36434936523438,
              37.712059855877314
            ],
            [
              -122.43576049804686,
              37.7524152343544
            ]
          ]
        ]
      },
      {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -123.43576049804686,
              37.7524152343544
            ],
            [
              -123.43301391601562,
              37.70660472542312
            ],
            [
              -123.36434936523438,
              37.712059855877314
            ],
            [
              -123.43576049804686,
              37.7524152343544
            ]
          ]
        ]
      }
    ]
  }
}

Risposta di esempio

Codice di stato:

200

{
  "summary": {
    "query": "burger",
    "queryType": "NON_NEAR",
    "queryTime": 21,
    "numResults": 2,
    "offset": 0,
    "totalResults": 4,
    "fuzzyLevel": 1
  },
  "results": [
    {
      "type": "POI",
      "id": "9P2i9inRyndAA-_V40J8oA",
      "score": 2.0041828156,
      "info": "search:ta:840061003419653-US",
      "poi": {
        "name": "Burger Joint",
        "phone": "+1 415-349-4331",
        "categorySet": [
          {
            "id": 7315015
          }
        ],
        "categories": [
          "fast food",
          "restaurant"
        ],
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              },
              {
                "nameLocale": "en-US",
                "name": "fast food"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "167",
        "streetName": "Leland Avenue",
        "municipality": "San Francisco",
        "neighbourhood": "Visitacion Valley",
        "countrySecondarySubdivision": "San Francisco",
        "countrySubdivisionName": "California",
        "countrySubdivisionCode": "CA",
        "postalCode": "94134",
        "extendedPostalCode": "94134-2844",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "167 Leland Avenue, San Francisco, CA 94134",
        "localName": "San Francisco"
      },
      "position": {
        "lat": 37.712228,
        "lon": -122.407022
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 37.71313,
          "lon": -122.40816
        },
        "btmRightPoint": {
          "lat": 37.71133,
          "lon": -122.40589
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 37.71241,
            "lon": -122.40693
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "hkr-N07YS6Gv2dOciQ9lwA",
      "score": 2.0041515827,
      "info": "search:ta:840067000526682-US",
      "poi": {
        "name": "Sound of Burgers",
        "categorySet": [
          {
            "id": 7315
          }
        ],
        "categories": [
          "restaurant"
        ],
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "167",
        "streetName": "Leland Avenue",
        "municipality": "San Francisco",
        "neighbourhood": "Visitacion Valley",
        "countrySecondarySubdivision": "San Francisco",
        "countrySubdivision": "CA",
        "countrySubdivisionName": "California",
        "countrySubdivisionCode": "CA",
        "postalCode": "94134",
        "extendedPostalCode": "94134-2844",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "167 Leland Avenue, San Francisco, CA 94134",
        "localName": "San Francisco"
      },
      "position": {
        "lat": 37.712228,
        "lon": -122.407022
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 37.71313,
          "lon": -122.40816
        },
        "btmRightPoint": {
          "lat": 37.71133,
          "lon": -122.40589
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 37.71241,
            "lon": -122.40693
          }
        }
      ]
    }
  ]
}

Search for pizza places inside a geometry represented as a GeoJSON FeatureCollection type

Esempio di richiesta

HTTP

POST https://atlas.microsoft.com/search/geometry/json?api-version=1.0&query=pizza&limit=2&openingHours=nextSevenDays

{
  "geometry": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "geometry": {
          "type": "Polygon",
          "coordinates": [
            [
              [
                -122.143035,
                47.653536
              ],
              [
                -122.187164,
                47.617556
              ],
              [
                -122.114981,
                47.570599
              ],
              [
                -122.132756,
                47.654009
              ],
              [
                -122.143035,
                47.653536
              ]
            ]
          ]
        },
        "properties": {}
      },
      {
        "type": "Feature",
        "geometry": {
          "type": "Point",
          "coordinates": [
            -122.126986,
            47.639754
          ]
        },
        "properties": {
          "subType": "Circle",
          "radius": 100
        }
      }
    ]
  }
}

Risposta di esempio

Codice di stato:

200

{
  "summary": {
    "query": "pizza",
    "queryType": "NON_NEAR",
    "queryTime": 34,
    "numResults": 2,
    "offset": 0,
    "totalResults": 21,
    "fuzzyLevel": 1
  },
  "results": [
    {
      "type": "POI",
      "id": "-UuwTye4GGsea4KmCLvoqQ",
      "score": 2.1455535889,
      "info": "search:ta:840537000108972-US",
      "poi": {
        "name": "Biryani & Pizza House",
        "categorySet": [
          {
            "id": 7315036
          }
        ],
        "categories": [
          "pizza",
          "restaurant"
        ],
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              },
              {
                "nameLocale": "en-US",
                "name": "pizza"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "15025",
        "streetName": "Northeast 24th Street",
        "municipality": "Redmond",
        "countrySecondarySubdivision": "King",
        "countrySubdivision": "WA",
        "countrySubdivisionName": "Washington",
        "countrySubdivisionCode": "WA",
        "postalCode": "98052",
        "extendedPostalCode": "98052-5531",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "15025 Northeast 24th Street, Redmond, WA 98052",
        "localName": "Redmond"
      },
      "position": {
        "lat": 47.630786,
        "lon": -122.139302
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 47.63169,
          "lon": -122.14064
        },
        "btmRightPoint": {
          "lat": 47.62989,
          "lon": -122.13797
        }
      },
      "entryPoints": [
        {
          "type": "minor",
          "position": {
            "lat": 47.63079,
            "lon": -122.13931
          }
        },
        {
          "type": "main",
          "position": {
            "lat": 47.63147,
            "lon": -122.13935
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "7r095LCcCSkdoGoeLcnvsQ",
      "score": 2.1454992294,
      "info": "search:ta:840537000103468-US",
      "poi": {
        "name": "Pagliacci Pizza",
        "categorySet": [
          {
            "id": 7315036
          }
        ],
        "url": "www.pagliacci.com/",
        "categories": [
          "pizza",
          "restaurant"
        ],
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              },
              {
                "nameLocale": "en-US",
                "name": "pizza"
              }
            ]
          }
        ],
        "openingHours": {
          "mode": "nextSevenDays",
          "timeRanges": [
            {
              "startTime": {
                "date": "2024-03-14",
                "hour": 10,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-14",
                "hour": 11,
                "minute": 0
              }
            },
            {
              "startTime": {
                "date": "2024-03-17",
                "hour": 10,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-17",
                "hour": 11,
                "minute": 0
              }
            },
            {
              "startTime": {
                "date": "2024-03-18",
                "hour": 10,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-18",
                "hour": 11,
                "minute": 0
              }
            },
            {
              "startTime": {
                "date": "2024-03-19",
                "hour": 10,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-19",
                "hour": 11,
                "minute": 0
              }
            },
            {
              "startTime": {
                "date": "2024-03-20",
                "hour": 10,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-20",
                "hour": 11,
                "minute": 0
              }
            }
          ]
        }
      },
      "address": {
        "streetNumber": "15238",
        "streetName": "Bel Red Road",
        "municipality": "Bellevue",
        "countrySecondarySubdivision": "King",
        "countrySubdivision": "WA",
        "countrySubdivisionName": "Washington",
        "countrySubdivisionCode": "WA",
        "postalCode": "98007",
        "extendedPostalCode": "98007-3815",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "15238 Bel Red Road, Bellevue, WA 98007",
        "localName": "Bellevue"
      },
      "position": {
        "lat": 47.628008,
        "lon": -122.13646
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 47.62891,
          "lon": -122.13779
        },
        "btmRightPoint": {
          "lat": 47.62711,
          "lon": -122.13513
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 47.6283,
            "lon": -122.13611
          }
        }
      ]
    }
  ]
}

Search for subs joints inside a geometry represented as a GeoJSON Polygon type

Esempio di richiesta

HTTP

POST https://atlas.microsoft.com/search/geometry/json?api-version=1.0&query=subs&limit=2&openingHours=nextSevenDays

{
  "geometry": {
    "type": "Polygon",
    "coordinates": [
      [
        [
          -122.43576049804686,
          37.7524152343544
        ],
        [
          -122.43301391601562,
          37.70660472542312
        ],
        [
          -122.36434936523438,
          37.712059855877314
        ],
        [
          -122.43576049804686,
          37.7524152343544
        ]
      ]
    ]
  }
}

Risposta di esempio

Codice di stato:

200

{
  "summary": {
    "query": "subs",
    "queryType": "NON_NEAR",
    "queryTime": 42,
    "numResults": 2,
    "offset": 0,
    "totalResults": 5,
    "fuzzyLevel": 1
  },
  "results": [
    {
      "type": "POI",
      "id": "HOIWGiNwVv0z6bF8MO3EbA",
      "score": 2.1455111504,
      "info": "search:ta:840069009512242-US",
      "poi": {
        "name": "Adams Grub Truck",
        "phone": "+1 415-307-8844",
        "categorySet": [
          {
            "id": 7315042
          }
        ],
        "categories": [
          "restaurant",
          "sandwich"
        ],
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "sandwich"
              },
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "1465",
        "streetName": "Carroll Avenue",
        "municipality": "San Francisco",
        "neighbourhood": "Bayview",
        "countrySecondarySubdivision": "San Francisco",
        "countrySubdivisionName": "California",
        "countrySubdivisionCode": "CA",
        "postalCode": "94124",
        "extendedPostalCode": "94124-3604",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "1465 Carroll Avenue, San Francisco, CA 94124",
        "localName": "San Francisco"
      },
      "position": {
        "lat": 37.72328,
        "lon": -122.39091
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 37.72418,
          "lon": -122.39205
        },
        "btmRightPoint": {
          "lat": 37.72238,
          "lon": -122.38977
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 37.72348,
            "lon": -122.39073
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "bXbc0QxTRlkSo8GnU7EU-Q",
      "score": 2.1454677582,
      "info": "search:ta:840061001992959-US",
      "poi": {
        "name": "SUBWAY San Francisco San Francisco",
        "phone": "+1 415-657-9898",
        "brands": [
          {
            "name": "SUBWAY"
          }
        ],
        "categorySet": [
          {
            "id": 7315042
          }
        ],
        "categories": [
          "restaurant",
          "sandwich"
        ],
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "sandwich"
              },
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              }
            ]
          }
        ],
        "openingHours": {
          "mode": "nextSevenDays",
          "timeRanges": [
            {
              "startTime": {
                "date": "2024-03-13",
                "hour": 7,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-13",
                "hour": 21,
                "minute": 30
              }
            },
            {
              "startTime": {
                "date": "2024-03-14",
                "hour": 7,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-14",
                "hour": 21,
                "minute": 30
              }
            },
            {
              "startTime": {
                "date": "2024-03-15",
                "hour": 7,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-15",
                "hour": 21,
                "minute": 30
              }
            },
            {
              "startTime": {
                "date": "2024-03-16",
                "hour": 9,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-16",
                "hour": 21,
                "minute": 0
              }
            },
            {
              "startTime": {
                "date": "2024-03-17",
                "hour": 9,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-17",
                "hour": 21,
                "minute": 0
              }
            },
            {
              "startTime": {
                "date": "2024-03-18",
                "hour": 8,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-18",
                "hour": 20,
                "minute": 30
              }
            },
            {
              "startTime": {
                "date": "2024-03-19",
                "hour": 7,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-19",
                "hour": 21,
                "minute": 30
              }
            }
          ]
        }
      },
      "address": {
        "streetNumber": "2599",
        "streetName": "San Bruno Avenue",
        "municipality": "San Francisco",
        "neighbourhood": "Portola",
        "countrySecondarySubdivision": "San Francisco",
        "countrySubdivision": "CA",
        "countrySubdivisionName": "California",
        "countrySubdivisionCode": "CA",
        "postalCode": "94134",
        "extendedPostalCode": "94134-1504",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "2599 San Bruno Avenue, San Francisco, CA 94134",
        "localName": "San Francisco"
      },
      "position": {
        "lat": 37.729004,
        "lon": -122.403956
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 37.7299,
          "lon": -122.40509
        },
        "btmRightPoint": {
          "lat": 37.7281,
          "lon": -122.40282
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 37.72892,
            "lon": -122.40414
          }
        }
      ]
    }
  ]
}

Definizioni

Nome	Descrizione
Address	Indirizzo del risultato
AddressRanges	Descrive l'intervallo di indirizzi su entrambi i lati della strada per un risultato di ricerca. Sono incluse le coordinate per le posizioni iniziale e finale dell'intervallo di indirizzi.
BoundingBox	Riquadro di visualizzazione che copre il risultato rappresentato dalle coordinate superiore sinistra e inferiore destra del riquadro di visualizzazione.
BoundingBoxCompassNotation	Rettangolo di selezione della posizione.
Brand	Il marchio associato al punto di interesse
Classification	Classificazione per il punto di interesse restituito
ClassificationName	Nome della classificazione
DataSources	Sezione facoltativa. ID di riferimento da usare con l'API Get Search Polygon.
Entity	Origine del tipo di entità del rettangolo di selezione. Per la geocodifica inversa questo è sempre uguale alla posizione.
EntryPoint	Punto di ingresso per il punto di interesse restituito.
EntryPointType	Tipo di punto di ingresso. Il valore può essere principale o secondaria.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
GeographicEntityType	Tipo di entità Geography. Presente solo quando entityType è stato richiesto ed è disponibile.
GeoJsonFeature	Tipo di oggetto GeoJSON Feature valido. Per informazioni dettagliate, vedere RFC 7946.
GeoJsonFeatureCollection	Tipo di oggetto GeoJSON FeatureCollection valido. Per informazioni dettagliate, vedere RFC 7946.
GeoJsonGeometry	Oggetto geometry GeoJSON valido. Il tipo deve essere uno dei sette tipi di geometria GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon e GeometryCollection. Per informazioni dettagliate, vedere RFC 7946.
GeoJsonGeometryCollection	Tipo di oggetto GeoJSON GeometryCollection valido. Per informazioni dettagliate, vedere RFC 7946.
GeoJsonLineString	Tipo geometry GeoJSON LineString valido. Per informazioni dettagliate, vedere RFC 7946.
GeoJsonMultiLineString	Tipo geometry GeoJSON MultiLineString valido. Per informazioni dettagliate, vedere RFC 7946.
GeoJsonMultiPoint	Tipo geometry GeoJSON MultiPoint valido. Per informazioni dettagliate, vedere RFC 7946.
GeoJsonMultiPolygon	Tipo di oggetto GeoJSON MultiPolygon valido. Per informazioni dettagliate, vedere RFC 7946.
GeoJsonPoint	Tipo geometry GeoJSON Point valido. Per informazioni dettagliate, vedere RFC 7946.
GeoJsonPolygon	Tipo geometry GeoJSON Polygon valido. Per informazioni dettagliate, vedere RFC 7946.
Geometry	Informazioni sulla forma geometrica del risultato. Presente solo se type == Geography.
LatLongPairAbbreviated	Posizione rappresentata come latitudine e longitudine usando nomi brevi 'lat' & 'lon'.
LocalizedMapView	Il parametro View (detto anche parametro "area utente") consente di visualizzare le mappe corrette per un determinato paese/area geografica per aree geopolitiche contestate. Diversi paesi/aree geografiche hanno visualizzazioni diverse di tali aree e il parametro View consente all'applicazione di rispettare la visualizzazione richiesta dal paese o dall'area geografica in cui verrà utilizzata l'applicazione.Different countries/regions have different views of such regions, and the View parameter allows your application to comply with the view required by the country/region your application will be serving. Per impostazione predefinita, il parametro View è impostato su "Unified" anche se non è stato definito nella richiesta. È responsabilità dell'utente determinare la posizione degli utenti e quindi impostare correttamente il parametro View per tale posizione. In alternativa, è possibile impostare 'View=Auto', che restituirà i dati della mappa in base all'indirizzo IP della richiesta. Il parametro View in Mappe di Azure deve essere usato in conformità alle leggi applicabili, incluse quelle relative al mapping, del paese/area geografica in cui sono disponibili mappe, immagini e altri dati e altri contenuti di terze parti autorizzati ad accedere tramite Mappe di Azure. Esempio: view=IN. Per informazioni dettagliate e per visualizzare le visualizzazioni disponibili, vedere viste supportate.
MatchType	Tipi di corrispondenza per un'operazione di ricerca di indirizzi inversa.
OperatingHours	Ore di apertura per un punto di interesse (punti di interesse).
OperatingHoursRange	Ore di funzionamento per un punto di interesse (Punti di interesse). La disponibilità delle ore di funzionamento varia in base ai dati disponibili. Se non viene superato, non verranno restituite informazioni sulle ore di apertura. Valore supportato: nextSevenDays
OperatingHoursTime	Rappresenta una data e un'ora
OperatingHoursTimeRange	Aprire l'intervallo di tempo per un giorno
PointOfInterest	Dettagli del punto di interesse restituito, incluse informazioni quali il nome, il telefono, l'indirizzo URL e le classificazioni.
PointOfInterestCategorySet	Categoria punti di interesse
QueryType	Tipo di query restituito: NEARBY o NON_NEAR.
ResponseFormat	Formato desiderato della risposta. Il valore può essere json o xml.
SearchAddressResult	Questo oggetto viene restituito dalle chiamate di ricerca riuscite.
SearchAddressResultItem	Oggetto Result per una risposta dell'API di ricerca.
SearchAddressResultType	Uno dei seguenti: POI (Punto di interesse) Via Geografia Punto di interesse Intervallo di indirizzi Incrocio
SearchIndexes	Indici per i quali i codici postali estesi devono essere inclusi nei risultati. Gli indici disponibili sono: Addr = Intervalli di indirizzi Geo = Aree geografiche PAD = Indirizzi punto punto di interesse = Punti di interesse Str = Strade XStr = Cross Street (intersezioni) Il valore deve essere un elenco delimitato da virgole di tipi di indice (in qualsiasi ordine) o Nessuna per nessun indice. Per impostazione predefinita, i codici postali estesi sono inclusi per tutti gli indici tranne Geo. Gli elenchi di codici postali estesi per le aree geografiche possono essere molto lunghi, quindi devono essere richiesti in modo esplicito quando necessario. Esempi di utilizzo: extendedPostalCodesFor=POI extendedPostalCodesFor=PAD,Addr,POI extendedPostalCodesFor=None Il codice postale esteso viene restituito come proprietà extendedPostalCode di un indirizzo. La disponibilità dipende dall'area.
SearchInsideGeometryRequest	Questo tipo rappresenta il corpo della richiesta per il servizio Cerca all'interno della geometria.
SearchSummary	Oggetto riepilogo per una risposta dell'API di ricerca.

Address

Object

Indirizzo del risultato

Nome	Tipo	Descrizione
boundingBox	BoundingBoxCompassNotation	Rettangolo di selezione della posizione.
buildingNumber	string	Numero dell'edificio sulla strada. DEPRECATO, usare invece streetNumber.
country	string	nome paese/area geografica
countryCode	string	Paese (Nota: si tratta di un codice di due lettere, non di un nome paese/area geografica.
countryCodeISO3	string	Codice paese ISO alfa-3
countrySecondarySubdivision	string	Contea
countrySubdivision	string	Stato o Provincia
countrySubdivisionCode	string	countrySubdivisionCode preceduti da countryCode ( countryCode-countrySubdivisionCode ) e il trattino costituisce il codice ISO 3166-2. Esempi: TX per Texas, SCT per Scozia e ON per Ontario.
countrySubdivisionName	string	Nome completo di un primo livello di gerarchia amministrativa paese/area geografica. Questo campo viene visualizzato solo nel caso in cui countrySubdivision venga presentato in formato abbreviato. Supportato solo per Stati Uniti, Canada e Regno Unito.
countryTertiarySubdivision	string	Area denominata
crossStreet	string	Il nome della strada da attraversare.
extendedPostalCode	string	Codice postale esteso (la disponibilità dipende dall'area).
freeformAddress	string	Riga di indirizzo formattata in base alle regole di formattazione del paese o dell'area geografica di un risultato oppure, nel caso di un paese o area geografica, il nome completo del paese o dell'area geografica.
localName	string	Componente dell'indirizzo che rappresenta il nome di un'area geografica o di una località che raggruppa più oggetti indirizzabili a scopo di indirizzamento, senza essere un'unità amministrativa. Questo campo viene usato per compilare la proprietà freeformAddress. localName rappresenta il comune postale. A seconda della località, localName è il nome comunemente noto di una città o di una città. Per il nome comunemente noto di una città o di una città, usare localName anziché municipality.
municipality	string	Città/Città Nota: municipality rappresenta il comune residenziale. A seconda della località, il valore municipality può differire dal nome comunemente noto di una città o di una città. Per il nome comunemente noto della città o della città, è consigliabile usare il valore localName anziché il valore municipality.
municipalitySubdivision	string	Sub/Super City
neighbourhood	string	Un quartiere è un'area geograficamente localizzata all'interno di una città o di una città con caratteristiche distintive e interazioni sociali tra gli abitanti.
postalCode	string	Codice postale/Cap
routeNumbers	string[]	I codici usati per identificare in modo univoco la strada
street	string	Nome della strada. DEPRECATO, usare invece streetName.
streetName	string	Nome della strada.
streetNameAndNumber	string	Nome e numero della strada.
streetNumber	string	Numero dell'edificio sulla strada.

AddressRanges

Object

Descrive l'intervallo di indirizzi su entrambi i lati della strada per un risultato di ricerca. Sono incluse le coordinate per le posizioni iniziale e finale dell'intervallo di indirizzi.

Nome	Tipo	Descrizione
from	LatLongPairAbbreviated	Posizione rappresentata come latitudine e longitudine usando nomi brevi 'lat' & 'lon'.
rangeLeft	string	Intervallo di indirizzi sul lato sinistro della strada.
rangeRight	string	Intervallo di indirizzi sul lato destro della strada.
to	LatLongPairAbbreviated	Posizione rappresentata come latitudine e longitudine usando nomi brevi 'lat' & 'lon'.

BoundingBox

Object

Riquadro di visualizzazione che copre il risultato rappresentato dalle coordinate superiore sinistra e inferiore destra del riquadro di visualizzazione.

Nome	Tipo	Descrizione
btmRightPoint	LatLongPairAbbreviated	Posizione rappresentata come latitudine e longitudine usando nomi brevi 'lat' & 'lon'.
topLeftPoint	LatLongPairAbbreviated	Posizione rappresentata come latitudine e longitudine usando nomi brevi 'lat' & 'lon'.

BoundingBoxCompassNotation

Object

Rettangolo di selezione della posizione.

Nome	Tipo	Descrizione
entity	Entity	Origine del tipo di entità del rettangolo di selezione. Per la geocodifica inversa questo è sempre uguale alla posizione.
northEast	string	Latitudine nord-est, coordinata longitudine del rettangolo delimitatore come float delimitati da virgole
southWest	string	Latitudine sud-ovest, coordinata longitudine del rettangolo delimitatore come float delimitati da virgole

Brand

Object

Il marchio associato al punto di interesse

Nome	Tipo	Descrizione
name	string	Nome del marchio

Classification

Object

Classificazione per il punto di interesse restituito

Nome	Tipo	Descrizione
code	string	Proprietà del codice
names	ClassificationName[]	Matrice nomi

ClassificationName

Object

Nome della classificazione

Nome	Tipo	Descrizione
name	string	Name - proprietà
nameLocale	string	Proprietà Delle impostazioni locali name

DataSources

Object

Sezione facoltativa. ID di riferimento da usare con l'API Get Search Polygon.

Nome	Tipo	Descrizione
geometry	Geometry	Informazioni sulla forma geometrica del risultato. Presente solo se type == Geography.

Entity

Enumerazione

Origine del tipo di entità del rettangolo di selezione. Per la geocodifica inversa questo è sempre uguale alla posizione.

Valore	Descrizione
position	Entità Position

EntryPoint

Object

Punto di ingresso per il punto di interesse restituito.

Nome	Tipo	Descrizione
position	LatLongPairAbbreviated	Posizione rappresentata come latitudine e longitudine usando nomi brevi 'lat' & 'lon'.
type	EntryPointType	Tipo di punto di ingresso. Il valore può essere principale o secondaria.

EntryPointType

Enumerazione

Tipo di punto di ingresso. Il valore può essere principale o secondaria.

Valore	Descrizione
main
minor

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Object

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

GeographicEntityType

Enumerazione

Tipo di entità Geography. Presente solo quando entityType è stato richiesto ed è disponibile.

Valore	Descrizione
Country	nome paese/area geografica
CountrySecondarySubdivision	Contea
CountrySubdivision	Stato o Provincia
CountryTertiarySubdivision	Area denominata
Municipality	Città/Città
MunicipalitySubdivision	Sub/Super City
Neighbourhood	Quartiere
PostalCodeArea	Codice postale/Cap

GeoJsonFeature

Object

Tipo di oggetto GeoJSON Feature valido. Per informazioni dettagliate, vedere RFC 7946.

Nome	Tipo	Descrizione
featureType	string	Tipo della funzionalità. Il valore dipende dal modello di dati di cui fa parte la funzionalità corrente. Alcuni modelli di dati possono avere un valore vuoto.
geometry	GeoJsonGeometry: GeoJsonGeometryCollection GeoJsonLineString GeoJsonMultiLineString GeoJsonMultiPoint GeoJsonMultiPolygon GeoJsonPoint GeoJsonPolygon	Oggetto geometry GeoJSON valido. Il tipo deve essere uno dei sette tipi di geometria GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon e GeometryCollection. Per informazioni dettagliate, vedere RFC 7946.
id	string	Identificatore della funzionalità.
type	string: Feature	Specifica il tipo di GeoJSON. Deve essere uno dei nove tipi di oggetto GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature e FeatureCollection.

GeoJsonFeatureCollection

Object

Tipo di oggetto GeoJSON FeatureCollection valido. Per informazioni dettagliate, vedere RFC 7946.

Nome	Tipo	Descrizione
features	GeoJsonFeature[]	Contiene un elenco di oggetti GeoJSON Feature validi.
type	string: FeatureCollection	Specifica il tipo di GeoJSON. Deve essere uno dei nove tipi di oggetto GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature e FeatureCollection.

GeoJsonGeometry

Object

Oggetto geometry GeoJSON valido. Il tipo deve essere uno dei sette tipi di geometria GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon e GeometryCollection. Per informazioni dettagliate, vedere RFC 7946.

Nome	Tipo	Descrizione
type	GeoJsonObjectType	Specifica il tipo di GeoJSON. Deve essere uno dei nove tipi di oggetto GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature e FeatureCollection.

GeoJsonGeometryCollection

Object

Tipo di oggetto GeoJSON GeometryCollection valido. Per informazioni dettagliate, vedere RFC 7946.

Nome	Tipo	Descrizione
geometries	GeoJsonGeometry[]: GeoJsonGeometryCollection[] GeoJsonLineString[] GeoJsonMultiLineString[] GeoJsonMultiPoint[] GeoJsonMultiPolygon[] GeoJsonPoint[] GeoJsonPolygon[]	Contiene un elenco di oggetti geometry GeoJSON validi. Si noti che le coordinate in GeoJSON sono in ordine x, y (longitudine, latitudine).
type	string: GeometryCollection	Specifica il tipo di GeoJSON. Deve essere uno dei nove tipi di oggetto GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature e FeatureCollection.

GeoJsonLineString

Object

Tipo geometry GeoJSON LineString valido. Per informazioni dettagliate, vedere RFC 7946.

Nome	Tipo	Descrizione
coordinates	number[] (double)	Coordinate per la geometria GeoJson LineString.
type	string: LineString	Specifica il tipo di GeoJSON. Deve essere uno dei nove tipi di oggetto GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature e FeatureCollection.

GeoJsonMultiLineString

Object

Tipo geometry GeoJSON MultiLineString valido. Per informazioni dettagliate, vedere RFC 7946.

Nome	Tipo	Descrizione
coordinates	number[] (double)	Coordinate per la geometria GeoJson MultiLineString.
type	string: MultiLineString	Specifica il tipo di GeoJSON. Deve essere uno dei nove tipi di oggetto GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature e FeatureCollection.

GeoJsonMultiPoint

Object

Tipo geometry GeoJSON MultiPoint valido. Per informazioni dettagliate, vedere RFC 7946.

Nome	Tipo	Descrizione
coordinates	number[] (double)	Coordinate per la geometria GeoJson MultiPoint.
type	string: MultiPoint	Specifica il tipo di GeoJSON. Deve essere uno dei nove tipi di oggetto GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature e FeatureCollection.

GeoJsonMultiPolygon

Object

Tipo di oggetto GeoJSON MultiPolygon valido. Per informazioni dettagliate, vedere RFC 7946.

Nome	Tipo	Descrizione
coordinates	number[] (double)	Contiene un elenco di oggetti GeoJSON Polygon validi. Si noti che le coordinate in GeoJSON sono in ordine x, y (longitudine, latitudine).
type	string: MultiPolygon	Specifica il tipo di GeoJSON. Deve essere uno dei nove tipi di oggetto GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature e FeatureCollection.

GeoJsonPoint

Object

Tipo geometry GeoJSON Point valido. Per informazioni dettagliate, vedere RFC 7946.

Nome	Tipo	Descrizione
coordinates	number[] (double)	Un Position è una matrice di numeri con due o più elementi. I primi due elementi sono longitudine e latitudine, esattamente in tale ordine. altitudine/elevazione è un terzo elemento facoltativo. Per informazioni dettagliate, vedere RFC 7946.
type	string: Point	Specifica il tipo di GeoJSON. Deve essere uno dei nove tipi di oggetto GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature e FeatureCollection.

GeoJsonPolygon

Object

Tipo geometry GeoJSON Polygon valido. Per informazioni dettagliate, vedere RFC 7946.

Nome	Tipo	Descrizione
coordinates	number[] (double)	Coordinate per il tipo di geometria GeoJson Polygon.
type	string: Polygon	Specifica il tipo di GeoJSON. Deve essere uno dei nove tipi di oggetto GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature e FeatureCollection.

Geometry

Object

Informazioni sulla forma geometrica del risultato. Presente solo se type == Geography.

Nome	Tipo	Descrizione
id	string	Passare questo valore come geometryId all'API get search polygon per recuperare le informazioni di geometria per questo risultato.

LatLongPairAbbreviated

Object

Posizione rappresentata come latitudine e longitudine usando nomi brevi 'lat' & 'lon'.

Nome	Tipo	Descrizione
lat	number (double)	Proprietà Latitude
lon	number (double)	Longitudine - proprietà

LocalizedMapView

Enumerazione

Il parametro View (detto anche parametro "area utente") consente di visualizzare le mappe corrette per un determinato paese/area geografica per aree geopolitiche contestate. Diversi paesi/aree geografiche hanno visualizzazioni diverse di tali aree e il parametro View consente all'applicazione di rispettare la visualizzazione richiesta dal paese o dall'area geografica in cui verrà utilizzata l'applicazione.Different countries/regions have different views of such regions, and the View parameter allows your application to comply with the view required by the country/region your application will be serving. Per impostazione predefinita, il parametro View è impostato su "Unified" anche se non è stato definito nella richiesta. È responsabilità dell'utente determinare la posizione degli utenti e quindi impostare correttamente il parametro View per tale posizione. In alternativa, è possibile impostare 'View=Auto', che restituirà i dati della mappa in base all'indirizzo IP della richiesta. Il parametro View in Mappe di Azure deve essere usato in conformità alle leggi applicabili, incluse quelle relative al mapping, del paese/area geografica in cui sono disponibili mappe, immagini e altri dati e altri contenuti di terze parti autorizzati ad accedere tramite Mappe di Azure. Esempio: view=IN.

Per informazioni dettagliate e per visualizzare le visualizzazioni disponibili, vedere viste supportate.

Valore	Descrizione
AE	Emirati Arabi Uniti (visualizzazione Araba)
AR	Argentina (vista argentina)
Auto	Restituisce i dati della mappa in base all'indirizzo IP della richiesta.
BH	Bahrein (vista araba)
IN	India (vista indiana)
IQ	Iraq (visualizzazione araba)
JO	Giordania (visualizzazione araba)
KW	Kuwait (vista araba)
LB	Libano (vista araba)
MA	Marocco (vista marocchina)
OM	Oman (vista araba)
PK	Pakistan (vista pakistana)
PS	Autorità palestinese (visualizzazione araba)
QA	Qatar (vista araba)
SA	Arabia Saudita (vista araba)
SY	Siria (visualizzazione araba)
Unified	Visualizzazione unificata (altri)
YE	Yemen (vista araba)

MatchType

Enumerazione

Tipi di corrispondenza per un'operazione di ricerca di indirizzi inversa.

Valore	Descrizione
AddressPoint
HouseNumberRange
Street

OperatingHours

Object

Ore di apertura per un punto di interesse (punti di interesse).

Nome	Tipo	Descrizione
mode	string	Valore usato nella richiesta: nessuno o "nextSevenDays"
timeRanges	OperatingHoursTimeRange[]	Elenco di intervalli di tempo per i prossimi 7 giorni

OperatingHoursRange

Enumerazione

Ore di funzionamento per un punto di interesse (Punti di interesse). La disponibilità delle ore di funzionamento varia in base ai dati disponibili. Se non viene superato, non verranno restituite informazioni sulle ore di apertura. Valore supportato: nextSevenDays

Valore	Descrizione
nextSevenDays	Mostra le ore di funzionamento per la settimana successiva, a partire dal giorno corrente nell'ora locale dell'area di interesse.

OperatingHoursTime

Object

Rappresenta una data e un'ora

Nome	Tipo	Descrizione
date	string	Rappresenta la data del calendario corrente nel fuso orario dei punti di interesse, ad esempio "2019-02-07".
hour	integer	Le ore sono nel formato 24 ore nell'ora locale di un punto di interesse; i valori possibili sono compresi tra 0 e 23.
minute	integer	I minuti sono nell'ora locale di un punto di interesse; i valori possibili sono compresi tra 0 e 59.

OperatingHoursTimeRange

Object

Aprire l'intervallo di tempo per un giorno

Nome	Tipo	Descrizione
endTime	OperatingHoursTime	Punto nell'intervallo di 7 giorni successivo quando un punto di interesse specificato viene chiuso o l'inizio dell'intervallo se è stato chiuso prima dell'intervallo.
startTime	OperatingHoursTime	Punto nell'intervallo di 7 giorni successivo quando viene aperto un punto di interesse specificato o l'inizio dell'intervallo se è stato aperto prima dell'intervallo.

PointOfInterest

Object

Dettagli del punto di interesse restituito, incluse informazioni quali il nome, il telefono, l'indirizzo URL e le classificazioni.

Nome	Tipo	Descrizione
brands	Brand[]	Matrice di marchi. Nome del marchio per il punto di interesse restituito.
categories	string[]	Matrice categorie
categorySet	PointOfInterestCategorySet[]	Elenco delle categorie di punti di interesse più specifiche
classifications	Classification[]	Matrice di classificazione
name	string	Nome della proprietà POI
openingHours	OperatingHours	Ore di apertura per un punto di interesse (punti di interesse).
phone	string	Proprietà numero di telefono
url	string	Proprietà URL sito Web

PointOfInterestCategorySet

Object

Categoria punti di interesse

Nome	Tipo	Descrizione
id	integer	ID categoria

QueryType

Enumerazione

Tipo di query restituito: NEARBY o NON_NEAR.

Valore	Descrizione
NEARBY	La ricerca è stata eseguita intorno a una certa latitudine e longitudine con un raggio definito
NON_NEAR	La ricerca è stata eseguita a livello globale, senza distorsioni a una certa latitudine e longitudine e nessun raggio definito

ResponseFormat

Enumerazione

Formato desiderato della risposta. Il valore può essere json o xml.

Valore	Descrizione
json	il formato dell'interscambio dati notazione oggetto JavaScript
xml	la extensible markup language

SearchAddressResult

Object

Questo oggetto viene restituito dalle chiamate di ricerca riuscite.

Nome	Tipo	Descrizione
results	SearchAddressResultItem[]	Elenco dei risultati dell'API di ricerca.
summary	SearchSummary	Oggetto Riepilogo per una risposta dell'API di ricerca

SearchAddressResultItem

Object

Oggetto Result per una risposta dell'API di ricerca.

Nome	Tipo	Descrizione
address	Address	Indirizzo del risultato
addressRanges	AddressRanges	Descrive l'intervallo di indirizzi su entrambi i lati della strada per un risultato di ricerca. Sono incluse le coordinate per le posizioni iniziale e finale dell'intervallo di indirizzi.
dataSources	DataSources	Sezione facoltativa. ID geometry di riferimento da usare con l'API get search polygon.
detourTime	integer	Tempo di deviazione in secondi. Restituito solo per le chiamate all'API Search Along Route.
dist	number (double)	Distanza linea retta tra il risultato e la posizione geobias in metri.
entityType	GeographicEntityType	Tipo di entità Geography. Presente solo quando entityType è stato richiesto ed è disponibile.
entryPoints	EntryPoint[]	Matrice di Punti di ingresso. Questi descrivono i tipi di ingressi disponibili nella posizione. Il tipo può essere "principale" per gli ingressi principali, ad esempio una porta anteriore, o una hall, e "minore", per porte laterali e posteriore.
id	string	Id - proprietà
info	string	Informazioni sull'origine dati originale del risultato. Usato per le richieste di supporto.
matchType	MatchType	Informazioni sul tipo di corrispondenza. Uno dei seguenti: AddressPoint HouseNumberRange Via
poi	PointOfInterest	Dettagli del punto di interesse restituito, incluse informazioni quali il nome, il telefono, l'indirizzo URL e le classificazioni.
position	LatLongPairAbbreviated	Posizione rappresentata come latitudine e longitudine usando nomi brevi 'lat' & 'lon'.
score	number (double)	Valore all'interno di un set di risultati per indicare il punteggio di corrispondenza relativo tra i risultati. È possibile usarlo per determinare che il risultato x è il doppio delle probabilità di essere rilevante come risultato y se il valore di x è 2x il valore di y. I valori variano tra le query e sono destinati solo a un valore relativo per un set di risultati.
type	SearchAddressResultType	Uno dei seguenti: POI (Punto di interesse) Via Geografia Punto di interesse Intervallo di indirizzi Incrocio
viewport	BoundingBox	Riquadro di visualizzazione che copre il risultato rappresentato dalle coordinate superiore sinistra e inferiore destra del riquadro di visualizzazione.

SearchAddressResultType

Enumerazione

Uno dei seguenti:

• POI (Punto di interesse)
• Via
• Geografia
• Punto di interesse
• Intervallo di indirizzi
• Incrocio

Valore	Descrizione
Address Range
Cross Street
Geography
POI
Point Address
Street

SearchIndexes

Enumerazione

Indici per i quali i codici postali estesi devono essere inclusi nei risultati.

Gli indici disponibili sono:

Addr = Intervalli di indirizzi

Geo = Aree geografiche

PAD = Indirizzi punto

punto di interesse = Punti di interesse

Str = Strade

XStr = Cross Street (intersezioni)

Il valore deve essere un elenco delimitato da virgole di tipi di indice (in qualsiasi ordine) o Nessuna per nessun indice.

Per impostazione predefinita, i codici postali estesi sono inclusi per tutti gli indici tranne Geo. Gli elenchi di codici postali estesi per le aree geografiche possono essere molto lunghi, quindi devono essere richiesti in modo esplicito quando necessario.

Esempi di utilizzo:

extendedPostalCodesFor=POI

extendedPostalCodesFor=PAD,Addr,POI

extendedPostalCodesFor=None

Il codice postale esteso viene restituito come proprietà extendedPostalCode di un indirizzo. La disponibilità dipende dall'area.

Valore	Descrizione
Addr
Geo
PAD
POI
Str
Xstr

SearchInsideGeometryRequest

Object

Questo tipo rappresenta il corpo della richiesta per il servizio Cerca all'interno della geometria.

Nome	Tipo	Descrizione
geometry	GeoJsonObject: GeoJsonFeature GeoJsonFeatureCollection	Oggetto GeoJSON valido. Per informazioni dettagliate, vedere RFC 7946.

SearchSummary

Object

Oggetto riepilogo per una risposta dell'API di ricerca.

Nome	Tipo	Descrizione
fuzzyLevel	integer	Livello massimo di fuzzy necessario per fornire risultati.
geoBias	LatLongPairAbbreviated	Indicazione quando il motore di ricerca interno ha applicato una distorsione geospaziale per migliorare la classificazione dei risultati. In alcuni metodi, questa operazione può essere influenzata impostando i parametri lat e lon, se disponibili. In altri casi è puramente interno.
limit	integer	Numero massimo di risposte che verranno restituite
numResults	integer	Numero di risultati nella risposta.
offset	integer	Offset iniziale dell'oggetto Results restituito all'interno del set di risultati completo.
query	string	Parametro di query usato per produrre questi risultati della ricerca.
queryTime	integer	Tempo impiegato per la risoluzione della query, espresso in millisecondi.
queryType	QueryType	Tipo di query restituito: NEARBY o NON_NEAR.
totalResults	integer	Numero totale di risultati trovati.