Da indirizzi stradali a coordinate geografiche (e viceversa) in pochi istanti
Il Servizio di Geocoding è disponibile per 196 paesi, con mappatura ad alta precisione.
Tutte le informazioni di cui hai bisogno
Qui trovi qualche consiglio da prendere in considerazione per approcciare a questa API. Se preferisci forniamo esempi di codice, documentazione in OAS3, la possibilità di provare l'API dal vivo con la Swagger UI oppure importare l'intera collezione in Postman. Offriamo inoltre un ambiente di Sandbox dove puoi sperimentare tutte le API gratuitamente.
Utili consigli per iniziare con
Geocoding
Prendi il token nell'apposita sezione prima di cominciare.
Usa lo strumento online o generalo via API. Imposta una data di scadenza e aggiungi una serie di Scopes per limitare le possibli azioni permesse al token.
Munisciti del token nell' apposita sezione prima di cominciare.
Una volta ottenuto, effettua chiamate ai diversi endpoint in base alle tue esigenze.
- Oas file url https://console.openapi.com/oas/it/geocoding.openapi.json
- Fork or import with Postman
- Production domain geocoding.openapi.it
- Sandbox domain test.geocoding.openapi.it
- Production Scopes 2
-
Sandbox Scopes 2
- POST test.geocoding.openapi.it/geocode
- POST test.geocoding.openapi.it/reverse
Geocoding Api (1.0.0)
Documentazione dell'API di geocodifica
Recuperare informazioni su un luogo fornendo un indirizzo
Authorizations:
bearerAuth
Request Body schema: application/json
Per migliorare il successo dei risultati, si prega di specificare un indirizzo conforme al seguente formato: [via], [città] [codice postale] [paese].
| address required | string |
Responses
Response Schema: application/json
| success | string |
object |
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
Content type
application/json
{
- "address": "Via Cristoforo Colombo, Roma RM"
Response samples
- 200
Content type
application/json
{
- "success": "true",
- "elements": {
- "id": "v442c6653ee93a5733e8a9ea2f842cd5c250d2b6ab",
- "element": {
- "providedBy": "google_maps | openstreetmap",
- "latitude": 41.808916,
- "longitude": 12.4535602,
- "bounds": {
- "south": 41.7691104,
- "west": 12.3831487,
- "north": 41.8731993,
- "east": 12.4985637
- "streetNumber": "null",
- "streetName": "Via Cristoforo Colombo",
- "postalCode": "04019",
- "locality": "Roma",
- "subLocality": "null",
- "adminLevels": {
- "1": {
- "name": "Lazio",
- "code": "Lazio",
- "level": 1
- "2": {
- "name": "Citta Metropolitana di Roma",
- "code": "RM",
- "level": 2
- "3": {
- "name": "Roma",
- "code": "Roma",
- "level": 3
- "country": "Italy",
- "countryCode": "IT",
- "timezone": "null"
Ottenere informazioni sul luogo dall'ID o dalla latitudine/longitudine
Authorizations:
bearerAuth
Request Body schema: application/json
Ottenere informazioni sul luogo dall'ID o dalla latitudine/longitudine:
- Per ottenere informazioni tramite ID assicurarsi di passare il seguente formato:
{"tipo": "id", "id": "<id>"} - Per ottenere informazioni tramite lat/long, assicurarsi di fornire il seguente formato:
{"tipo": "coordinate", "lat": "<lat>", "long": "<long>"}
| id | string |
| type required | string |
| lat | number <float> |
| long | number <float> |
Responses
Response Schema: application/json
| success | string |
object |
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
Content type
application/json
{
- "id": "v442c6653ee93a5733e8a9ea2f842cd5c250d2b6ab",
- "type": "id | coordinates",
- "lat": 41.289294,
- "long": 13.2349029
Response samples
- 200
Content type
application/json
{
- "success": "true",
- "elements": {
- "id": "v442c6653ee93a5733e8a9ea2f842cd5c250d2b6ab",
- "element": {
- "providedBy": "google_maps | openstreetmap",
- "latitude": 41.808916,
- "longitude": 12.4535602,
- "bounds": {
- "south": 41.7691104,
- "west": 12.3831487,
- "north": 41.8731993,
- "east": 12.4985637
- "streetNumber": "null",
- "streetName": "Via Cristoforo Colombo",
- "postalCode": "04019",
- "locality": "Roma",
- "subLocality": "null",
- "adminLevels": {
- "1": {
- "name": "Lazio",
- "code": "Lazio",
- "level": 1
- "2": {
- "name": "Citta Metropolitana di Roma",
- "code": "RM",
- "level": 2
- "3": {
- "name": "Roma",
- "code": "Roma",
- "level": 3
- "country": "Italy",
- "countryCode": "IT",
- "timezone": "null"