Modello tessera per il trasporto pubblico

Le tessere del trasporto pubblico supportano il rendering dei modelli. Se non è definito alcun modello, viene utilizzato quello predefinito.

Definizione del modello

Un modello di tessera è definito a livello di classe e viene utilizzato per visualizzare qualsiasi oggetto associato alla classe. Il modello definisce i campi da visualizzare nelle diverse sezioni della tessera.

Il modello è suddiviso nelle seguenti sezioni:

Android

Panoramica delle sezioni e delle posizioni del layout del modello di tessera

Web

Panoramica delle sezioni e delle posizioni del layout del modello di tessera

Titolo della scheda

Android

Elementi di layout del titolo della scheda e posizioni dei campi Titolo della scheda predefinito
  1. class.logo
  2. class.localizedIssuerName
    o class.issuerName
  3. object.ticketLeg.originName
  4. object.ticketLeg.destinationName
  5. object.ticketLeg.originStationCode
  6. object.ticketLeg.destinationStationCode
  7. object.tripType
  8. object.hexBackgroundColor
    o class.hexBackgroundColor

Titolo della scheda con logo largo
  1. class.wideLogo
  2. object.ticketLeg.originName
  3. object.ticketLeg.destinationName
  4. object.ticketLeg.originStationCode
  5. object.ticketLeg.destinationStationCode
  6. object.tripType
  7. object.hexBackgroundColor
    o class.hexBackgroundColor

Web

Elementi di layout del titolo della scheda e posizioni dei campi Titolo della scheda predefinito
  1. class.logo
  2. class.localizedIssuerName
    o class.issuerName
  3. object.ticketLeg.originName
  4. object.ticketLeg.destinationName
  5. object.ticketLeg.originStationCode
  6. object.ticketLeg.destinationStationCode
  7. object.tripType
  8. object.hexBackgroundColor
    o class.hexBackgroundColor

Titolo della scheda con logo largo
  1. class.wideLogo
  2. object.ticketLeg.originName
  3. object.ticketLeg.destinationName
  4. object.ticketLeg.originStationCode
  5. object.ticketLeg.destinationStationCode
  6. object.tripType
  7. object.hexBackgroundColor
    o class.hexBackgroundColor

La sezione del titolo della scheda mostra il logo, il nome dell'operatore del trasporto pubblico e il riepilogo del viaggio. Tutti e tre gli elementi sono obbligatori e non è possibile modificare i riferimenti ai campi utilizzati per compilarli né la loro posizione.

Tuttavia, la logica di rendering consente una certa flessibilità per la prima riga. La riga superiore della tessera, che rappresenta un riepilogo del viaggio, è controllata dai seguenti campi in TransitObject per un viaggio a una sola tratta:

  • object.tripType
  • object.ticketLeg.originName
  • object.ticketLeg.destinationName
  • object.ticketLeg.originStationCode
  • object.ticketLeg.destinationStationCode

La modalità di rendering della tessera dipende dai campi non vuoti. Può essere visualizzato nei seguenti modi:

  • Solo nome dell'origine: viene visualizzato solo il nome dell'origine. Ciò è particolarmente utile per i biglietti che coprono un'area anziché un viaggio specifico.
  • Origine e destinazione: l'origine si trova a sinistra e la destinazione a destra. Il simbolo tra i due dipende dal tipo di viaggio. L'origine e la destinazione vengono visualizzate come una delle seguenti opzioni:
    • Nomi e codici delle stazioni: mostriamo i codici delle stazioni con i nomi in un testo più piccolo in alto.
    • Solo nomi: mostriamo i nomi.
    • Solo codici stazione: vengono mostrati i codici stazione.

Gli oggetti TransitObject multi-leg funzionano in modo molto simile. In questo caso, non utilizzare object.ticketLeg. Devi invece utilizzare l'elenco object.ticketLegs[]. Devono essere definiti sia le origini che le destinazioni. I nomi o i codici delle stazioni, o entrambi, devono essere utilizzati in modo coerente in ogni tratta. L'origine visualizzata è l'origine del primo elemento dell'array, mentre la destinazione visualizzata è la destinazione dell'ultimo elemento dell'array.

Il colore di sfondo della tessera non è un campo obbligatorio e può essere definito sia a livello di classe che a livello di oggetto. Il campo Oggetto ha una priorità più alta e può essere utilizzato per ignorare il campo Classe.

Quando il campo del logo largo è impostato, sui dispositivi Android l'intestazione del modello predefinito con il logo e il nome dell'emittente viene sostituita dal logo largo.

Segui le linee guida per l'immagine del logo rettangolare quando crei il logo dell'intestazione rettangolare per visualizzare in modo ottimale l'immagine sui tuoi abbonamenti.

Modello di scheda

Android

Elementi di layout delle righe e posizioni dei campi del modello di scheda

Web

Elementi di layout delle righe e posizioni dei campi del modello di scheda

La sezione del modello di scheda viene utilizzata per visualizzare righe aggiuntive. Queste righe possono contenere campi di dati strutturati basati su testo o campi di moduli di testo.

Puoi specificare il numero di righe che definiscono il numero di oggetti nell'elenco class.classTemplateInfo.cardTemplateOverride.cardRowTemplateInfos[]. L'elenco richiede almeno un elemento e consigliamo di utilizzarne al massimo due. Ogni elemento deve essere di uno dei seguenti tipi:

  • oneItem, che accetta un elemento:
    • item
  • twoItems, che accetta due elementi:
    • startItem
    • endItem
  • threeItems, che accetta tre elementi:
    • startItem
    • middleItem
    • endItem

