Package google.maps.mapmanagement.v2alpha

Indice

MapManagement

L'API di gestione delle mappe supporta le operazioni CRUD sulle risorse di personalizzazione delle mappe basata su cloud: MapConfigs, StyleConfigs e MapContextConfigs. Con questa API, gli sviluppatori possono gestire l'aspetto visivo delle loro mappe e personalizzarle in base alle loro specifiche.

CreateMapConfig

rpc CreateMapConfig(CreateMapConfigRequest) returns (MapConfig)

Crea un MapConfig in un progetto.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform
CreateMapContextConfig

rpc CreateMapContextConfig(CreateMapContextConfigRequest) returns (MapContextConfig)

Crea un oggetto MapContextConfig.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform
CreateStyleConfig

rpc CreateStyleConfig(CreateStyleConfigRequest) returns (StyleConfig)

Crea un oggetto StyleConfig.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform
DeleteMapConfig

rpc DeleteMapConfig(DeleteMapConfigRequest) returns (Empty)

Elimina un MapConfig.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform
DeleteMapContextConfig

rpc DeleteMapContextConfig(DeleteMapContextConfigRequest) returns (Empty)

Elimina un MapContextConfig.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform
DeleteStyleConfig

rpc DeleteStyleConfig(DeleteStyleConfigRequest) returns (Empty)

Elimina una StyleConfig.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform
GetMapConfig

rpc GetMapConfig(GetMapConfigRequest) returns (MapConfig)

Recupera un oggetto MapConfig.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform
GetMapContextConfig

rpc GetMapContextConfig(GetMapContextConfigRequest) returns (MapContextConfig)

Recupera un MapContextConfig.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform
GetStyleConfig

rpc GetStyleConfig(GetStyleConfigRequest) returns (StyleConfig)

Recupera un StyleConfig.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform
ListMapConfigs

rpc ListMapConfigs(ListMapConfigsRequest) returns (ListMapConfigsResponse)

Elenca MapConfig per un progetto.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform
ListMapContextConfigs

rpc ListMapContextConfigs(ListMapContextConfigsRequest) returns (ListMapContextConfigsResponse)

Elenca MapContextConfig.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform
ListStyleConfigs

rpc ListStyleConfigs(ListStyleConfigsRequest) returns (ListStyleConfigsResponse)

Elenca StyleConfig.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform
UpdateMapConfig

rpc UpdateMapConfig(UpdateMapConfigRequest) returns (MapConfig)

Aggiorna un MapConfig.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform
UpdateMapContextConfig

rpc UpdateMapContextConfig(UpdateMapContextConfigRequest) returns (MapContextConfig)

Aggiorna un MapContextConfig.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform
UpdateStyleConfig

rpc UpdateStyleConfig(UpdateStyleConfigRequest) returns (StyleConfig)

Aggiorna un StyleConfig.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

CreateMapConfigRequest

Richiedi di creare un MapConfig.

Campi
parent

string

Obbligatorio. Progetto padre proprietario di MapConfig. Formato: projects/{$my-project-id}
map_config

MapConfig

Obbligatorio. MapConfig da creare.

CreateMapContextConfigRequest

Richiedi di creare un MapContextConfig.

Campi
parent

string

Obbligatorio. MapConfig principale che possiederà MapContextConfig. Formato: projects/{project}/mapConfigs/{map_config}
map_context_config

MapContextConfig

Obbligatorio. MapContextConfig da creare.

CreateStyleConfigRequest

Richiedi di creare un StyleConfig.

Campi
parent

string

Obbligatorio. Progetto padre proprietario di StyleConfig. Formato: projects/{project}
style_config

StyleConfig

Obbligatorio. StyleConfig da creare.

DeleteMapConfigRequest

Richiesta di eliminazione di un MapConfig. Se MapConfig contiene MapContextConfig secondari, anche questi verranno eliminati.

Campi
name

string

