Naval Pilgrim's Mayflower
    Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

    gmepublic

    GME HAS BEEN DEPRECIATED BY GOOGLE, THERE IS NO REASON FO RYOU TO START USING THIS MODULE IF YOU HAVN'T BEEN PREVIOUSLY

    Google Maps Engine NPM version

    Wrapper for doing crud operations on Google Maps Engine tables.

    No affiliations with Google blah blah etc.

    All methods return promises.

    var GME = require('gme');
     
    GME.createTable(key, email, requestObj);
     
    var table = new GME(key, email, tableID, primaryKey);
     
    table.info(); //-> info about the table 
    table.features(); //-> all the features 
    table.readStream(); // -> same but read stream 
    table.features(query); //-> filtered list 
    table.readStream(query); // -> again same but with a read stream 
    table.feature(id); //-> one feature 
    table.create(array); //-> success/failure 
    table.update(array); //-> success/failure 
    table.remove(array); //-> success/failure 
     
    // Using bulk operations 
    var bulk = table.bulk();
     
    bulk.([create|update|remove]); //-> ready for more/failure 
    bulk.flush(); //-> success/failure 
     
    // Using streams to write multiple rows 
    var stream = table.writeStream();
     
    stream.write({
      type: 'create',
      value: {...}
    });
    stream.write({
      type: 'update',
      value: {...}
    });
    stream.write({
      type: 'remove',
      key: 'string'
    });

    Note: The key and the email are those of the service account for your GME account, to obtain a service account, see this document.

    Once you obtain the private key, you must convert it to a pem file, with something like openssl pkcs12 -in key.p12 -out key.pem -nodes, where key.p12 is the downloaded file from the Service Account and key.pem is the file you pass as the key argument. The key parameter may either be the buffer contents of the key file or the string path to the keyfile.

    The email and tableID arguments must be strings, primaryKey is optional and defaults to 'gx_id'.

    For create and update takes an array of features per the create and update docs.

    For remove an array of ids to delete is required.

    table.bulk

    bulk doesn't return a promise, but instead it returns a bulk object, which has the same create update and remove methods that work the same way, the only difference is that they wait util they have the maximum number of features or verticies and then does the upload in a batch.

    i.e. bulk.create(feature); the first 49 times will return a promise that resolves to true but the 50th time it is a promise for the bulk upload of all 50 features.

    bulk.flush forces an upload of all items in the current queue and cleans them out, flush doesn't close the object or anything so you can continue to use it.

    table.writeStream

    the writeStream method returns a writable stream, write objects with a type property with 'create', 'update', or 'remove' value and then a 'data' property with the object or string to put to the method (this can also be named 'key' if you want).

    GME.createTable

    Similar to the table constructor but instead of a table ID takes a table creation object.

    table.features/table.readStream

    Either returns all the rows or a filtered set based on a query, the only difference is that features returns a promise while readStream returns a stream., see this page for query options. Note that table.features does the pagination for you, you don't need to worry about it.

    install

    npm i gme

    Downloadsweekly downloads

    2

    version

    1.1.2

    license

    MIT

    repository

    github.com

    last publish

    collaborators

    • avatar