Ogni elemento può essere definito come un singolo selettore di campi (.firstValue), due selettori di campi (.firstValue e .secondValue) o un elemento predefinito (.predefinedItem). Vengono visualizzati sia i valori del campo selezionato sia le rispettive etichette. Quando definisci due selettori di campi, i valori dei campi selezionati vengono visualizzati con un separatore "/". Lo stesso vale per le etichette dei campi selezionati. Gli elementi predefiniti vengono utilizzati per definire un rendering più complesso.

Il seguente esempio di codice mostra come eseguire l'override delle sezioni delle righe della scheda del modello di scheda per specificare due righe. Ogni riga include tre elementi, ognuno dei quali fa riferimento a sei campi personalizzati textModuleData a livello di classe e alle relative intestazioni come etichette:

Python

 {
   ... //Rest of class
   "textModulesData": [
        {
            "header": "Label 1",
            "body": "Some info 1",
            "id": "myfield1"
        },
        {
            "header": "Label 2",
            "body": "Some info 2",
            "id": "myfield2"
        },
        {
            "header": "Label 3",
            "body": "Some info 3",
            "id": "myfield3"
        },
        {
            "header": "Label 4",
            "body": "Some info 4",
            "id": "myfield4"
        },
        {
            "header": "Label 5",
            "body": "Some info 5",
            "id": "myfield5"
        },
        {
            "header": "Label 6",
            "body": "Some info 6",
            "id": "myfield6"
        }
    ],
   "classTemplateInfo": {
        "cardTemplateOverride": {
            "cardRowTemplateInfos": [{
                "threeItems": {
                    "startItem": {
                        "firstValue": {
                            "fields": [{
                                "fieldPath": "class.textModulesData['myfield1']"
                            }]
                        }
                    },
                    "middleItem": {
                        "firstValue": {
                            "fields": [{
                                "fieldPath": "class.textModulesData['myfield2']"
                            }]
                        }
                    },
                    "endItem": {
                        "firstValue": {
                            "fields": [{
                                "fieldPath": "class.textModulesData['myfield3']"
                            }]
                        }
                    },
                }
            },{
                "threeItems": {
                    "startItem": {
                        "firstValue": {
                            "fields": [{
                                "fieldPath": "class.textModulesData['myfield4']"
                            }]
                        }
                    },
                    "middleItem": {
                        "firstValue": {
                            "fields": [{
                                "fieldPath": "class.textModulesData['myfield5']"
                            }]
                        }
                    },
                    "endItem": {
                        "firstValue": {
                            "fields": [{
                                "fieldPath": "class.textModulesData['myfield6']"
                            }]
                        }
                    },
                }
            }]
        }
    }
}
    

Java

// Rest of class
  .setTextModulesData((new ArrayList<TextModuleData>() {
    {
      add((new TextModuleData()).setHeader("Label 1")
        .setBody("Some info 1")
        .setId("myfield1"));
      add((new TextModuleData()).setHeader("Label 2")
        .setBody("Some info 1")
        .setId("myfield2"));
      add((new TextModuleData()).setHeader("Label 3")
        .setBody("Some info 3")
        .setId("myfield3"));
      add((new TextModuleData()).setHeader("Label 4")
        .setBody("Some info 4")
        .setId("myfield4"));
      add((new TextModuleData()).setHeader("Label 5")
        .setBody("Some info 5")
        .setId("myfield5"));
      add((new TextModuleData()).setHeader("Label 6")
        .setBody("Some info 5")
        .setId("myfield6"));
    }
  }))
  .setClassTemplateInfo((new ClassTemplateInfo())
    .setCardTemplateOverride((new CardTemplateOverride())
      .setCardRowTemplateInfos(new ArrayList<CardRowTemplateInfo>() {
        {
          add((new CardRowTemplateInfo()).setThreeItems((new CardRowThreeItems())
            .setStartItem((new TemplateItem()).setFirstValue((new FieldSelector()).setFields(new ArrayList<FieldReference>(){
              {
                add((new FieldReference()).setFieldPath("class.textModulesData['myfield1']"));
              }
            })))
            .setMiddleItem((new TemplateItem()).setFirstValue((new FieldSelector()).setFields(new ArrayList<FieldReference>(){
              {
                add((new FieldReference()).setFieldPath("class.textModulesData['myfield2']"));
              }
            })))
            .setEndItem((new TemplateItem()).setFirstValue((new FieldSelector()).setFields(new ArrayList<FieldReference>(){
              {
                add((new FieldReference()).setFieldPath("class.textModulesData['myfield3']"));
              }
            })))
          ));
          add((new CardRowTemplateInfo()).setThreeItems((new CardRowThreeItems())
            .setStartItem((new TemplateItem()).setFirstValue((new FieldSelector()).setFields(new ArrayList<FieldReference>(){
              {
                add((new FieldReference()).setFieldPath("class.textModulesData['myfield4']"));
              }
            })))
            .setMiddleItem((new TemplateItem()).setFirstValue((new FieldSelector()).setFields(new ArrayList<FieldReference>(){
              {
                add((new FieldReference()).setFieldPath("class.textModulesData['myfield5']"));
              }
            })))
            .setEndItem((new TemplateItem()).setFirstValue((new FieldSelector()).setFields(new ArrayList<FieldReference>(){
              {
                add((new FieldReference()).setFieldPath("class.textModulesData['myfield6']"));
              }
            })))
          ));
          }
  })))
    

PHP