Obbligatorio. Il nome risorsa di MapConfig da eliminare. Formato: projects/{project}/mapConfigs/{map_config}
force

bool

Facoltativo. Se impostato su true, verranno eliminati anche tutti i MapContextConfigs di questo MapConfig. In caso contrario, la richiesta funzionerà solo se MapConfig non ha MapContextConfigs.

DeleteMapContextConfigRequest

Richiesta di eliminazione di un MapContextConfig.

Campi
name

string

Obbligatorio. Il nome della risorsa MapContextConfig da eliminare. Formato: projects/{project}/mapConfigs/{map_config}/mapContextConfigs/{map_context_config}

DeleteStyleConfigRequest

Richiesta di eliminazione di un StyleConfig.

Campi
name

string

Obbligatorio. Nome della risorsa StyleConfig da eliminare. Formato: projects/{project}/styleConfigs/{style_config}

GetMapConfigRequest

Richiesta per ottenere un MapConfig.

Campi
name

string

Obbligatorio. Nome risorsa di MapConfig. Formato: projects/{project}/mapConfigs/{map_config}

GetMapContextConfigRequest

Richiesta per ottenere un oggetto MapContextConfig.

Campi
name

string

Obbligatorio. Nome risorsa di MapContextConfig. Formato: projects/{project}/mapConfigs/{map_config}/mapContextConfigs/{map_context_config}

GetStyleConfigRequest

Richiesta per ottenere un oggetto StyleConfig.

Campi
name

string

Obbligatorio. Nome risorsa di StyleConfig. Formato: projects/{project}/styleConfigs/{style_config}

ListMapConfigsRequest

Richiesta di elencare MapConfigs.

Campi
parent

string

Obbligatorio. Progetto padre proprietario di MapConfigs. Formato: projects/{project}
page_size

int32

Facoltativo. Il numero massimo di MapConfig da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore. Se non specificato, verranno restituiti al massimo 50 MapConfig. Il valore massimo è 1000; i valori superiori a 1000 verranno forzati a 1000. ATTUALMENTE NON SUPPORTATO.
page_token

string

Facoltativo. Un token di pagina, ricevuto da una precedente chiamata ListMapConfigs. Forniscilo per recuperare la pagina successiva.

Durante la paginazione, tutti gli altri parametri forniti a ListMapConfigs devono corrispondere alla chiamata che ha fornito il token di pagina. ATTUALMENTE NON SUPPORTATO.

ListMapConfigsResponse

Risposta all'elenco MapConfigs.

Campi
map_configs[]

MapConfig

L'elenco di MapConfig.
next_page_token

string

Un token, che può essere inviato come page_token per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine. ATTUALMENTE NON SUPPORTATO.

ListMapContextConfigsRequest

Richiesta di elencare MapContextConfigs.

Campi
parent

string

Obbligatorio. MapConfig principale che possiede MapContextConfigs. Formato: projects/{project}/mapConfigs/{map_config}
page_size

int32

Facoltativo. Il numero massimo di MapContextConfigs da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore. Se non specificato, verranno restituiti al massimo 50 MapContextConfigs. Il valore massimo è 1000; i valori superiori a 1000 verranno forzati a 1000. ATTUALMENTE NON SUPPORTATO.
page_token

string

Facoltativo. Un token di pagina, ricevuto da una precedente chiamata ListMapContextConfigs. Forniscilo per recuperare la pagina successiva.

Durante la paginazione, tutti gli altri parametri forniti a ListMapContextConfigs devono corrispondere alla chiamata che ha fornito il token di pagina. ATTUALMENTE NON SUPPORTATO.

ListMapContextConfigsResponse

Risposta all'elenco MapContextConfigs.

Campi
map_context_configs[]

MapContextConfig

MapContextConfigs.
next_page_token

string

Un token, che può essere inviato come page_token per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine. ATTUALMENTE NON SUPPORTATO.

