GetGeocodingBatch interface
Metodi
| post(Search |
API Batch di geocodifica si applica a: vedere i livelli di prezzi. L'API Batch di geocodifica invia batch di query a 'API geocodifica usando solo una singola chiamata API. L'API consente al chiamante di eseguire il batch fino a 100 query. Inviare una richiesta batch sincronaL'API sincrona è consigliata per le richieste batch leggere. Quando il servizio riceve una richiesta, risponderà non appena vengono calcolati gli elementi batch e non sarà possibile recuperare i risultati in un secondo momento. L'API sincrona restituirà un errore di timeout (una risposta 408) se la richiesta richiede più di 60 secondi. Il numero di elementi batch è limitato a 100 per questa API. Corpo POST per la richiesta batchPer inviare la geocodifica query, si userà una richiesta di Un oggetto geocodifica batchItem può accettare uno qualsiasi dei parametri URI geocodifica supportati. Il batch deve contenere almeno 1 query. Modello di risposta batchLa risposta batch contiene un componente
|
Dettagli metodo
post(SearchGetGeocodingBatchParameters)
API Batch di geocodifica
si applica a: vedere i livelli di prezzi.
L'API Batch di geocodifica invia batch di query a 'API geocodifica usando solo una singola chiamata API. L'API consente al chiamante di eseguire il batch fino a 100 query.
Inviare una richiesta batch sincrona
L'API sincrona è consigliata per le richieste batch leggere. Quando il servizio riceve una richiesta, risponderà non appena vengono calcolati gli elementi batch e non sarà possibile recuperare i risultati in un secondo momento. L'API sincrona restituirà un errore di timeout (una risposta 408) se la richiesta richiede più di 60 secondi. Il numero di elementi batch è limitato a 100 per questa API.
POST https://atlas.microsoft.com/geocode:batch?api-version=2023-06-01
Corpo POST per la richiesta batch
Per inviare la geocodifica query, si userà una richiesta di POST in cui il corpo della richiesta conterrà la matrice batchItems in formato json e l'intestazione Content-Type verrà impostata su application/json. Ecco un corpo di richiesta di esempio contenente 2 query di geocodifica:
{
"batchItems": [
{
"addressLine": "One, Microsoft Way, Redmond, WA 98052",
"top": 2
},
{
"addressLine": "Pike Pl",
"adminDistrict": "WA",
"locality": "Seattle",
"top": 3
}
]
}
Un oggetto geocodifica batchItem può accettare uno qualsiasi dei parametri URI geocodifica supportati.
Il batch deve contenere almeno 1 query.
Modello di risposta batch
La risposta batch contiene un componente summary che indica il totalRequests che faceva parte della richiesta batch originale e successfulRequests ad esempio le query eseguite correttamente. La risposta batch include anche una matrice di batchItems che contiene una risposta per ogni query e ogni query nella richiesta batch. Il batchItems conterrà i risultati nello stesso ordine in cui le query originali sono state inviate nella richiesta batch. Ogni elemento è di uno dei tipi seguenti:
GeocodingResponse: se la query è stata completata correttamente.Error: se la query non è riuscita. La risposta conterrà uncodee unmessagein questo caso.
function post(options: SearchGetGeocodingBatchParameters): StreamableMethod<SearchGetGeocodingBatch200Response | SearchGetGeocodingBatchDefaultResponse>Parametri
Restituisce
Azure SDK for JavaScript
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per