// Rest of class
    $textModulesData1 = new Google_Service_Walletobjects_TextModuleData();
    $textModulesData1->setBody("Some info 1");
    $textModulesData1->setHeader("Label 1");
    $textModulesData1->setId("myfield1");

    $textModulesData2 = new Google_Service_Walletobjects_TextModuleData();
    $textModulesData2->setBody("Some info 2");
    $textModulesData2->setHeader("Label 2");
    $textModulesData2->setId("myfield2");

    $textModulesData3 = new Google_Service_Walletobjects_TextModuleData();
    $textModulesData3->setBody("Some info 3");
    $textModulesData3->setHeader("Label 3");
    $textModulesData3->setId("myfield3");

    $textModulesData4 = new Google_Service_Walletobjects_TextModuleData();
    $textModulesData4->setBody("Some info 4");
    $textModulesData4->setHeader("Label 4");
    $textModulesData4->setId("myfield4");

    $textModulesData5 = new Google_Service_Walletobjects_TextModuleData();
    $textModulesData5->setBody("Some info 5");
    $textModulesData5->setHeader("Label 5");
    $textModulesData5->setId("myfield5");

    $textModulesData6 = new Google_Service_Walletobjects_TextModuleData();
    $textModulesData6->setBody("Some info 6");
    $textModulesData6->setHeader("Label 6");
    $textModulesData6->setId("myfield6");

    $textModulesDatas = array($textModulesData1, $textModulesData2, $textModulesData3,
                  $textModulesData4, $textModulesData5, $textModulesData6);

    $startItemField = new Google_Service_Walletobjects_FieldReference();
    $startItemField->setFieldPath("class.textModulesData['myfield1']");

    $startItemFirstValue = new Google_Service_Walletobjects_FieldSelector();
    $startItemFirstValue->setFields(array($startItemField));

    $startItem = new Google_Service_Walletobjects_TemplateItem();
    $startItem->setFirstValue($startItemFirstValue);

    $middleItemField = new Google_Service_Walletobjects_FieldReference();
    $middleItemField->setFieldPath("class.textModulesData['myfield2']");

    $middleItemFirstValue = new Google_Service_Walletobjects_FieldSelector();
    $middleItemFirstValue->setFields(array($middleItemField));

    $middleItem = new Google_Service_Walletobjects_TemplateItem();
    $middleItem->setFirstValue($middleItemFirstValue);

    $endItemField = new Google_Service_Walletobjects_FieldReference();
    $endItemField->setFieldPath("class.textModulesData['myfield3']");

    $endItemFirstValue = new Google_Service_Walletobjects_FieldSelector();
    $endItemFirstValue->setFields(array($endItemField));

    $endItem = new Google_Service_Walletobjects_TemplateItem();
    $endItem->setFirstValue($endItemFirstValue);

    $cardRowTemplate = new Google_Service_Walletobjects_CardRowThreeItems();
    $cardRowTemplate->setStartItem($startItem);
    $cardRowTemplate->setMiddleItem($middleItem);
    $cardRowTemplate->setEndItem($endItem);

    $cardRowTemplateInfo1 = new Google_Service_Walletobjects_CardRowTemplateInfo();
    $cardRowTemplateInfo1->setThreeItems($cardRowTemplate);

    $startItemField2 = new Google_Service_Walletobjects_FieldReference();
    $startItemField2->setFieldPath("class.textModulesData['myfield4']");

    $startItemFirstValue2 = new Google_Service_Walletobjects_FieldSelector();
    $startItemFirstValue2->setFields(array($startItemField2));

    $startItem2 = new Google_Service_Walletobjects_TemplateItem();
    $startItem2->setFirstValue($startItemFirstValue2);

    $middleItemField2 = new Google_Service_Walletobjects_FieldReference();
    $middleItemField2->setFieldPath("class.textModulesData['myfield5']");

    $middleItemFirstValue2 = new Google_Service_Walletobjects_FieldSelector();
    $middleItemFirstValue2->setFields(array($middleItemField2));

    $middleItem2 = new Google_Service_Walletobjects_TemplateItem();
    $middleItem2->setFirstValue($middleItemFirstValue2);

    $endItemField2 = new Google_Service_Walletobjects_FieldReference();
    $endItemField2->setFieldPath("class.textModulesData['myfield6']");

    $endItemFirstValue2 = new Google_Service_Walletobjects_FieldSelector();
    $endItemFirstValue2->setFields(array($endItemField2));

    $endItem2 = new Google_Service_Walletobjects_TemplateItem();
    $endItem2->setFirstValue($endItemFirstValue2);

    $cardRowTemplate2 = new Google_Service_Walletobjects_CardRowThreeItems();
    $cardRowTemplate2->setStartItem($startItem2);
    $cardRowTemplate2->setMiddleItem($middleItem2);
    $cardRowTemplate2->setEndItem($endItem2);

    $cardRowTemplateInfo2 = new Google_Service_Walletobjects_CardRowTemplateInfo();
    $cardRowTemplateInfo2->setThreeItems($cardRowTemplate2);

    $cardTemplateOverride = new Google_Service_Walletobjects_CardTemplateOverride();
    $cardTemplateOverride->setCardRowTemplateInfos(array($cardRowTemplateInfo1,
                  $cardRowTemplateInfo2));

    $classTemplateInfo = new Google_Service_Walletobjects_ClassTemplateInfo();
    $classTemplateInfo->setCardTemplateOverride($cardTemplateOverride);

    $payload->setTextModulesData($textModulesDatas);
    $payload->setClassTemplateInfo($classTemplateInfo);
    

Il codice crea una tessera con il seguente formato della sezione del modello di codice:

Esempio di override dell'etichetta.

Se un elemento è vuoto, non viene visualizzato. Per maggiori dettagli, consulta Riferimenti ai campi. Se tutti gli elementi di una riga sono vuoti, la riga non viene visualizzata. Se alcuni, ma non tutti, gli elementi di una riga sono vuoti, gli elementi non vuoti vengono riorganizzati e visualizzati come una riga con meno elementi.

Se non esegui l'override del modello di scheda, vengono utilizzati il numero predefinito di righe, il numero predefinito di elementi e i riferimenti ai campi predefiniti. Per ulteriori dettagli, vedi Modello predefinito.