ListStyleConfigsRequest

Richiedi di elencare StyleConfigs.

Campi
parent

string

Obbligatorio. Progetto padre proprietario di StyleConfigs. Formato: projects/{project}
page_size

int32

Facoltativo. Il numero massimo di StyleConfig da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore. Se non specificato, verranno restituiti al massimo 50 StyleConfig. Il valore massimo è 1000; i valori superiori a 1000 verranno forzati a 1000. ATTUALMENTE NON SUPPORTATO.
page_token

string

Facoltativo. Un token di pagina, ricevuto da una precedente chiamata ListStyleConfigs. Forniscilo per recuperare la pagina successiva.

Durante la paginazione, tutti gli altri parametri forniti a ListStyleConfigs devono corrispondere alla chiamata che ha fornito il token di pagina. ATTUALMENTE NON SUPPORTATO.
filter

string

Facoltativo. Espressione di filtro per la chiamata ListStyleConfigs. Al momento supporta solo il filtro in base a display_name. Ad esempio: display_name="My StyleConfig" restituirà tutti gli StyleConfig con il nome visualizzato "My StyleConfig".
view

StyleConfigView

Facoltativo. Il sottoinsieme di StyleConfig da restituire. Se questo campo non è impostato, il comportamento predefinito è restituire la visualizzazione COMPLETA.

ListStyleConfigsResponse

Risposta all'elenco StyleConfigs.

Campi
style_configs[]

StyleConfig

StyleConfigs.
next_page_token

string

Un token, che può essere inviato come page_token per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine. ATTUALMENTE NON SUPPORTATO.

MapConfig

Rappresenta una singola mappa in un'applicazione client API di Google Maps. MapConfig è la risorsa principale di MapContextConfigs e consente di personalizzare lo stile negli SDK (mobile/web). Un MapConfig può avere più MapContextConfig, ognuno dei quali applica lo stile a varianti specifiche della mappa. ID successivo = 9;

Campi
name

string

Solo output. Identificatore. Nome risorsa di questo MapConfig. Ad esempio: "projects/my-project-123/mapConfigs/234". Solo output.
display_name

string

Facoltativo. Il nome visualizzato di questo MapConfig, specificato dall'utente.
description

string

Facoltativo. La descrizione di questa MapConfig, come specificato dall'utente.
map_id

string

Solo output. L'ID mappa di questo MapConfig, utilizzato per identificare la mappa nelle applicazioni client. Questo campo di sola lettura viene generato quando viene creato MapConfig. Solo output.
map_features

MapFeatures

Facoltativo. Gli elementi mappa che si applicano a questa configurazione della mappa.
map_type

MapRenderingType

Facoltativo. Rappresenta il tipo di mappa di MapConfig. Se non è impostato, il comportamento predefinito prevede l'utilizzo del tipo di mappa raster.
create_time

Timestamp

Solo output. Indica la data di creazione della configurazione della mappa. Solo output.
update_time

Timestamp

Solo output. Indica l'ora dell'ultimo aggiornamento della configurazione della mappa. Solo output.

MapContextConfig

Contiene la configurazione dello stile per una mappa. MapContextConfig associa componenti di stile, come StyleConfig e set di dati, a varianti di mappe specifiche di un MapConfig. Quando MapConfig viene caricato in un SDK, le informazioni su stili e set di dati di MapContextConfig vengono applicate alle varianti di mappa specificate. ID successivo = 10;

Campi
name

string

Solo output. Identificatore. Nome risorsa di questo MapContextConfig. Ad esempio: projects/{project_id}/mapConfigs/{map_id}/mapContextConfigs/{map_context_config_id}
map_config

string

Obbligatorio. Il nome della risorsa MapConfig a cui è associata questa MapContextConfig. Formato: projects/{project}/mapConfigs/{map_config}. Questo campo è obbligatorio e non può essere omesso.
style_config

string

