Les zones d’une page où un lecteur mesure

Désigner la partie d’une page qui est un plan à l’échelle ou une carte rattachée à la Terre, pour que l’outil de mesure affiche des mètres et non des points.

Résumé

Un plan de masse au centième ne sert à rien s’il se mesure en points : le lecteur veut des mètres. Une carte veut une latitude et une longitude. Une zone de mesure dit quel rectangle de la page est le plan ou la carte, et dans quelles unités l’outil de mesure d’un logiciel de lecture y affiche ses résultats ; hors de toute zone, il mesure la page elle-même.

Techniquement

Écrit au premier niveau d’une requête, sous "page_viewports"

page_viewports écrit /VP sur les pages qu’il nomme, chaque zone étant un rectangle, un name et une measure. rectilinear est un dessin à l’échelle : ratio, l’échelle écrite en toutes lettres, et les unités dans lesquelles se lisent les longueurs, les distances et les surfaces, chaque liste d’unités de la plus grande à la plus petite, chaque unité un label et un factor. geospatial est une carte : le system de coordonnées, par son code EPSG ou en Well Known Text, et au moins trois points qui rattachent la zone à la Terre. Une page nommée deux fois reçoit les zones de la dernière entrée donnée pour elle. Une zone demande PDF 1.6, une carte PDF 2.0.

Schéma de la requête

page_viewports — tableau, facultatif, vide par défaut.
page_viewports[].page — entier, obligatoire, à partir de 1, comme tout numéro de page dans une requête.
page_viewports[].viewports — tableau, obligatoire. Chaque zone a llx, lly, urx et ury, et, facultativement, un name, une measure de type rectilinear ou geospatial, et point_data, des ensembles de points mesurés. Chaque ensemble a names, le nom de chaque colonne — LAT, LON et ALT pour une latitude, une longitude et une altitude, ou des noms choisis par le client — et points, une ligne de nombres par point. point_data exige une mesure geospatial et un document en PDF 2.0.
Unités : chaque liste d’unités — x, distance, area, et les units de y à côté de y_in_x, ce que vaut une unité de y en unités de x, avec angles et slopes — va de la plus grande à la plus petite, chaque unité étant un label et un factor, et peut indiquer fraction ({"decimals": 2}, {"fraction": 8}, "rounded" ou "truncated"), exact, thousands_separator, decimal_mark, label_spacing et label_first. origin est le point à partir duquel on mesure. Une carte indique son system, {"geographic": {"epsg": 4326}} ou {"projected": {"wkt": "…"}}, ses points, chacun {"at": [x, y], "latitude": …, "longitude": …} ou {"at": [x, y], "easting": …, "northing": …}, et peut indiquer shown_in, neatline et display_units, {"length", "area", "angle"} : metre, kilometre, foot, us_survey_foot, mile ou nautical_mile ; square_metre, hectare, square_kilometre, square_foot, acre ou square_mile ; degree ou grad.

Sont refusés : une liste sans aucune unité, un facteur qui n’est pas un nombre supérieur à zéro, une zone de largeur nulle, un point de repère hors de sa zone, et une latitude ou une longitude hors des bornes.

Une requête entière qui crée un PDF

{
  "page_viewports": [
    {
      "page": 1,
      "viewports": [
        {
          "llx": 72, "lly": 300, "urx": 523, "ury": 680,
          "name": "Ground floor plan",
          "measure": {
            "rectilinear": {
              "ratio": "1 cm = 1 m",
              "x": [{ "label": "m", "factor": 0.0352778 }],
              "distance": [{ "label": "m", "factor": 1 }],
              "area": [{ "label": "m²", "factor": 1 }]
            }
          }
        }
      ]
    }
  ],
  "standard_fonts": [{ "name": "sans", "face": "helvetica" }],
  "items": [
    {
      "type": "text",
      "rect": { "llx": 72, "lly": 700, "urx": 523, "ury": 740 },
      "content": ["A plan a reader measures in metres"],
      "font": "sans",
      "font_size": 12
    }
  ]
}

La ligne qui l’envoie, en trois langages

Le document dans son ensemble

Les numéros que montre le logiciel de lecture Cent courriers dans un seul fichier Ce que le document dit de lui-même Ce que le document dit de lui-même, dit une seule fois Un texte que personne ne peut copier Les notes qu’un programme laisse pour lui-même Les notes qu’un programme laisse sur une page Les données qu’un programme accroche à un passage d’encre Un fichier encore lisible dans des dizaines d’années La norme d’impression que le document déclare La norme d’impression variable déclarée par le document Le mot de passe qui l’ouvre, et ce qu’on peut en faire Une facture qu’un humain et une machine lisent L’adresse à partir de laquelle se lisent les liens relatifs La version de PDF que le fichier déclare Les extensions de PDF dont le fichier dit se servir Ce qu’une image dit d’elle-même, et comment elle est lue Les pièces jointes du document, à côté de ses pages Des fichiers que le document nomme sans les contenir Les pièces jointes, présentées en portefeuille Les pièces jointes que revendique une page Les pièces jointes que revendique une police La fiche d’identité propre à une police Les pièces jointes que revendique la fiche du document Une fiche de document rédigée ailleurs La fiche d’identité que contient une seule page La norme d’accessibilité que le document déclare Les normes contre lesquelles le document fini est mesuré

Où aller ensuite

Toutes les clés JSON d’une requête, en une page Les quarante et un autres réglages d’une requête

Voir les prix Voir les exemples