Dopo aver definito un'immagine hero, questa può essere visualizzata dopo la prima riga, se nell'elenco cardRowTemplateInfos sono presenti più righe, o sopra la riga, se ne è presente solo una.

Codice a barre della carta

Android

Elementi e posizioni del layout del codice a barre della carta
  1. class.classTemplateInfo
      .cardBarcodeSectionDetails
      .firstTopDetail
  2. class.classTemplateInfo
      .cardBarcodeSectionDetails
      .secondTopDetail
  3. object.barcode.type e object.barcode.value
    o object.ticketNumber
  4. object.barcode.alternateText
  5. class.classTemplateInfo
      .cardBarcodeSectionDetails
      .firstBottomDetail

Web

Elementi e posizioni del layout del codice a barre della carta
  1. class.classTemplateInfo
      .cardBarcodeSectionDetails
      .firstTopDetail
  2. class.classTemplateInfo
      .cardBarcodeSectionDetails
      .secondTopDetail
  3. object.barcode.type e object.barcode.value
    o object.ticketNumber
  4. object.barcode.alternateText
  5. class.classTemplateInfo
      .cardBarcodeSectionDetails
      .firstBottomDetail

La sezione del codice a barre della carta viene utilizzata per visualizzare testo o immagini aggiuntivi prima e dopo il codice a barre. Nessuno dei campi di questa sezione è obbligatorio.

Esistono tre selettori di campi che possono essere utilizzati per definire due campi affiancati, uno precedente e uno successivo al codice a barre. Questi vengono visualizzati senza etichetta e possono essere campi di dati strutturati basati su testo, campi di moduli di testo o campi di moduli di immagini. Se utilizzi immagini, queste devono rispettare le linee guida per il brand.

Il codice a barre è definito da un tipo e un valore. Per un elenco dei tipi di codici a barre supportati, consulta Riferimento. Inoltre, un testo può essere visualizzato direttamente sotto il codice a barre. Questo testo può semplificare la scansione dei codici a barre, tra gli altri utilizzi.

Il seguente esempio di codice mostra come eseguire l'override della sezione del codice a barre di una tessera per visualizzare un'immagine sopra il codice a barre:

Python

#... rest of class
    "imageModulesData": [
        {
            "mainImage": {
                "sourceUri": {
                    "uri":  "http://farm4.staticflickr.com/3738/12440799783_3dc3c20606_b.jpg",
                    "description": "Coffee"
                }
            },
            "id": "myimage"
        }
    ],
    "classTemplateInfo": {
        "cardBarcodeSectionDetails": {
            "firstTopDetail": {
                "fieldSelector": {
                    "fields": [
                        {
                        "fieldPath": "class.imageModulesData['myimage'].mainImage"
                        }
                    ]
                }
            }
        }
    }
}
    

Java

//... rest of class
  .setImageModulesData((new ArrayList<ImageModuleData>() {
    {
      add((new ImageModuleData())
        .setId("myimage")
        .setMainImage((new Image()).setSourceUri((new ImageUri()).setDescription("Coffee beans")
          .setUri("http://farm4.staticflickr.com/3738/12440799783_3dc3c20606_b.jpg"))));
        }
      }))
      .setClassTemplateInfo((new ClassTemplateInfo())
        .setCardBarcodeSectionDetails((new CardBarcodeSectionDetails())
          .setFirstTopDetail((new BarcodeSectionDetail())
            .setFieldSelector((new FieldSelector())
              .setFields((new ArrayList<FieldReference>(){
                {
                  add((new FieldReference()).setFieldPath("class.imageModulesData['myimage'].mainImage"));
                }
            })))))
      }
    

PHP

//... rest of class
    $imageUri = new Google_Service_Walletobjects_ImageUri();
    $imageUri->setUri("https://farm8.staticflickr.com/7340/11177041185_a61a7f2139_o.jpg");
    $imageUri->setDescription("Baconrista flights image");
    $image = new Google_Service_Walletobjects_Image();
    $image->setSourceUri($imageUri);
    $imageModulesData = new Google_Service_Walletobjects_ImageModuleData();
    $imageModulesData->setMainImage($image);
            $imageModulesData->setId("myimage");

    $cardBarcodeFieldReference = new Google_Service_Walletobjects_FieldReference();
    $cardBarcodeFieldReference->setFieldPath("class.imageModulesData['myimage'].mainImage");

    $cardBarcodeFieldSelector = new Google_Service_Walletobjects_FieldSelector();
    $cardBarcodeFieldSelector->setFields(array($cardBarcodeFieldReference));

    $cardBarcodeDetail = new Google_Service_Walletobjects_BarcodeSectionDetail();
    $cardBarcodeDetail->setFieldSelector($cardBarcodeFieldSelector);

    $cardBarcodeSectionDetails = new Google_Service_Walletobjects_CardBarcodeSectionDetails();
    $cardBarcodeSectionDetails->setFirstTopDetail($cardBarcodeDetail);

    $classTemplateInfo = new Google_Service_Walletobjects_ClassTemplateInfo();
    $classTemplateInfo->setCardBarcodeSectionDetails($cardBarcodeSectionDetails);

    $payload->setClassTemplateInfo($classTemplateInfo);
            $payload->setImageModuleData($imageModulesData);
    

Il codice crea una tessera con il seguente formato della sezione del codice a barre:

Esempio di override del codice a barre della carta.

Se non esegui l'override della sezione del codice a barre, vengono utilizzati i campi predefiniti del codice a barre. Per saperne di più, consulta Template predefinito.

Sezione inferiore

Android