Obbligatorio. Il nome della risorsa StyleConfig che applica lo stile a questo MapContextConfig. Questo campo è obbligatorio e non può essere omesso. Formato: projects/{project}/styleConfigs/{style_config}
dataset[]

string

Facoltativo. Il nome della risorsa del set di dati associata a questo MapContextConfig. Questo campo è facoltativo e può essere omesso. Se omesso, nessun set di dati verrà associato a MapContextConfig. Se viene specificato un set di dati, questo verrà applicato a MapContextConfig. Formato: projects/{project}/datasets/{dataset}
alias

string

Facoltativo. Il nome leggibile definito dall'utente per questo MapContextConfig.
map_variants[]

MapVariant

Obbligatorio. Le varianti della mappa a cui può essere applicata questa MapContextConfig. Se è vuoto, MapContextConfig verrà applicato per impostazione predefinita solo alla variante della mappa ROADMAP.
create_time

Timestamp

Solo output. Indica l'ora di creazione di MapContextConfig. Solo output.
update_time

Timestamp

Solo output. Indica l'ora dell'ultimo aggiornamento di MapContextConfig. Solo output.

MapVariant

Possibili varianti della mappa a cui può essere applicato MapContextConfig. Le varianti della mappa sono raggruppate in varianti chiare e scure. Una variante Light non può essere accoppiata a una variante Dark per la stessa MapContextConfig. Le varianti di stile chiaro sono: ROADMAP, SATELLITE, TERRAIN, NAVIGATION, TRANSIT, ABSTRACT3D, PHOTOREALISTIC3D. Le varianti scure sono: ROADMAP_DARK, NAVIGATION_LOW_LIGHT, TERRAIN_DARK, TRANSIT_DARK.

Ad esempio, il seguente è un accoppiamento valido: {MapContextConfig 1: [ROADMAP, NAVIGATION]} {MapContextConfig 2: [ROADMAP_DARK, NAVIGATION_LOW_LIGHT]}

Il seguente accoppiamento non è valido: {MapContextConfig 1: [ROADMAP, ROADMAP_DARK]}

Enum
ROADMAP Il tipo di mappa roadmap predefinito.
ROADMAP_DARK Una versione scura del tipo di mappa Roadmap.
SATELLITE Immagini satellitari.
TERRAIN Tipo di mappa Rilievo.
TERRAIN_DARK Una versione scura del tipo di mappa Rilievo.
NAVIGATION Tipo di mappa di navigazione.
NAVIGATION_LOW_LIGHT Una versione con scarsa illuminazione del tipo di mappa di navigazione.
TRANSIT Tipo di mappa del trasporto pubblico.
TRANSIT_DARK Una versione scura del tipo di mappa del trasporto pubblico.
ABSTRACT3D Tipo di mappa 3D astratta.
PHOTOREALISTIC3D Tipo di mappa 3D fotorealistica.

MapFeatures

Rappresenta una raccolta di funzionalità della mappa che si applicano a un MapConfig. Le funzionalità impostate in un MapConfig vengono ereditate da tutti i relativi MapContextConfig secondari. Next ID = 3;

Campi
simple_features[]

SimpleFeature

Facoltativo. La funzionalità visiva da utilizzare per questa mappa.
poi_boost_level

int32

Facoltativo. Livello di incremento dei PDI, dove 0 indica nessun incremento e i valori negativi indicano una riduzione. I PDI potenziati vengono mostrati con un livello di zoom inferiore rispetto a quello predefinito e viceversa per quelli declassati. Attualmente supporta due livelli di potenziamento, quindi il livello è bloccato tra -2 e 2. Se non specificata, verrà utilizzata la densità dei PDI definita nel foglio di stile, se esistente. In caso contrario, non verrà applicata alcuna densità di PDI.

SimpleFeature

Rappresenta l'insieme delle funzionalità della mappa che influiscono sulla struttura intrinseca della mappa.