Sezioni e elementi inferiori del modello di dettagli
  • Itinerario con più tappe
  • class.classTemplateInfo.detailsTemplateOverride
      .detailsItemInfos[0].item
  • class.classTemplateInfo.detailsTemplateOverride
      .detailsItemInfos[1].item
  • class.classTemplateInfo.detailsTemplateOverride
      .detailsItemInfos[2].item

Web

Sezioni e elementi inferiori del modello di dettagli
  • Itinerario con più tappe
  • class.classTemplateInfo.detailsTemplateOverride
      .detailsItemInfos[0].item
  • class.classTemplateInfo.detailsTemplateOverride
      .detailsItemInfos[1].item
  • class.classTemplateInfo.detailsTemplateOverride
      .detailsItemInfos[2].item

La sezione inferiore è un elenco di elementi class.classTemplateInfo.detailsTemplateOverride.detailsItemInfos[]. Gli elementi possono contenere qualsiasi tipo di campi di dati strutturati, campi di moduli di testo, campi di moduli di link, campi di moduli di immagini o messaggi.

Ogni elemento può essere definito come un singolo selettore di campo (.firstValue), due selettori di campo (.firstValue e .secondValue) o un elemento predefinito (.predefinedItem). Vengono visualizzati sia i valori del campo selezionato sia le rispettive etichette. Quando definisci due selettori di campi, i valori dei campi selezionati vengono visualizzati con un separatore "/". Lo stesso vale per le etichette dei campi selezionati. Gli elementi predefiniti vengono utilizzati per definire un rendering più complesso. I campi del modulo Immagine vengono visualizzati a tutta larghezza senza un'etichetta.

Il seguente esempio di codice mostra come eseguire l'override della sezione inferiore della tessera per visualizzare un singolo campo linksModuleData con la relativa etichetta:

Python

//... rest of class
   "linksModuleData": {
        "uris": [
            {
                "uri": "http://maps.google.com/",
                "description": "Nearby Locations",
                "id":"mylink"
            }
        ]
    },
   "classTemplateInfo": {
        "detailsTemplateOverride": {
            "detailsItemInfos": [
                {
                    "item":{
                        "firstValue": {
                            "fields": [{
                                "fieldPath": "class.linksModuleData.uris['mylink']"
                            }]
                        }
                    }
                }
            ]
        }
     }
//... rest of class
    

Java

 //... rest of class
  .setLinksModuleData((new ArrayList<LinksModuleData>() {
    {
      add((new LinksModuleData()).setDescription("Nearby Locations")
        .setUri("http://maps.google.com/")
        .setId("mylink"));
      }))
      .setClassTemplateInfo((new ClassTemplateInfo())
        .setDetailsTemplateOverride((new DetailsTemplateOverride())
          .setDetailsItemInfos(new ArrayList<DetailsItemInfo>(){
            {
              add((new DetailsItemInfo())
                .setItem((new TemplateItem()).setFirstValue((new FieldSelector()).setFields(new ArrayList<FieldReference>(){
                  {
                    add((new FieldReference()).setFieldPath("class.linksModuleData.uris['mylink']"));
                  }
                }))));
              }
            }))
//... rest of class
    

PHP

    //... rest of class building
    $locationUri = new Google_Service_Walletobjects_Uri();
    $locationUri->setUri("http://maps.google.com/");
    $locationUri->setDescription("Nearby Locations");
    $locationUri->setId("mylink");

    $linksModuleData = new Google_Service_Walletobjects_LinksModuleData();
    $linksModuleData->setUris(array($locationUri));

    $detailItemFieldReference = new Google_Service_Walletobjects_FieldReference();
    $detailItemFieldReference->setFieldPath("class.linksModuleData.uris['mylink']");
    $detailItemFieldSelector = new Google_Service_Walletobjects_FieldSelector();
    $detailItemFieldSelector->setFields(array($detailItemFieldReference));

    $detailItem = new Google_Service_Walletobjects_TemplateItem();
    $detailItem->setFirstValue($detailItemFieldSelector);

    $detailsItemInfo = new Google_Service_Walletobjects_DetailsItemInfo();
    $detailsItemInfo->setItem($detailItem);

    $cardDetailsTemplateOverride = new Google_Service_Walletobjects_DetailsTemplateOverride();
    $cardDetailsTemplateOverride->setDetailsItemInfos(array($detailsItemInfo));

    $classTemplateInfo = new Google_Service_Walletobjects_ClassTemplateInfo();
    $classTemplateInfo->setDetailsTemplateOverride($cardDetailsTemplateOverride);

    $payload->setClassTemplateInfo($classTemplateInfo);
    $payload->setLinksModuleData($linksModuleData);
    //... rest of class
    

Il codice crea una tessera con il seguente formato della sezione inferiore:

Esempio di override
                                                                             di una sezione inferiore.

Se un elemento è vuoto, non viene visualizzato. Per maggiori dettagli, consulta Riferimenti ai campi.

Se non esegui l'override della sezione inferiore, viene visualizzato l'elenco predefinito dei campi di riferimento nell'ordine predefinito. Per saperne di più, vedi Template predefinito.

Se il viaggio include più tratte, nella parte superiore della sezione viene visualizzato un semplice itinerario che non può essere spostato. Se il viaggio include una sola tratta, è possibile mostrare un itinerario semplice impostando class.enableSingleLegItinerary.

Itinerario con più tappe
  1. class.tranistType
  2. object.ticketLegs[i].originName
    o object.ticketLegs[i].originStationCode
  3. object.ticketLegs[i].departureDateTime (solo ora)
  4. object.ticketLegs[i].transitOperatorName
  5. COACH o class.customCoachLabel
  6. object.ticketLegs[i].ticketSeat.coach
    o object.ticketLegs[i].ticketSeats[*].coach
  7. SEAT o class.customSeatLabel
  8. object.ticketLegs[i].ticketSeat.seat
    o object.ticketLegs[i].ticketSeat.seatAssignment
    o object.ticketLegs[i].ticketSeats[*].seat
    o object.ticketLegs[i].ticketSeats[*].seatAssignment
    o NESSUN POSTO SPECIFICO
  9. object.hexBackgroundColor
    o class.hexBackgroundColor
  10. object.ticketLegs[i].destinationName
    o object.ticketLegs[i].destinationStationCode
  11. object.ticketLegs[i].arrivalDateTime (solo ora)
  12. TRANSFER TO: PLATFORM
    or TRANSFER TO: class.customPlatformLabel
    or TRANSFER (if no platform is defined)
  13. object.ticketLegs[i+1].platform

Modello di elenco

Elencare gli elementi del modello
  1. class.classTemplateInfo.listTemplateOverride
      .firstRowOption.fieldOption.fields[]
  2. object.ticketLeg.departureDateTime (raggruppato)
    o class.classTemplateInfo.listTemplateOverride
      .secondRowOption.fields[]
  3. class.logo
  4. object.hexBackgroundColor
    o class.hexBackgroundColor
  5. <# passes> (raggruppati)

La sezione del modello di elenco viene utilizzata per selezionare il campo da visualizzare nella visualizzazione "Tessere" dell'app Google Wallet. La tessera è rappresentata nell'elenco con il logo, il colore di sfondo e tre righe.

Il seguente esempio di codice mostra come eseguire l'override del modello di elenco di una tessera per mostrare un singolo campo della data di scadenza dell'oggetto delle tessere nella prima riga del modello di elenco:

Python

#... rest of class definition
   "classTemplateInfo": {
        "listTemplateOverride":{
            "firstRowOption": {
                "fieldOption":{
                    "fields": [{
                        "fieldPath": "object.validTimeInterval.end"
                    }]
                }
            }
        }
   }
}
    

Java

//... rest of class
  .setClassTemplateInfo((new ClassTemplateInfo())
    .setListTemplateOverride((new ListTemplateOverride())
      .setFirstRowOption((new FirstRowOption())
        .setFieldOption((new FieldSelector()).setFields(new ArrayList<FieldReference>(){
          {
            add((new FieldReference()).setFieldPath("object.validTimeInterval.end"));
          }
        }))))
//... rest of class
    

PHP

    //... rest of class
    $fieldReference = new Google_Service_Walletobjects_FieldReference();
    $fieldReference->setFieldPath("object.validTimeInterval.end");

    $fieldOption = new Google_Service_Walletobjects_FieldSelector();
    $fieldOption->setFields(array($fieldReference));

    $firstRowOption = new Google_Service_Walletobjects_FirstRowOption();
    $firstRowOption->setFieldOption($fieldOption);

    $listTemplateOverride = new Google_Service_Walletobjects_ListTemplateOverride();
    $listTemplateOverride->setFirstRowOption($firstRowOption);

    $classTemplateInfo = new Google_Service_Walletobjects_ClassTemplateInfo();
    $classTemplateInfo->setListTemplateOverride($listTemplateOverride);

    $payload->setClassTemplateInfo($classTemplateInfo);
    //... rest of class
    

Il codice crea una tessera con il seguente rendering del modello di elenco:

Esempio di override
                                                                           di elenco.

La prima riga può essere definita con un selettore di campi o mostra il riepilogo del percorso. Il formato del riepilogo può essere uno dei seguenti:

  • originAndDestinationCodes
  • originAndDestinationNames
  • originName

La seconda e la terza riga possono essere definite solo con un selettore di campi. I campi vengono visualizzati senza etichetta. Per le tessere raggruppate, la seconda riga mostra sempre la data di partenza e la terza riga mostra sempre il numero di tessere raggruppate.

Etichette

Tutti i campi dei dati strutturati hanno un'etichetta fornita da Google. Google è responsabile della fornitura di una traduzione per ciascuna di queste etichette in tutte le lingue supportate.

Puoi personalizzare alcune di queste etichette utilizzando uno dei campi class.custom<name_of_the_field>Label. Quando personalizzi un'etichetta, diventi responsabile della fornitura delle traduzioni per quella specifica etichetta in tutte le lingue che vuoi supportare.

Riferimenti ai campi

I riferimenti ai campi vengono utilizzati in diverse parti del modello con il modulo class.classTemplateInfo.*.fields[]. Un riferimento a un campo contiene un elenco di percorsi a campi di dati strutturati, campi di moduli di testo, campi di moduli di link, campi di moduli di immagini o messaggi.

Non tutti i tipi di percorsi sono consentiti in ogni riferimento di campo. Ad esempio, alcuni riferimenti ai campi consentono solo percorsi a campi di dati strutturati basati su testo o campi di moduli di testo. I campi strutturati basati su testo sono campi di dati strutturati di tipo stringa, stringa localizzata, data o valuta.

L'elenco può essere utilizzato per implementare una logica di fallback. Ciò significa che se il primo percorso nell'elenco viene risolto in un campo vuoto, viene valutato il percorso successivo. La logica di fallback è principalmente rivolta ai campi di dati strutturati basati su testo o ai campi dei moduli di testo. Non mescolare tipi diversi di campi nella stessa lista. Utilizza la logica di fallback con cautela e solo in situazioni specifiche in cui prevedi un pattern coerente di campi presenti in alcuni oggetti ma non in altri. La maggior parte delle volte è più facile creare classi separate per casi d'uso separati.

Se tutti i percorsi in un elenco di riferimenti ai campi vengono risolti in campi vuoti, l'elemento che utilizza il riferimento al campo non viene visualizzato. Se vuoi che l'elemento che utilizza il riferimento al campo sia sempre presente, assicurati che almeno un percorso non sia vuoto. Ti consigliamo di impostare un campo su un carattere speciale, ad esempio "-", per rappresentare un valore nullo, anche se alcuni campi consentono stringhe con un solo spazio.

Per fare riferimento a un campo contenuto in un elenco, puoi utilizzare l'indice del campo nell'elenco o, nella maggior parte dei casi, puoi utilizzare un ID di riferimento. Gli elementi di un elenco a cui è possibile fare riferimento tramite ID hanno un campo .id. Ti consigliamo di utilizzare un ID di riferimento anziché l'indice del campo nell'elenco, se disponibile.

Ecco un esempio di come fare riferimento ai campi contenuti in un elenco.

  • object.imageModulesData[0].id = my-first-id
  • object.imageModulesData[1].id = my-second-id
  • class.detailsTemplateOverride.detailsItemInfos[0].item.firstValue.fields[0].fieldPath = object.imageModulesData[‘my-second-id’]
  • class.detailsTemplateOverride.detailsItemInfos[1].item.firstValue.fields[0].fieldPath = object.imageModulesData[0]

In questo caso, il primo elemento nella sezione dei dettagli della tessera è la seconda immagine dichiarata nell'oggetto. Il secondo elemento nella sezione dei dettagli della tessera è la prima immagine dichiarata nell'oggetto.

Modello predefinito

Android

Elementi e posizioni del layout del modello di tessera predefinito
  1. class.logo
  2. class.localizedIssuerName
    o class.issuerName
  3. Visualizza titolo della scheda
  4. PARTENZA o VALIDO DAL
  5. object.ticketLeg.departureDateTime (data e ora)
    o object.validTimeInterval.start.date
  6. ARRIVING AT (ARRIVO PREVISTO) o VALID UNTIL (VALIDO FINO AL)
  7. object.ticketLeg.arrivalDateTime (solo ora)
    o object.validTimeInterval.end.date
  8. PASSENGER
  9. object.passengerNames
  10. CARRIAGE o class.customCarriageLabel
  11. object.ticketLeg.carriage
  12. COACH o class.customCoachLabel
  13. object.ticketLeg.ticketSeat.coach
  14. SEAT o class.customSeatLabel
  15. object.ticketLeg.ticketSeat.seat
    o object.ticketLeg.ticketSeat.seatAssignment
  16. object.barcode.type e object.barcode.value
    o object.ticketNumber
  17. object.barcode.alternateText
  18. object.hexBackgroundColor
    o class.hexBackgroundColor
  19. Itinerario con più tappe
  20. NUMERO BIGLIETTO o class.customTicketNumberLabel
  21. object.ticketNumber
  22. STATO DEL BIGLIETTO
  23. object.ticketStatus o object.customTicketStatus
  24. PARTENZA
  25. object.ticketLeg.departureDateTime
  26. ARRIVO
  27. object.ticketLeg.arrivalDateTime
  28. NOME DELLA TARIFFA o class.customFareNameLabel
  29. object.ticketLeg.fareName
  30. PIATTAFORMA o class.customPlatformLabel
  31. object.ticketLeg.platform
  32. ZONE o class.customZoneLabel
  33. object.ticketLeg.zone
  34. CLASSE TARIFFARIA o class.customFareClassLabel
  35. object.ticketLeg.ticketSeat.fareClass
    o object.ticketLeg.ticketSeat.customFareClass
  36. CATEGORIA DI CONCESSIONE
    o class.customConcessionCategoryLabel
  37. object.concessionCategory
    o object.customConcessionCategory
  38. LIMITAZIONI DEL PERCORSO
    o class.customRouteRestrictionsLabel
  39. object.ticketRestrictions.routeRestrictions
  40. DETTAGLI LIMITAZIONI DEL PERCORSO
    o class.customRouteRestrictionsDetailsLabel
  41. object.ticketRestrictions.routeRestrictionsDetails
  42. LIMITAZIONI DI TEMPO
    o class.customTimeRestrictionsLabel
  43. object.ticketRestrictions.timeRestrictions
  44. ALTRE LIMITAZIONI
    o class.customOtherRestrictionsLabel
  45. object.ticketRestrictions.otherRestrictions
  46. NUMERO RICEVUTA
    o class.customPurchaseReceiptNumberLabel
  47. object.purchaseDetails.purchaseReceiptNumber
  48. DATA DI ACQUISTO
  49. object.purchaseDetails.purchaseDateTime
  50. ID ACCOUNT
  51. object.purchaseDetails.accountId
  52. CODICE DI CONFERMA
    o class.customConfirmationCodeLabel
  53. object.purchaseDetails.confirmationCode
  54. VALORE NOMINALE o class.customPurchaseFaceValueLabel
  55. object.purchaseDetails.ticketCost.faceValue
  56. PREZZO o class.customPurchasePriceLabel
  57. object.purchaseDetails.ticketCost.purchasePrice
  58. MESSAGGIO SCONTO
    o class.customDiscountMessageLabel
  59. object.purchaseDetails.ticketCost.discountMessage
  60. class.imageModulesData[0].mainImage
  61. object.imageModulesData[0].mainImage
  62. class.messages[].header
  63. class.messages[].body
  64. object.messages[].header
  65. object.messages[].body
  66. class.textModulesData[0..9].header
  67. class.textModulesData[0..9].body
  68. object.textModulesData[0..9].header
  69. object.textModulesData[0..9].body
  70. class.linksModuleData.uris[].description
  71. object.linksModuleData.uris[].description

Web

Elementi e posizioni del layout del modello di tessera predefinito
  1. class.logo
  2. class.localizedIssuerName
    o class.issuerName
  3. Visualizza titolo della scheda
  4. PARTENZA o VALIDO DAL
  5. object.ticketLeg.departureDateTime (data e ora)
    o object.validTimeInterval.start.date
  6. ARRIVING AT (ARRIVO PREVISTO) o VALID UNTIL (VALIDO FINO AL)
  7. object.ticketLeg.arrivalDateTime (solo ora)
    o object.validTimeInterval.end.date
  8. PASSENGER
  9. object.passengerNames
  10. CARRIAGE o class.customCarriageLabel
  11. object.ticketLeg.carriage
  12. COACH o class.customCoachLabel
  13. object.ticketLeg.ticketSeat.coach
  14. SEAT o class.customSeatLabel
  15. object.ticketLeg.ticketSeat.seat
    o object.ticketLeg.ticketSeat.seatAssignment
  16. object.barcode.type e object.barcode.value
    o object.ticketNumber
  17. object.barcode.alternateText
  18. object.hexBackgroundColor
    o class.hexBackgroundColor
  19. Itinerario con più tappe
  20. NUMERO BIGLIETTO o class.customTicketNumberLabel
  21. object.ticketNumber
  22. STATO DEL BIGLIETTO
  23. object.ticketStatus o object.customTicketStatus
  24. PARTENZA
  25. object.ticketLeg.departureDateTime
  26. ARRIVO
  27. object.ticketLeg.arrivalDateTime
  28. NOME DELLA TARIFFA o class.customFareNameLabel
  29. object.ticketLeg.fareName
  30. PIATTAFORMA o class.customPlatformLabel
  31. object.ticketLeg.platform
  32. ZONE o class.customZoneLabel
  33. object.ticketLeg.zone
  34. CLASSE TARIFFARIA o class.customFareClassLabel
  35. object.ticketLeg.ticketSeat.fareClass
    o object.ticketLeg.ticketSeat.customFareClass
  36. CATEGORIA DI CONCESSIONE
    o class.customConcessionCategoryLabel
  37. object.concessionCategory
    o object.customConcessionCategory
  38. LIMITAZIONI DEL PERCORSO
    o class.customRouteRestrictionsLabel
  39. object.ticketRestrictions.routeRestrictions
  40. DETTAGLI LIMITAZIONI DEL PERCORSO
    o class.customRouteRestrictionsDetailsLabel
  41. object.ticketRestrictions.routeRestrictionsDetails
  42. LIMITAZIONI DI TEMPO
    o class.customTimeRestrictionsLabel
  43. object.ticketRestrictions.timeRestrictions
  44. ALTRE LIMITAZIONI
    o class.customOtherRestrictionsLabel
  45. object.ticketRestrictions.otherRestrictions
  46. NUMERO RICEVUTA
    o class.customPurchaseReceiptNumberLabel
  47. object.purchaseDetails.purchaseReceiptNumber
  48. DATA DI ACQUISTO
  49. object.purchaseDetails.purchaseDateTime
  50. ID ACCOUNT
  51. object.purchaseDetails.accountId
  52. CODICE DI CONFERMA
    o class.customConfirmationCodeLabel
  53. object.purchaseDetails.confirmationCode
  54. VALORE NOMINALE o class.customPurchaseFaceValueLabel
  55. object.purchaseDetails.ticketCost.faceValue
  56. PREZZO o class.customPurchasePriceLabel
  57. object.purchaseDetails.ticketCost.purchasePrice
  58. MESSAGGIO SCONTO
    o class.customDiscountMessageLabel
  59. object.purchaseDetails.ticketCost.discountMessage
  60. class.imageModulesData[0].mainImage
  61. object.imageModulesData[0].mainImage
  62. class.messages[].header
  63. class.messages[].body
  64. object.messages[].header
  65. object.messages[].body
  66. class.textModulesData[0..9].header
  67. class.textModulesData[0..9].body
  68. object.textModulesData[0..9].header
  69. object.textModulesData[0..9].body
  70. class.linksModuleData.uris[].description
  71. object.linksModuleData.uris[].description

Per i campi del modulo immagine, mostriamo un solo campo del modulo immagine della classe e un solo campo del modulo immagine dell'oggetto. Se hai bisogno di più di un campo del modulo immagine a uno dei due livelli, esegui l'override del modello predefinito.

Per i campi del modulo di testo, mostriamo solo un massimo di 20 campi del modulo di testo della classe e 20 campi del modulo di testo dell'oggetto. I campi vengono visualizzati nello stesso ordine in cui sono definiti nell'array. Se hai bisogno di più di 20 campi del modulo di testo a qualsiasi livello, sostituisci il modello predefinito.

Per i messaggi, mostriamo un massimo di 20 messaggi della classe e 20 messaggi dell'oggetto. Non garantiamo l'ordine dei messaggi. Se hai bisogno di più di 20 messaggi a uno dei due livelli o di una garanzia per qualsiasi ordine, sostituisci il modello predefinito.

Per il campo del modulo dei link, non esiste un limite al numero di URI che puoi definire. Gli URI vengono visualizzati raggruppati nel seguente ordine per ogni livello (classe o oggetto):

  1. Coordinate mappa
  2. Numeri di telefono
  3. Indirizzi email
  4. Pagine web

Per ogni gruppo, gli URI vengono visualizzati nello stesso ordine in cui sono definiti nell'array. Se hai bisogno di un ordine diverso, sostituisci il modello predefinito.

Elementi e posizioni del layout del modello di elenco predefinito
  1. (object.ticketLeg.originName
      e object.ticketLeg.destinationName)
    o (object.ticketLeg.originStationCode
      e object.ticketLeg.destinationStationCode)
    o object.ticketLeg.originName
  2. object.ticketLeg.departureDateTime
    o object.validTimeInterval.end.date
  3. class.logo
  4. object.hexBackgroundColor
    o class.hexBackgroundColor
  5. <# passes> (raggruppati)