Enum
SIMPLE_FEATURE_UNSPECIFIED Funzionalità visiva non specificata.
FLATTEN_BUILDINGS Appiattisce tutti gli edifici nella mappa.
ICONIC_ICONS Influisce sul rendering delle icone.

MapRenderingType

Il tipo di mappa da visualizzare. Se non specificato, il comportamento predefinito è RASTER.

Enum
RASTER Una mappa visualizzata utilizzando l'implementazione basata su raster.
VECTOR Una mappa di cui è stato eseguito il rendering utilizzando WebGL.

StyleConfig

Rappresenta un singolo stile in un'applicazione client API di Google Maps. StyleConfig contiene il foglio di stile che definisce l'aspetto visivo della mappa. ID successivo = 9;

Campi
name

string

Solo output. Identificatore. Nome risorsa di questo StyleConfig. Ad esempio: "projects/my-project-123/styleConfigs/234".
display_name

string

Facoltativo. Il nome visualizzato di questo StyleConfig, specificato dall'utente.
description

string

Facoltativo. La descrizione di questo StyleConfig, come specificato dall'utente.
style_id

string

Solo output. L'identificatore univoco di questo stile. Questo è un campo di sola lettura generato al momento della creazione di StyleConfig. Solo output.
json_style_sheet

string

Facoltativo. Rappresentazione JSON del foglio di stile per questo StyleConfig. Se non specificato, verrà utilizzato lo stile di mappa di base di Google. Per ulteriori dettagli sul formato JSON accettabile, consulta la pagina https://developers.google.com/maps/documentation/javascript/cloud-customization/json-reference.
create_time

Timestamp

Solo output. Indica l'ora di creazione di StyleConfig.
update_time

Timestamp

Solo output. Indica l'ora dell'ultimo aggiornamento di StyleConfig.

StyleConfigView

Quale sottoinsieme di StyleConfig restituire.

Enum
STYLE_CONFIG_VIEW_UNSPECIFIED Visualizzazione non specificata.
FULL Includi json_style_sheet nella risposta.
METADATA_ONLY Escludi json_style_sheet dalla risposta.

UpdateMapConfigRequest

Richiesta di aggiornamento di un MapConfig.

Campi
map_config

MapConfig

Obbligatorio. MapConfig da aggiornare.

Il campo name di MapConfig viene utilizzato per identificare il MapConfig da aggiornare. Formato: projects/{project}/mapConfigs/{map_config}
update_mask

FieldMask

Facoltativo. Il campo specifico da aggiornare per MapConfig. Se non specificato, MapConfig verrà aggiornato nella sua interezza. I campi validi sono:

  • display_name
  • description
  • map_features

UpdateMapContextConfigRequest

Richiesta di aggiornamento di un MapContextConfig.

Campi
map_context_config

MapContextConfig

Obbligatorio. Il MapContextConfig da aggiornare.

Il campo name di MapContextConfig viene utilizzato per identificare il MapContextConfig da aggiornare. Formato: projects/{project}/mapConfigs/{map_config}/mapContextConfigs/{map_context_config}
update_mask

FieldMask

Facoltativo. L'elenco dei campi da aggiornare. Se non specificato, MapContextConfig verrà aggiornato nella sua interezza. I campi validi sono:

  • display_name
  • alias
  • map_variants
  • style_config
  • dataset

UpdateStyleConfigRequest

Richiedi l'aggiornamento di un file StyleConfig.

Campi
style_config

StyleConfig

Obbligatorio. StyleConfig da aggiornare.

Il campo name di StyleConfig viene utilizzato per identificare StyleConfig da aggiornare. Formato: projects/{project}/styleConfigs/{style_config}
update_mask

FieldMask

Facoltativo. L'elenco dei campi da aggiornare. Se non specificato, StyleConfig verrà aggiornato nella sua interezza. I campi validi sono:

  • display_name
  • description
  • json_style_sheet